Need help with hammerspoon?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

8.3K Stars 431 Forks MIT License 6.1K Commits 400 Opened issues


Staggeringly powerful macOS desktop automation with Lua

Services available


Need anything else?

Contributors list


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


  • brew install hammerspoon --cask

What next?

Out of the box, Hammerspoon does nothing - you will need to create

and fill it with useful code. There are several resources which can help you: * Getting Started Guide * API docs * FAQ * Sample Configurations supplied by various users * Contribution Guide for developers looking to get involved * An IRC channel for general chat/support/development (#hammerspoon on Libera) * Google Group for support

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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.