Github url

hammerspoon

by Hammerspoon

Hammerspoon /hammerspoon

Staggeringly powerful macOS desktop automation with Lua

6.9K Stars 367 Forks Last release: 6 months ago (0.9.78) MIT License 5.4K Commits 87 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Hammerspoon

IRCBuild Statuscodecov.ioDownloads current releaseDownloads all releasesLatest tagLatest 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.