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

reliability3 issues

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.

Frequency: 8%Sentiment: -0.70/1004 sources
Impact
8

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.

Frequency: 8%Sentiment: -0.60/1003 sources
Impact
7

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.

Frequency: 4%Sentiment: -0.40/1001 sources
Impact
5
usability2 issues

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.

Frequency: 8%Sentiment: -0.50/1003 sources
Impact
7

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.

Frequency: 4%Sentiment: -0.30/1001 sources
Impact
4
support2 issues

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.

Frequency: 8%Sentiment: -0.50/1003 sources
Impact
7

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.

Frequency: 6%Sentiment: -0.40/1003 sources
Impact
5
integrations2 issues

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.

Frequency: 5%Sentiment: -0.40/1002 sources
Impact
5

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.

Frequency: 4%Sentiment: -0.30/1001 sources
Impact
4
security1 issue

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.

Frequency: 7%Sentiment: -0.50/1002 sources
Impact
7
customization1 issue

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.

Frequency: 6%Sentiment: -0.40/1002 sources
Impact
6
onboarding1 issue

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.

Frequency: 7%Sentiment: -0.40/1002 sources
Impact
6

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.

Frequency: 7%First hour

Automations silently stop

A timer or hotkey stops after some time because of garbage collection.

Frequency: 7%After days of uptime

Update breaks hotkeys

A macOS update resets permissions and bindings stop working.

Frequency: 6%After a macOS update

Config grows unmaintainable

A copied dotfile grows into hundreds of lines nobody understands.

Frequency: 5%After months

Worry about the v2 rewrite

Heavy users realize v2 changes the language to JavaScript.

Frequency: 4%When reading release notes

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.