Hammerspoon / hammerspoon

git clone https://github.com/Hammerspoon/hammerspoon.git 1.1.1 · 7mo ago 🔥 on GitHub Trending today

macOS automation app that bridges system APIs to a Lua scripting engine, configured via ~/.hammerspoon/init.lua.

Why you might care

Useful for macOS users who want to script window management, hotkeys, and system events in Lua without building a custom app. It is a fork of Mjolnir that bundles its extensions into the app rather than loading them through a Lua package manager. Installable via Homebrew cask or direct download.

Alternatives

Keyboard MaestroBetterTouchToolMjolnirskhdKarabiner-Elements

—

stars, 24h

—

stars, 7 days

+171

stars, 30 days · #4,463

16k

★ total

733

forks · 668 open issues

Star history starts 2026-10-23; the chart appears after the second daily snapshot.

LanguageObjective-C

LicenseMIT

Created2014-10-08 (12y ago)

Last push3mo ago

Watchers128

OwnerOrganization

Seen on GitHub Trending

2026-10-23 — #13 monthly in objective-c · +171 ★

GitHub topics

macos objective-c lua hammerspoon osx automation mjolnir irc

Links

GitHub: github.com/Hammerspoon/hammerspoon
Homepage: http://www.hammerspoon.org
Releases · Issues · Hacker News mentions

README excerpt

# Hammerspoon
Discord: Click to join
## What is Hammerspoon?
This is a tool for powerful automation of OS X. At its core, Hammerspoon is just a bridge between the operating system and a Lua scripting engine.
What gives Hammerspoon its power is a set of extensions that expose specific pieces of system functionality, to the user. With these, you can write Lua scripts to control many aspects of your OS X environment.
## How do I install it?
### Manually
* Download the latest release
* Drag `Hammerspoon.app` from your `Downloads` folder to `Applications`
### Homebrew
* `brew install hammerspoon --cask`
## What next?
Out of the box, Hammerspoon does nothing - you will need to create `~/.hammerspoon/init.lua` and fill it with useful code. There are several resources which can help you:
* Getting Started Guide
* API docs
* FAQ
* Sample Configurations supplied by various users
* Contribution Guide for developers looking to get involved
* An IRC channel for general chat/support/development (#hammerspoon on Libera)
* Google Group for support
## What is the history of the project?
Hammerspoon is a fork of Mjolnir. Mjolnir aims to be a very minimal application, with its extensions hosted externally and managed using a Lua package manager. We wanted to provide a more integrated experience.
## What is the future of the project?
Our intentions for Hammerspoon broadly fall into these categories:
* Ever wider coverage of system APIs in Extensions
* Tighter integration between extensions
* Smoother user experience