Hammerspoon Not Working? Common Errors & Fixes
The 9 Hammerspoon problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
Hammerspoon Accessibility Permission Not Working
Workaround availablemacOSHammerspoon needs Accessibility enabled to control windows and keys. Toggle it in Privacy & Security, and reset with tccutil if it will not stick.
Hammerspoon Keystrokes Not Working
Workaround availablemacOShs.eventtap keystrokes failing in other apps is usually a permission problem. Reset Hammerspoon's TCC entry and grant it again.
Hammerspoon Hotkeys Stop Working
Workaround availablemacOSHotkeys that stop after a while are most often garbage collected objects or lost permission. Store hotkey objects in persistent variables and reload.
Hammerspoon Timer or Watcher Stops Working
Fixed in latest versionmacOSA timer or watcher stops when Lua garbage-collects it. Save it in a variable that lives for the whole session.
Hammerspoon Modal Hotkeys Not Working
OngoingmacOS 15Modal bindings for single-character keys can fail after a macOS update. Closing stray dialogs, restarting and checking permissions are the reported steps.
Hammerspoon UI Not Showing in Full-Screen Apps
Fixed in latest versionmacOSHammerspoon alerts and canvases do not appear over full-screen apps when the Dock icon is on. Turn the Dock icon off.
Hammerspoon Cannot Find Application By Name
Fixed in latest versionmacOSSome apps report a different name than the menu bar, for example Microsoft Word instead of Word. List running names to find the right one.
Hammerspoon selectMenuItem Not Working From Console
Workaround availablemacOSSome apps disable menus when focus leaves their window, so menu actions fail from the Console. Run them from a hotkey instead.
Hammerspoon v2: What Changes and Should You Wait
OngoingmacOSHammerspoon v2 is a Swift rewrite using JavaScript instead of Lua and was described as far from complete. Stay on v1 Lua for now.
Problem not listed? See all Hammerspoon complaints or compare Hammerspoon alternatives.
// The alternative nobody mentions
Need something Hammerspoon can't do? We'll build it.
We're a small team of developers who build custom software fast. Your own Hammerspoon alternative with only the features you use, or anything else: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code