Hammerspoon

Source: Hacker News

Discord: Click to join

What is Hammerspoon?

This is a tool for powerful automation of macOS. At its core, Hammerspoon is 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. With these, you can write Lua scripts to control many aspects of your macOS environment.

How do I install it?

Manually

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

Homebrew

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. Several resources 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. Mjolnir aimed to be a very minimal application, with its extensions hosted externally and managed using a Lua package manager. Hammerspoon provides 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