TL;DR
Hammerspoon vs Keyboard Maestro: For most Mac users in 2026, Hammerspoon is the better choice for Mac automation because it is free while Keyboard Maestro charges for full use. Both install with a single Homebrew command, so the switching cost is low. Choose Keyboard Maestro instead if automation support is your priority.
Which is better: Hammerspoon or Keyboard Maestro?
Hammerspoon is the top pick for most Mac users looking at Mac automation — it is free and installs in one Homebrew command. Keyboard Maestro is the stronger choice if you prefer its Mac automation ecosystem. Both are worth trying.
Hammerspoon vs Keyboard Maestro
Which is the better Mac automation for Mac in 2026?
We compared Hammerspoon and Keyboard Maestro across 6 key factors including price, open-source status, and community adoption. Read our full breakdown below.
Hammerspoon
Powerful macOS automation tool using Lua scripting
Keyboard Maestro
Automation software
Our Verdict
For most Mac users in 2026, Hammerspoon is the better choice for Mac automation because it is free while Keyboard Maestro charges for full use. Both install with a single Homebrew command, so the switching cost is low. Choose Keyboard Maestro instead if automation support is your priority.
Feature Comparison
| Feature | Hammerspoon | Keyboard Maestro |
|---|---|---|
| Price | Free | Paid |
| Open Source | No | No |
| Replaces | Keyboard Maestro ($36) | — |
| Best for | automation, lua, scripting | automation, macros, keyboard |
| Install | brew install --cask hammerspoon | brew install --cask keyboard-maestro |
| Category | System Utilities | System Utilities |
Quick Install
brew install --cask hammerspoonbrew install --cask keyboard-maestroLearn More
In-Depth Overview
What is Hammerspoon?
Hammerspoon is an open-source macOS automation tool written in Objective-C and Lua that exposes system APIs through a Lua scripting bridge. The current release is 1.0.0, published 14 April 2026 on GitHub, with a 1.0.0-preview alongside it and an active commit history into summer 2026; Homebrew still distributes it as brew install --cask hammerspoon. Hammerspoon runs as a menu-bar daemon requiring Accessibility permission and optionally other entitlements per module. Its API surface, hs.window, hs.hotkey, hs.alert, hs.menubar, hs.chooser, hs.http, hs.wifi, hs.battery, hs.usb, hs.screen and community Spoons, lets users script window tiling, global hotkeys, menubar widgets, modal key layers, and reactive daemons purely in Lua. Configuration lives in ~/.hammerspoon/init.lua and reloads live. Philosophically Hammerspoon treats macOS as a programmable runtime: if an API exists in hs.*, you can bind it to any trigger you invent. There is no paid tier, no subscription, and no telemetry upsell; the project is community-maintained and notarized for current macOS, including Tahoe 26.x on Apple Silicon and Intel.
What is Keyboard Maestro?
Keyboard Maestro is a commercial macOS automation utility from Stairways Software (Stairways Software Pty Ltd) that has shipped since 2002 and remains actively maintained in 2026. The current stable line is version 11, with minor patches such as 11.0.3 in 2024 and Feature support continuing into 2026; the published price remains US$36.00 for a new single-user license (upgrade US$25 from v10) with free minor updates and a standalone, notarized universal binary. Keyboard Maestro provides a visual macro editor, an engine that runs macros in the background, and a palette/clipboard history system. Users build macros from triggers (hotkey, hot string, application, window, folder, time, USB, MIDI, and more) and actions (window control, text manipulation, OCR, image manipulation, file operations, shell/AppleScript/JavaScript, clipboard filters, and 300+ others). It includes a macro recorder, variable and dictionary system, conflict palettes, and engine syncing. It requires Accessibility permission and is fully compatible with Apple Silicon and macOS Tahoe 26.x. Unlike Hammerspoon, no code is required to achieve sophisticated automations, though power users can embed shell, AppleScript, JavaScript for Automation, or Swift snippets inside actions.
Detailed Feature Comparison
Automation Model
CriticalCode-driven Lua engine. Every automation is a function you write against hs.* APIs, unlimited composability, version-controlled config, modal layers, and reactive event watches (Wi-Fi, USB, battery, screen, app). Steeper learning curve but no ceiling. Verified August 2026: ships universal and works on Tahoe 26.x after re-granting Accessibility.
Visual canvas with 300+ drag-and-drop actions and a macro recorder. Triggers cover hotkeys, typed strings, palettes, cron, folder/app/window, MIDI, and USB. No code needed for most workflows; embed code only when you want to. Verified August 2026: v11 universal binary remains current on Tahoe 26.x.
Verdict: Code ceiling vs canvas floor still decides the winner. Hammerspoon rewards programmers, Keyboard Maestro rewards visual builders.
Window & Workspace Control
Highhs.window, hs.grid, hs.spaces and hs.screen give pixel-precise tiling, throw-to-display/space, and display-change reactors. Many users recreate tiling WMs (yabai-parity) entirely in Lua with animation control.
Window actions (Move/Resize, Manipulate Windows, Bring to Front) handle halves/thirds and app-specific geometry, plus Spaces awareness. Reliable for snap/placement palettes but less algorithmic than Hammerspoon's continuous layout reactors.
Verdict: Hammerspoon wins for developers wanting bespoke tiling reactors; Keyboard Maestro is fine for deterministic snap palettes.
Triggers & Event Reactivity
HighWatchers for Wi-Fi, USB, battery, Caffeinate, path, URL, pasteboard, and screen. hs.caffeinate.watcher, hs.wifi.watcher, hs.usb.watcher let the daemon react to hardware/network without polling.
Extensive built-in triggers including wireless network, USB device, MIDI, mounted volume, login, sleep, idle, and periodic (cron-like). Folder and application triggers are particularly ergonomic for non-programmers.
Verdict: Both are event-rich; Hammerspoon exposes more system signals via Lua, Keyboard Maestro exposes them as GUI triggers.
Learning Curve & Onboarding
HighFirst week is debugging Lua in the console, reading hs.* docs, and handling nil-window edge cases. Community Spoons help, but there is no recorder. Reward arrives after that investment.
Install, grant Accessibility, record a macro or drag actions into a visual list. Seeing triggers and actions in plain English flattens the curve; the forum, wiki, and built-in help examples resolve most questions in minutes.
Verdict: Keyboard Maestro wins onboarding decisively; Hammerspoon's curve pays off later for coders.
Text, Clipboard & Data Handling
Highhs.pasteboard + hs.eventtap + string ops cover clipboard manipulation, but you build the UX yourself (choosers, alerts). No built-in clipboard history or OCR, add via Spoons or hand code.
First-class clipboard histories (named clipboards, persistent stacks), clipboard filters, text-token expansion, OCR actions, dictionary/variable pipeline, and regex tools. A standout reason non-programmers choose it.
Verdict: Keyboard Maestro's clipboard/text pipeline is best-in-class among Mac automators.
Extensibility & Ecosystem
HighMIT-licensed, community Spoons on GitHub, full Lua standard library, and the ability to require any Lua rock or call out to shell/Python/Node. If an API is missing you can write it.
Embed Execute Shell/AppleScript/JavaScript (including modern JavaScript for Automation), call Hammerspoon or Shortcuts from a macro, and share macros on the forum. Visual canvas sets the boundary, you cannot rewrite the engine itself.
Verdict: Hammerspoon is the more open, hackable runtime; Keyboard Maestro is the richer out-of-the-box library.
Reliability & Debugging
MediumConsole reloads live but a nil window or race on rapid display wakes can throw Lua errors. Stability depends on the quality of your init.lua. Crash logs are Lua stacktraces, not GUI hints.
Visual debugger, macro groups with enable/disable, conflict resolution, and detailed Engine log. Failures surface as named actions with progress indication, making root cause faster to spot.
Verdict: Keyboard Maestro's visual debugger and logs shorten mean-time-to-fix for most users.
Pricing & Licensing (2026)
HighFree and MIT open source. Download via GitHub releases or Homebrew. No trial, no activation, community support via GitHub issues and Discourse.
US$36.00 new license, US$25 upgrade from v10, volume discounts available. One-time purchase, not a subscription; free minor updates through the 11.x line. 30-day-style trial available via Stairways.
Verdict: Hammerspoon wins on price alone; Keyboard Maestro's one-time US$36 remains among the best values in paid Mac utilities.
Maintenance & Platform Fit (Tahoe / Apple Silicon)
Medium1.0.0 cut April 2026 is the current release line; GitHub shows active PRs and 2026 commits. Universal binary, notarized. Accessibility re-grant required after major OS upgrades.
Commercial maintenance rhythm with documented 11.x patches into 2026. Universal notarized build tracks current macOS; larger installed base gives faster Tahoe compatibility confidence.
Verdict: Both healthy August 2026; Keyboard Maestro's commercial rhythm edges platform-fit confidence for risk-averse shops.
Who Should Choose Which?
1Software Developer
Version-controlled Lua, reactive watchers, and unlimited hs.* composability beat any visual box.
2Designer / Writer
Palettes, recorder, and clipboard history compress daily repetition without code.
3IT / Ops Generalist
Fastest path to reliable USB, folder, and schedule triggers across managed Macs.
4Window-Management Obsessive
Rebuild a bespoke tiling WM in Lua; Keyboard Maestro can only snap, not continuously tile.
5Team Lead standardizing fleets
Readable macros and commercial support reduce onboarding cost across mixed skill levels.
Migration Guide
Hammerspoon → Keyboard_maestro
Export behaviors, not code. Map each hs.hotkey + function pair onto a Keyboard Maestro macro with the same hotkey trigger, replacing Lua logic with typed-string, window, or clipboard actions. Rebuild wifi/usb watchers as Keyboard Maestro wireless/USB triggers. Expect to lose the reactive-daemon elegance, replace it with explicit macro groups per context.
Keyboard_maestro → Hammerspoon
Translate each macro group into an hs.* watcher or hotkey in init.lua. Recreate palettes with hs.chooser or hs.hotkey.modal, rebuild clipboard history with hs.pasteboard + hs.timer. Budget a weekend to port your most-used ten macros and keep Keyboard Maestro installed until the Lua equivalents are stable.
Final Verdict
Tie - hammerspoon for coders, keyboard-maestro for everyone else
Winner
Runner-up
Re-checked August 2026: Hammerspoon 1.0.0 and Keyboard Maestro 11.x still mark the two sane defaults outside Apple Shortcuts and BetterTouchTool. Hammerspoon is the right install when you want a free, open daemon you can extend without a canvas ceiling. Keyboard Maestro is the right purchase when you need recorded macros, conflict palettes, clipboard stacks, and a visual debugger teammates can read. Calling a single global winner would paper over that split. If Lua is fun for you, start with Hammerspoon. If you need throughput this hour, buy Keyboard Maestro. Long-term Mac power users often end up with both tools split by job: tiling and system watchers in Hammerspoon, text and clipboard workflows in Keyboard Maestro.
Bottom Line: Coders: Hammerspoon. Visual builders and teams: Keyboard Maestro. Many long-term Mac power users end up keeping both, split by job.
Frequently Asked Questions
About the Author
Explore More on Bundl
Browse Mac automation apps, read our complete guide, or discover curated bundles.
Expert Insights
Teams with mixed code comfort standardize on Keyboard Maestro and let coders layer Hammerspoon reactors for tiling not expressible visually.
Hammerspoon watchers (wifi/usb/caff) are uniquely suited to context-aware automation; reimplementing them with polling in Keyboard Maestro is less efficient.
Sources & References
Key Verified Facts
- Hammerspoon current release is 1.0.0 (14 April 2026) and is MIT/free via GitHub/Homebrew.[cite-hammerspoon-releases, cite-hammerspoon-official]
- Keyboard Maestro current line is v11 with pricing US$36 new / US$25 upgrade (one-time, not subscription) in August 2026.[cite-keyboard-maestro-official, cite-keyboard-maestro-wiki-new]
- Both tools require macOS Accessibility permission and run natively on Apple Silicon, compatible with Tahoe 26.x.[cite-hammerspoon-official, cite-keyboard-maestro-official]
- 1Hammerspoon official site
Accessed Aug 9, 2026
- 2Hammerspoon GitHub releases (1.0.0 April 2026)
Accessed Aug 9, 2026
- 3Homebrew cask: hammerspoon
Accessed Aug 9, 2026
- 4Keyboard Maestro official site (pricing & v11)
Accessed Aug 9, 2026
- 5Keyboard Maestro wiki. What's New (v11)
Accessed Aug 9, 2026
- 6Keyboard Maestro. Wikipedia
Accessed Aug 9, 2026
- 7Homebrew cask: keyboard-maestro (alternative distribution metadata)
Accessed Aug 9, 2026
Related Technologies & Concepts
Related Topics
macOS Automation
Compares programmable (Hammerspoon/Lua) vs visual (Keyboard Maestro) automation for macOS power users in 2026.
Window Management on macOS
Why Hammerspoon's hs.window tiling reactors compete with dedicated tiling WMs while Keyboard Maestro stays a snap/palette tool.