Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Hammerspoon

hammerspoon.org

  • Free plan
  • macOS
7.0 Club score Visit hammerspoon.org

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

Free

Free

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.