Customised Fork of Hammerspoon App to support CommandPost
Objective-C Lua C HTML Shell Python Other
Clone or download
Pull request Compare This branch is 408 commits ahead of Hammerspoon:master.
Permalink
Failed to load latest commit information.
.fauxpas Add config blob for checking extensions in Faux Pas Feb 9, 2016
Hammerspoon Tests Skip testing tabs in Travis Jun 22, 2018
Hammerspoon.xcodeproj Added icons for Caches, Plugins & Preferences Aug 11, 2018
Hammerspoon.xcworkspace Merge remote-tracking branch 'Hammerspoon/master' Jul 12, 2018
Hammerspoon Added icons for Caches, Plugins & Preferences Aug 11, 2018
HammerspoonUITests Fix UI Tests to load init.lua, and put in a print() so it's easier to… Jan 26, 2016
LuaSkin Attempt to make it possible to profile LuaSkin tests. Not corrently w… Jul 12, 2018
Pods Update Crashlytics and Fabric Jul 16, 2018
extensions Merge pull request #50 from latenitefilms/audiounits Aug 11, 2018
scripts Merge pull request #50 from latenitefilms/audiounits Aug 11, 2018
.bettercodehub.yml Add config file for BetterCodeHub Apr 11, 2017
.editorconfig Add a root .editorconfig Apr 25, 2017
.gitignore #48 Aug 6, 2018
.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 Force travis bot to join IRC so we can +n Aug 1, 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 fix for 'directory not empty' on build_commandpost_testing.sh Jun 20, 2017
PFMoveApplication.h Updated LetsMove to from 1.22 to 1.24 Jan 23, 2018
PFMoveApplication.m Updated LetsMove to from 1.22 to 1.24 Jan 23, 2018
Podfile Update Crashlytics and Fabric Jul 16, 2018
Podfile.lock Update Crashlytics and Fabric Jul 16, 2018
README.md Improve the 'What next?' section of README.md to be a list that also … Jun 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.70 Jul 16, 2018
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

Build Status codecov.io Downloads current release Downloads all releases Latest tag Latest release Dependency Status

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