// troubleshooting guide · hammerspoon
Hammerspoon Modal Hotkeys Not Working
- Status
- Ongoing
- platforms:
- macOS 15
- updated:
- November 16, 2026
- Method
- how we research
RUNBOOK · hammerspoon/modal-hotkeys-not-working2 FIXES
// quick answer
Modal bindings for single-character keys can fail after a macOS update. Closing stray dialogs, restarting and checking permissions are the reported steps.
Most likely fix: Close stray dialogs and restart
How to fix it
// try these in order, the most common fix is first
FIX 1Close stray dialogs and restart
- 01Dismiss any unrelated system dialog
- 02Restart Hammerspoon or the Mac
Did this fix it?FIX 2Re-check permissions
- 01Toggle Accessibility off and on
- 02Reload config
Did this fix it?
Symptoms
hs.hotkey.modal ignores keys like J or R while Escape and arrows still work.
Why it happens
- C-01macOS 15.3.1 behavior reported
- C-02A system dialog capturing events
- C-03Permission state
// this guide also covers
- hammerspoon modal not working
- hs.hotkey.modal broken
Still not working?
If Hammerspoon keeps failing, you're not alone. See every Hammerspoon problem users report or the alternatives people switch to.
Done fighting Hammerspoon? Our small team builds your own Hammerspoon alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usOther Hammerspoon errors
- Hammerspoon Accessibility Permission Not Working
- Hammerspoon Keystrokes Not Working
- Hammerspoon Hotkeys Stop Working
- Hammerspoon Timer or Watcher Stops Working
- Hammerspoon UI Not Showing in Full-Screen Apps
- Hammerspoon Cannot Find Application By Name
- Hammerspoon selectMenuItem Not Working From Console
- Hammerspoon v2: What Changes and Should You Wait