Hammerspoon

Spec sheet

Purpose

Hammerspoon is a desktop automation tool for macOS that bridges system APIs to a Lua scripting engine.Read 9 Oct 2026 · hammerspoon.org

Intended users

The Getting Started guide presents Hammerspoon as a tool for people who want to automate macOS by writing Lua scripts.Read 9 Oct 2026 · hammerspoon.org

Integrations

Documented APIs include AppleScript execution and controls for Deezer and iTunes music players.Read 9 Oct 2026 · hammerspoon.org

Support

The project lists a Discord server and mailing list, and its site also directs users to GitHub issues for bugs and suggestions.Read 9 Oct 2026 · hammerspoon.org

License

The project’s GitHub repository identifies its license as MIT.Read 9 Oct 2026 · github.com

Automation triggers

Scripts can react to application, Wi-Fi, and USB events, among other system events.Read 9 Oct 2026 · hammerspoon.org

Configuration requirement

Hammerspoon does nothing out of the box; users need to create a Lua script at ~/.hammerspoon/init.lua.Read 9 Oct 2026 · hammerspoon.org

Minimum OS version

The latest release page lists macOS 13.0 as its minimum macOS version.Read 9 Oct 2026 · github.com

Permissions

The Getting Started guide says to enable Accessibility access for Hammerspoon during setup.Read 9 Oct 2026 · hammerspoon.org

Spoons

Spoons are pre-made Lua plugins that users can install and load through their configuration.Read 9 Oct 2026 · hammerspoon.org

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.Read 9 Oct 2026 · hammerspoon.org

Window management

Its APIs support moving and resizing windows, arranging multi-window layouts, and filtering windows by rules and events.Read 9 Oct 2026 · hammerspoon.org

Plans and prices

Every Hammerspoon plan and price →

Where Specifiction places it

• App Switcher#1 of 117.3
• Task Automation Software#27 of 357.5