A modernized rewrite of Hammerspoon - a powerful macOS application for automating your Mac using JavaScript.
Hammerspoon 2 is currently considered EXPERIMENTAL. There may be crashes, memory leaks, bugs, etc. and the JavaScript API may change radically without warning.
Hammerspoon 2 is targeting to release with macOS 27 as the minium supported version.
Pre-releases up to (and including) 0.0.6 target macOS 15.6 and support both Apple Silicon and Intel
From a future pre-release onwards, builds will require at least macOS 26, and once macOS 27 releases, that will become the minimum target.
- Download one of the pre-releases from GitHub, unzip and place in /Applications
- Create ~/.config/hammerspoon2/init.js
- For the JavaScript API docs, see https://cmsj.github.io/Hammerspoon2/ or run hs.docs.show() in the Console window
This is an Xcode project. Open Hammerspoon 2.xcodeproj in Xcode to build. To generate doc artifacts, run npm install in the top level of the repository.
See the LICENSE file for details.
This is a modernized rewrite of the original Hammerspoon project.