Hammerspoon /hammerspoon

Staggeringly powerful macOS desktop automation with Lua

★ 16,430⑂ 739👁 121⑃ 1,157● 2,632▤ 103
Objective-CMITCreated 2014-10-08www.hammerspoon.org
下载:1.1.11.1.1 ↓1.1.12026-02-26
+2
日增长
16,430
stars
739
forks
121
watchers
1,157
prs
2,632
issues
103
releases

README

Hammerspoon







Discord: Click to join

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

Top issues

Discussions

Latest release

1.1.1 1.1.1 2026-02-26
---
layout: post
title: 1.1.1
permalink: /releasenotes/1.1.1.html
---

Minimum macOS version: 13.0

 Fixed

- Download archive of Hammerspoon should no longer contain spurious resource forks that can confuse macOS Gatekeeper

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON