Hammerspoon
Script and automate almost anything on your Mac
What it does
Hammerspoon lets you control macOS with small scripts — moving windows with keyboard shortcuts, reacting when you connect to a Wi-Fi network, and much more. It requires writing simple code.
Who it's for
Mac power users who are comfortable with a little scripting.
Key features
- Custom keyboard shortcuts
- Window management
- React to system events
Compatibility
NOVI never presents a guess as verified.- WindowsUnknown
No official build, package or documentation for this system was found.
- macOS (Apple Silicon)Evidence-supported
Available as an official Homebrew Cask package (“hammerspoon”).
- macOS (Intel)Evidence-supported
Available as an official Homebrew Cask package (“hammerspoon”).
- LinuxUnknown
No official build, package or documentation for this system was found.
What do these labels mean?
- Confirmed
- NOVI users have completed verified installations on this system.
- Evidence-supported
- The project publishes an official build or package for this system.
- Inferred
- Likely to work based on how the project is built, but not confirmed.
- Unknown
- We have not found enough evidence either way.
- Unsupported
- The project does not support this system.
How to get it
Direct downloadDownload the official installer from the project or its publisher, then open it. Difficulty: Advanced.
macOS (Apple Silicon)Direct downloadGuided
Download from the publisher
The publisher's download address, as recorded in Homebrew's official catalogue. NOVI links to it; the file comes straight from github.com, not from NOVI. Where this link comes from
- 1
After it downloads. Open the downloaded file from your Downloads folder. For a .dmg, drag the app into Applications; for a .zip, double-click to unpack it, then move the app into Applications. The first time you open it, macOS may ask you to confirm.
Install with Homebrew Cask
Installs macOS applications using Homebrew, a widely used package manager for macOS. You run these steps yourself; NOVI does not install anything from this website.
- 1
Make sure Homebrew is installed. Homebrew is a free, widely used tool for installing software on a Mac. Open the Terminal app and type “brew --version”. If you see a version number you already have it; otherwise follow the one-line instructions on brew.sh. Open
- 2
Copy this command into Terminal and press Return. It installs the package from Homebrew's official catalogue only. Homebrew checks the download against a known checksum.
brew install --cask homebrew/cask/hammerspoon - 3
Check it worked. The app appears in your Applications folder. You can also run this command to see the installed version:
brew list --cask --versions hammerspoon - 4
See the official package listing. Shows exactly what Homebrew installs and where it comes from. Open
macOS (Intel)Direct downloadGuided
Download from the publisher
The publisher's download address, as recorded in Homebrew's official catalogue. NOVI links to it; the file comes straight from github.com, not from NOVI. Where this link comes from
- 1
After it downloads. Open the downloaded file from your Downloads folder. For a .dmg, drag the app into Applications; for a .zip, double-click to unpack it, then move the app into Applications. The first time you open it, macOS may ask you to confirm.
Install with Homebrew Cask
Installs macOS applications using Homebrew, a widely used package manager for macOS. You run these steps yourself; NOVI does not install anything from this website.
- 1
Make sure Homebrew is installed. Homebrew is a free, widely used tool for installing software on a Mac. Open the Terminal app and type “brew --version”. If you see a version number you already have it; otherwise follow the one-line instructions on brew.sh. Open
- 2
Copy this command into Terminal and press Return. It installs the package from Homebrew's official catalogue only. Homebrew checks the download against a known checksum.
brew install --cask homebrew/cask/hammerspoon - 3
Check it worked. The app appears in your Applications folder. You can also run this command to see the installed version:
brew list --cask --versions hammerspoon - 4
See the official package listing. Shows exactly what Homebrew installs and where it comes from. Open
NOVI never installs software from your browser. Downloads come directly from the project or its publisher. Only install software you trust.
Get it working
A free, personal setup plan for your computer: the official download, exact steps, and a checklist. Saved in your dashboard, with help if you get stuck. NOVI never installs or runs anything on your computer.
Requirements
- macOS 13 or later — Minimum macOS version declared by the Homebrew package.
- Homebrew Cask for automatic install — Installs macOS applications using Homebrew, a widely used package manager for macOS. The NOVI companion checks whether it is present.
Trust and security
- license
Published under the MIT License (MIT).
Licence detected by GitHub from the repository's licence file. Read the full licence before modifying or redistributing.
Source - distribution
Distributed through Homebrew Cask, an established package source.
The package manager checks downloads against a published checksum before installing.
Source
NOVI checks licences, maintenance activity and distribution sources. NOVI has not audited this project's code and does not certify it as secure. Only install software you trust.
Reviews
No reviews yet
Be the first to share your experience with Hammerspoon. NOVI never shows invented reviews.
Sign in to write a review.
Recent releases
From GitHub1.1.1Feb 26, 2026
--- layout: post title: 1.1.1 permalink: /releasenotes/1.1.1.html --- Minimum macOS version: 13.0 ## Fixed - Download archive of Hammerspoon should no longer contain spurious resource forks that can confuse macOS Gatekeeper
Full release notes1.1.0Dec 24, 2025
## Fixed - Validate that all arguments provided for an hs.task, are strings [#3664](https://github.com/Hammerspoon/hammerspoon/pull/3664) - Fixes for Xcode 16 [#3690](https://github.com/Hammerspoon/hammerspoon/pull/3690) - hs.urlevent callback parameters are now lowercase [#3691](https://github.com/Hammerspoon/hammerspoon/pull/3691) - Fix `package.path`s under `userruntime` w/ unexpanded tilde [#3703](https://github.com/Hammerspoon/hammerspoon/pull/3703) - Fixed websocket support in `hs.httpserver:start()` [#3665](https://github.com/Hammerspoon/hammerspoon/pull/3665) - hs.ipc: Avoid reentrance when in printReplacement [#3718](https://github.com/Hammerspoon/hammerspoon/pull/3718) - Fix Lua stack corruption in window:application() when process terminated [#3827](https://github.com/Hammerspoon/hammerspoon/pull/3827) - Reuse [statusItem menu] if possible (fixes #1923) [#3812](https://github.com/Hammerspoon/hammerspoon/pull/3812) - The window_filter event handler might receive an invalid pid [#3814](https://github.com/Hammerspoon/hammerspoon/pull/3814) - hs.mouse - fixes setMouseSpeed and adds trackpad support [#3758](https://github.com/Hammerspoon/hammerspoon/pull/3758) ## Added - L
Full release notes1.0.0Aug 6, 2024
## Fixed - [READY] hs.battery -- Fix for systems that report an empty array for powerSources [#3449](https://github.com/Hammerspoon/hammerspoon/pull/3449) - add exit call to fix empty space issue #3465 [#3466](https://github.com/Hammerspoon/hammerspoon/pull/3466) - Include docs.css in build for built in web help [#3476](https://github.com/Hammerspoon/hammerspoon/pull/3476) - fix `attempt to index a nil value (local 'child')` #3481 [#3485](https://github.com/Hammerspoon/hammerspoon/pull/3485) - Fix hs.network.ping to always call didFinish callback [#3531](https://github.com/Hammerspoon/hammerspoon/pull/3531) - Allow passing nil as name to hs.pasteboard.callbackWhenChanged [#3616](https://github.com/Hammerspoon/hammerspoon/pull/3616) - [Review] Fix moving window to space in Sonoma 14.5 [#3638](https://github.com/Hammerspoon/hammerspoon/pull/3638) - Improve Console window performance and RAM usage [#3659](https://github.com/Hammerspoon/hammerspoon/pull/3659) ## Changed - Fix blockAlert documentation [#3484](https://github.com/Hammerspoon/hammerspoon/pull/3484) - Rewrite of hs.hash to simplify adding new hashes [#3483](https://github.com/Hammerspoon/hammerspoon/pull/3483) ## Added
Full release notes0.9.100Mar 14, 2023
--- layout: post title: 0.9.100 permalink: /releasenotes/0.9.100.html --- ## Fixed - None ## Changed - None ## Added - hs.hash now has binary-preserving variants of MD5/SHA1/SHA256/SHA512 (where the existing functions encode the hash to a hex string). These functions have been added to support the new [OBS Spoon](https://www.hammerspoon.org/Spoons/OBS.html)
Full release notes0.9.99Mar 13, 2023
## Fixed - Revert SocketRocket pod update. Closes #3422 [#3424](https://github.com/Hammerspoon/hammerspoon/pull/3424) - Fix hs.application.get() interpreting Lua patterns [#3425](https://github.com/Hammerspoon/hammerspoon/pull/3425) ## Other
Full release notes
Where this information comes from
- Description, audience and features: Written by NOVI editors from the project's README and official website. link
- Statistics, licence and releases: GitHub API link
- Available through Homebrew Cask: Official package registry link
GitHub data last refreshed 3 days ago. Hammerspoon is the property of its authors. NOVI is not affiliated with this project.
