Hammerspoon Problems & Issues
Real user-reported problems, complaints, and limitations for Hammerspoon. Based on analysis of 12 signals.
Overall score: 62/100
Issues by Category
Hammerspoon keystrokes or hotkeys not working after macOS update
Reports show hotkeys, modal bindings and keystroke actions failing after macOS upgrades (Catalina, 15.3.1) or on new Apple Silicon Macs, usually tied to Accessibility permission state.
Hammerspoon timers and watchers stop working randomly
A timer, watcher or hotkey object that is not stored in a long-lived variable gets garbage collected, so automations silently stop after a while. The wiki documents this as the most common scripting mistake.
Hammerspoon window handling glitches with some apps
Some apps such as Firefox occasionally end up in a broken window state when scripted through the accessibility API.
Hammerspoon has a steep learning curve (you write Lua)
There is no settings UI for automations. Everything is a Lua script in init.lua, so non-programmers struggle and even developers need to learn the Hammerspoon API from docs.
Hammerspoon dock icon breaks full-screen UI
With the Dock icon enabled, Hammerspoon UI elements may not appear over full-screen apps. The FAQ says to disable the dock icon.
Is Hammerspoon still maintained?
The 1.1.0 announcement said development had a fairly inactive year and that three people carry most maintenance. The maintainer is working on a Swift and JavaScript v2 and has floated deprecating v1.
Hammerspoon support is a mailing list and GitHub issues
There is no vendor support. Help comes from the Google Group, GitHub issues and a small subreddit, with slow replies on edge cases.
Hammerspoon conflicts with other key remappers
Users report it can fight with AeroSpace over keypresses, and remappers like Karabiner can intercept keys before Hammerspoon sees them.
Hammerspoon cannot find apps by their menu-bar name
Some apps, notably Microsoft Office, report different names to macOS (Microsoft Word, not Word), so app lookups silently fail.
Hammerspoon needs Accessibility permission and is hard to re-grant
The app only works with Accessibility enabled; when the permissions database goes out of sync the toggle cannot be enabled and users must reset with tccutil.
Hammerspoon v2 will replace Lua with JavaScript
The maintainer says he is mostly working on v2, which swaps Lua for JavaScript. Users with big Lua configs worry about a rewrite; v2 is described as far from complete.
Hammerspoon has no starter config or GUI
A fresh install does nothing until you write init.lua. Most people copy configs from GitHub dotfiles and community Spoons, which varies in quality.
Regret Patterns
Common reasons users regret choosing Hammerspoon.
Writing Lua when you wanted a shortcut
Users install it expecting quick automation and find a blank config and a manual.
Automations silently stop
A timer or hotkey stops after some time because of garbage collection.
Update breaks hotkeys
A macOS update resets permissions and bindings stop working.
Config grows unmaintainable
A copied dotfile grows into hundreds of lines nobody understands.
Worry about the v2 rewrite
Heavy users realize v2 changes the language to JavaScript.
When Hammerspoon Breaks Down
Specific scenarios where Hammerspoon fails or underperforms.
Hotkeys stop after macOS update
Accessibility permission or key handling changes after an update.
Long-running timers
Unreferenced timers get garbage collected.
Full-screen apps with Dock icon on
Hammerspoon UI does not appear over full-screen apps.
Conflicting remappers
Karabiner, AeroSpace or other tools intercept keys.
Scripting Microsoft Office apps
App names differ from the menu-bar names.
Menu actions from the Console
Apps disable menus when focus moves to the Console.