Staggeringly powerful OS X desktop automation with Lua
Objective-C Lua C HTML C++ Shell Other
Failed to load latest commit information.
.fauxpas Add config blob for checking extensions in Faux Pas Feb 9, 2016
Hammerspoon Tests Add tests for hs.brightness Dec 29, 2016
Hammerspoon.xcodeproj Remove dangling sqlite3.{c,h} references from Xcode Jan 10, 2017
Hammerspoon.xcworkspace Apply Xcode project setting updates - just some new compiler warning … Sep 27, 2016
Hammerspoon Prepare for 0.9.52 Dec 29, 2016
HammerspoonUITests Fix UI Tests to load init.lua, and put in a print() so it's easier to… Jan 26, 2016
LuaSkin Move a few comments in Skin.h to make the define blocks easier for my… Jan 10, 2017
Pods Bump Crashlytics and Fabric to the latest versions Nov 16, 2016
extensions Further guarding in hs.application's getMenuStructure(). May resolve … Jan 10, 2017
scripts Add hs.sqlite3 Jan 10, 2017
.gitignore Add for folks doing self-signed local builds. Closes #1160 Dec 25, 2016
.luacheckrc Add a .luacheckrc Jul 20, 2015
.syntastic_objc_config Add a .syntastic_objc_config because not having it is annoying me Jul 24, 2015
.travis.yml Make sure we pip install our dependencies Jan 6, 2017 Update CoC to 1.3.0 Jan 15, 2016 Small clarifications/tidying in Dec 26, 2016 Credit for hs.application.watcher. Closes #287 May 13, 2015
LICENSE Add a LICENSE file, for clarity Nov 6, 2014
Makefile Switch Makefile to using for HTML generation Jan 6, 2017
Podfile Bump Crashlytics and Fabric to the latest versions Nov 16, 2016
Podfile.lock Bump Crashlytics and Fabric to the latest versions Nov 16, 2016 Fix one of the shield URLs in [noci] Jan 10, 2017
appcast.xml Add 0.9.52 to appcast.xml Dec 29, 2016
codecov.yml Add codecov.yaml Jun 27, 2016
requirements.txt Switch to mistune for MD rendering, fix up CSS to current version, fi… Jan 6, 2017


Build Status Downloads current release Downloads all releases Latest tag Latest release

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?

  • Download the latest release
  • Drag from your Downloads folder to Applications

What next?

We have a Getting Started Guide, extensive API docs, a FAQ, a Contribution Guide for developers looking to get involved, and an IRC channel for general chat/support/development (#hammerspoon on Freenode).

What is the history of the project?

Hammerspoon is a fork of Mjolnir by Steven Degutis. 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