Hammerspoon

Plans and prices

Every plan, in full

On the record

Automation triggers

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

Configuration requirement

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

Integrations

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

Intended users

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

License

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

Minimum OS version

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

Permissions

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

Purpose

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

Spoons

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

Support

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

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

Window management

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

Alternatives to Hammerspoon

Every alternative, ranked