Skip to content
Staggeringly powerful macOS desktop automation with Lua
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.fauxpas Add config blob for checking extensions in Faux Pas Feb 9, 2016
Hammerspoon Tests Fix up HSinspect tests, but disable the existing test because it does… Dec 27, 2018
Hammerspoon.xcodeproj Rework the hs.chooser UI May 4, 2019
Hammerspoon.xcworkspace Update a lot of trivial things for building against the macOS 10.12 SDK May 3, 2019
Hammerspoon Brutal hackery to get us building again May 3, 2019
HammerspoonUITests Fix UI Tests to load init.lua, and put in a print() so it's easier to… Jan 26, 2016
LuaSkin Bump LuaSkin to 10.12 too May 3, 2019
Pods Also bump the pods to 10.12 May 3, 2019
extensions Switch a couple more hs.chooser textfield cells to using our vertical… May 4, 2019
scripts Use the cocoapods version of Fabric's upload-symbols instead of the s… Oct 17, 2018
.bettercodehub.yml Add config file for BetterCodeHub Apr 11, 2017
.editorconfig Add a root .editorconfig Apr 25, 2017
.gitignore Add rebuild.sh for folks doing self-signed local builds. Closes #1160 Dec 25, 2016
.luacheckrc Update .luacheckrc Mar 15, 2018
.stickler.yml Update .stickler.yml Dec 16, 2017
.syntastic_objc_config Add a .syntastic_objc_config because not having it is annoying me Jul 24, 2015
.travis.yml Remove codecov.log from artifact uploads Oct 16, 2018
CODE_OF_CONDUCT.md Update CoC to 1.3.0 Jan 15, 2016
CONTRIBUTING.md Add a TOC to CONTRIBUTING.md Apr 27, 2017
CREDITS.md Added Chris Hocking & Added some GitHub Links Oct 17, 2017
LICENSE Updated License Date & Link Oct 17, 2017
Makefile Adjusted Markdown Templates Apr 10, 2017
Podfile Also bump the pods to 10.12 May 3, 2019
Podfile.lock Also bump the pods to 10.12 May 3, 2019
README.md Remove broken VersionEye readme badge and add a direct link to IRC Sep 7, 2018
SPOONS.md Fix a Lua syntax error in SPOONS.md. Closes #1594 Nov 22, 2017
appcast.xml Update appcast.xml for 0.9.75 May 3, 2019
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

README.md

Hammerspoon

IRC Build Status codecov.io 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 Hammerspoon.app from your Downloads folder to Applications

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:

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
You can’t perform that action at this time.