Skip to content
Limited time offerWebsites from CA$700 CA$490ends Thursday 3 DecemberSee your website
Get started

Hammerspoon

Script and automate almost anything on your Mac

Direct downloadFreeDesktop appMaintained

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 download

Download the official installer from the project or its publisher, then open it. Difficulty: Advanced.

macOS (Apple Silicon)Direct downloadGuided

Download from the publisher

Download for macOS (Apple Silicon)from github.com · Hammerspoon-1.1.1.zip

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. 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. 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. 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. 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. 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

Download for macOS (Intel)from github.com · Hammerspoon-1.1.1.zip

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. 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. 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. 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. 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. 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 GitHub
  • 1.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 notes
  • 1.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 notes
  • 1.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 notes
  • 0.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 notes
  • 0.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.

Similar projects

More in Automation