Hammerspoon

Overview

Hammerspoon is a desktop automation tool for macOS that uses Lua scripting to control applications, windows, and system events. It enables users to create custom keyboard shortcuts, manage windows, launch apps, and automate workflows through an extensible API. Targeted at power users and developers seeking fine-grained macOS customization beyond built-in tools.³⁴⁶

Key Features

• Window Management - Resize, move, and arrange application windows programmatically using Lua scripts.⁴
• Application Control - Launch, focus, and interact with running applications by name or path.³
• Keyboard Shortcuts - Bind custom hotkeys to scripts for app launching and system actions.²⁴
• Lua Scripting - Extend functionality with Lua code accessing macOS APIs for automation.⁵⁶
• URL Handling - Route URLs to specific browsers or profiles via dispatchers.¹²
• API Documentation - In-app console with full API help via docs.json for scripting reference.⁵⁶
• Spoons System - Modular extensions (spoons) for tasks like sending to OmniFocus or browser management.²

Pricing

Platforms & Requirements

Runs exclusively on macOS, distributed as a standalone app bundle. Compatible with recent macOS versions; requires Lua interpreter embedded in the app. No support for other platforms like Windows or Linux.

Integrations & Ecosystem

• Lua scripting language
• macOS Accessibility APIs
• Google Chrome profiles
• OmniFocus (via spoons)
• Epichrome site-specific browsers
• Clipboard operations
• Screenshot utilities

Alternatives

Reputation

Hammerspoon is praised by power users for its powerful Lua-based automation and deep macOS integration, enabling complex customizations like hyper-key shortcuts and window snapping.⁴ Users appreciate its active community and spoons ecosystem for extensibility.² Criticisms include a steep learning curve due to scripting requirements and lack of beginner-friendly GUI.⁷