Hammerspoon review
A powerful open-source choice for macOS users comfortable writing Lua automation.
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
Hammerspoon is an open-source desktop automation tool for macOS. It connects operating-system APIs with Lua, letting technically oriented users write configuration scripts for local automation. Its scope covers application and window control, global keyboard shortcuts, keyboard, mouse, and trackpad events, timers, background processes, webviews, filesystem watching, notifications, and other system functions. It is aimed at solo and small-team users who want programmable control over a Mac rather than a graphical workflow builder.
The main strength is breadth within the macOS desktop. Hammerspoon can observe and inject input events, run delayed, repeating, and scheduled timers, execute background processes with output capture, watch filesystem paths recursively, and embed webviews with JavaScript execution. Its Lua scripting bridge also provides access to macOS system APIs, while Spoons offer reusable plugin components. These capabilities make it suitable for automations that need application, window, input, process, file, or timing control in one configurable environment. Users who prefer scripts and composable system functions should find its focus a strong fit.
Hammerspoon’s trade-off is the work required to create and maintain automations. User-authored Lua configuration is central to the product, so it is better suited to people comfortable with scripting than to users seeking visual setup. The product is also limited to macOS desktop deployment, which rules it out for cross-platform automation needs. Community support and documentation are the stated support channels, and extensive API documentation helps users work through its broad feature set. Choose Hammerspoon for programmable Mac automation and reusable Spoons; choose an alternative if you need a graphical builder, non-macOS support, or a broader deployment model.
Hammerspoon pros and cons
- Where it wins
- Lua bridge to macOS system APIs
- Controls apps, windows, input events, files, and timers
- Reusable Spoons plugins and extensive API documentation
- Where it doesn't
- macOS-only desktop deployment
- Requires user-authored Lua configuration
- Not a graphical workflow builder
Hammerspoon fact sheet, pricing and score →
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update