A powerful macOS desktop automation tool that bridges system APIs with a Lua scripting engine.
Hammerspoon is a macOS desktop automation tool that acts as a bridge between the operating system and a Lua scripting engine. It allows users to write custom Lua scripts to control and automate various aspects of their macOS environment, from window management to system events. The tool provides powerful extensions that expose system functionality, enabling deep customization and workflow optimization.
macOS power users, developers, and automation enthusiasts who want to customize and automate their desktop environment beyond what built-in tools offer. It's ideal for those comfortable with scripting and looking for fine-grained control over their system.
Developers choose Hammerspoon for its flexibility and deep system integration, allowing them to automate complex workflows with Lua scripts. Unlike many commercial alternatives, it's open-source, highly extensible, and provides a bridge to low-level macOS APIs, making it a powerful tool for custom automation solutions.
Staggeringly powerful macOS desktop automation with Lua
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Exposes low-level system APIs through extensions, allowing fine-grained control over windows, events, and applications, as highlighted in the system API extensions feature.
Uses Lua, a lightweight and powerful language, enabling custom automations tailored to specific workflows, with extensive sample configurations available.
Includes a getting started guide, API docs, and FAQ, providing clear resources for building and troubleshooting automations.
Backed by Discord, IRC, and a Google Group, offering real-time help and shared configurations from other users.
Requires writing Lua scripts from scratch with no drag-and-drop interface, making it inaccessible for non-programmers or those seeking quick setups.
Out of the box, it does nothing—users must create and populate ~/.hammerspoon/init.lua, which can be time-consuming and error-prone.
Tied exclusively to macOS, so it's unsuitable for environments or workflows that involve multiple operating systems.
Hammerspoon is an open-source alternative to the following products: