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

Hammerspoon
7.3K Stars 390 Forks MIT License 5.6K Commits 301 Opened issues

Description

Staggeringly powerful macOS desktop automation with Lua

Services available

!
?

Need anything else?

Contributors list

No Data

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?

Manually

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

Homebrew

  • brew cask install hammerspoon

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: * 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 Freenode) with searchable archives * 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.