// troubleshooting guide · hammerspoon
Hammerspoon Keystrokes Not Working
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · hammerspoon/keystrokes-not-working2 FIXES
// quick answer
hs.eventtap keystrokes failing in other apps is usually a permission problem. Reset Hammerspoon's TCC entry and grant it again.
Most likely fix: Reset and re-grant permissions
How to fix it
// try these in order, the most common fix is first
FIX 1Reset and re-grant permissions
- 01Run tccutil reset All org.hammerspoon.Hammerspoon
- 02Relaunch Hammerspoon
- 03Enable it in Privacy & Security > Accessibility
Did this fix it?FIX 2Check the Console for errors
- 01Click the Hammerspoon menu bar icon > Console
- 02Reload config and look for Lua errors
Did this fix it?
Symptoms
hs.eventtap.keyStroke does nothing in other apps although other Hammerspoon functions work.
Why it happens
- C-01Permission reset needed after an OS upgrade
- C-02New Mac or migrated permissions
- C-03Accessibility not granted
// this guide also covers
- hammerspoon keystroke not working
- hammerspoon eventtap not working
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 Hotkeys Stop Working
- Hammerspoon Timer or Watcher Stops Working
- Hammerspoon Modal Hotkeys Not 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