Hammerspoon / hammerspoon

Staggeringly powerful macOS desktop automation with Lua

Home Page:http://www.hammerspoon.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


IRC CI 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


  • 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:

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
ezoic increase your site revenue


Staggeringly powerful macOS desktop automation with Lua


License:MIT License


Language:Objective-C 51.3%Language:Lua 24.8%Language:C 16.3%Language:HTML 5.7%Language:Shell 0.7%Language:Python 0.5%Language:Roff 0.2%Language:Rich Text Format 0.2%Language:C++ 0.2%Language:Makefile 0.2%Language:CSS 0.0%Language:Ruby 0.0%Language:Smarty 0.0%