Hammerspoon

Hammerspoon contributors · Free, MIT-licensed macOS automation through Lua scripts, hotkeys, window control, system events and optional reusable Spoons.

CaskUtilitiesAuto-updatesApple silicon · Intel

Homepage

From homebrew/cask

30-day installs3,597#55 in App

1-year installs51.9KLast 365 days

Latest version1.1.122 hours ago · Oct 7

Download size9.7MBarm64 / x86_64 · zip

Release cadenceIrregular1 release in 30 days

1.1.1
LatestPatchOct 7 · Wed
OpenNavo editorialAdded to Homebrew Feb 26 13:10
Corrects the release archive so unexpected resource forks no longer interfere with macOS Gatekeeper; requires macOS13+.
Packaging
Removes unintended resource forks from the downloadable archive.Prevents archive metadata from confusing macOS Gatekeeper.Official release lists macOS13.0 as the minimum.
1.1.0
Jan 1, 1 · Mon
OpenNavo editorialAdded to Homebrew Dec 24, 2025 13:16
Improves task, URL, window, HTTP/WebSocket and IPC behavior; adds input/audio APIs and fixes Stream Deck and build integration.
Fixes
Validates hs.task arguments as strings and fixes tilde-based Lua paths.Repairs WebSocket support in hs.httpserver:start().Prevents IPC print replacement reentrancy and window Lua-stack corruption.Reuses status-item menus and handles invalid window-filter process IDs.URL event callback parameters become lowercase.
APIs
Adds smart-magnify event creation and web-browsing activity handling.Adds audio-device thru getters/setters and LuaSkin additions.Improves window moves/resizing through AXEnhancedUserInterface.Fixes mouse-speed setters and adds trackpad support.
Other
Window filters track applications by process ID.Fixes Stream Deck Mini first-button callbacks.Includes Xcode16/build and logger-documentation corrections.
1.0.0
Jan 1, 1 · Mon
OpenNavo editorialAdded to Homebrew Aug 6, 2024 02:53
Updates Lua to5.4.7, adds watcher and media/input integrations, and fixes battery, networking, window Spaces and Console behavior.
Fixes
Handles systems reporting an empty battery power-source array.Ensures network-ping completion callbacks run and allows nil clipboard names.Fixes window moves to Spaces on Sonoma14.5.Reduces Console resource usage and fixes empty-space/nil-child errors.Includes missing styling for built-in web help.
APIs
Adds alwaysNotify for watchable watchers and window arguments for alerts.Adds Spotify track-artwork URLs and Stream Deck XL device support.URL-event callbacks receive the fullURL value.Updates Lua to5.4.7 and improves preference-reset dialogs.
Maintenance
Reworks hs.hash to make adding algorithms easier.Corrects blockAlert documentation and CI permission handling.