Hammerspoon
hammerspoon.org
- Free plan
- macOS
What Hammerspoon is
Hammerspoon is a free, open-source desktop automation tool for macOS that connects system APIs to a Lua scripting engine. Scripts can control applications, windows, mouse pointers, files, audio devices, batteries, screens, keyboard and mouse events, clipboards, location services, and Wi-Fi. Window APIs move and resize windows, arrange multi-window layouts, and filter windows using rules and events. Scripts can react to application, Wi-Fi, USB, and other system events. Users can install Spoons, which are pre-made Lua plugins loaded through configuration. Documented integrations include AppleScript execution and controls for Deezer and iTunes music players. Hammerspoon supports browser automation and scheduled runs. It does nothing immediately after installation: users must create ~/.hammerspoon/init.lua and enable Accessibility access. The latest release page lists macOS 13.0 as the minimum version. Support includes Discord, a mailing list, and GitHub issues.
Who it suits
Hammerspoon suits macOS users who want to automate their desktop by writing Lua scripts. It is aimed at people comfortable creating and maintaining configuration files.
Good to know, and what to watch
- Free and open source under MIT
- Controls windows and many system services
- Scripts respond to application and device events
- Pre-made Spoons extend configurations
- Browser automation and scheduled runs listed
- macOS only
- Requires Lua scripting to automate
- Does nothing without init.lua configuration
- Accessibility permission is required
Plans
Every plan and priceFree
Open source
The verdict
Hammerspoon offers script-driven control over many macOS functions and events. Setup requires Lua configuration and Accessibility permission, so it is not an out-of-the-box automation app.
What the maker publishes
- Automation triggers
- Scripts can react to application, Wi-Fi, and USB events, among other system events. source
- Configuration requirement
- Hammerspoon does nothing out of the box; users need to create a Lua script at ~/.hammerspoon/init.lua. source
- Integrations
- Documented APIs include AppleScript execution and controls for Deezer and iTunes music players. source
- Intended users
- The Getting Started guide presents Hammerspoon as a tool for people who want to automate macOS by writing Lua scripts. source
- License
- The project’s GitHub repository identifies its license as MIT. source
- Minimum OS version
- The latest release page lists macOS 13.0 as its minimum macOS version. source
- Permissions
- The Getting Started guide says to enable Accessibility access for Hammerspoon during setup. source
- Purpose
- Hammerspoon is a desktop automation tool for macOS that bridges system APIs to a Lua scripting engine. source
- Spoons
- Spoons are pre-made Lua plugins that users can install and load through their configuration. source
- Support
- The project lists a Discord server and mailing list, and its site also directs users to GitHub issues for bugs and suggestions. source
- System controls
- Lua scripts can interact with macOS applications, windows, mouse pointers, files, audio devices, batteries, screens, keyboard and mouse events, clipboards, location services, and Wi-Fi. source
- Window management
- Its APIs support moving and resizing windows, arranging multi-window layouts, and filtering windows by rules and events. source
Checked against the maker's pages on 9 Oct 2026.