Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Hammerspoon/hammerspoon
Staggeringly powerful macOS desktop automation with Lua
https://github.com/Hammerspoon/hammerspoon
automation hammerspoon irc lua macos mjolnir objective-c osx
Last synced: about 2 months ago
JSON representation
Staggeringly powerful macOS desktop automation with Lua
- Host: GitHub
- URL: https://github.com/Hammerspoon/hammerspoon
- Owner: Hammerspoon
- License: mit
- Created: 2014-10-08T19:24:44.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-01T22:45:20.000Z (3 months ago)
- Last Synced: 2024-04-01T23:39:55.512Z (3 months ago)
- Topics: automation, hammerspoon, irc, lua, macos, mjolnir, objective-c, osx
- Language: Objective-C
- Homepage: http://www.hammerspoon.org
- Size: 149 MB
- Stars: 11,415
- Watchers: 117
- Forks: 565
- Open Issues: 611
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Lists
- open-source-mac-os-apps - Hammerspoon - Staggeringly powerful macOS desktop automation with Lua. ![lua_icon] ![objective_c_icon] (Applications / Window Management)
- CoreML-Guide - Hammerspoon
- macOS-iOS-iPadOS-Guide - Hammerspoon
- Xcode-Guide - Hammerspoon
- Developer-Handbook - Hammerspoon
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - hammerspoon
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-starred-test - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- my-awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- my-awesome-starred - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - hammerspoon
- awesome-stars - hammerspoon
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-web-dev - hammerspoon
- awesome-stars - hammerspoon
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- my-awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - hammerspoon
- awesome-stars - hammerspoon
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- my-awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars-copy - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - hammerspoon
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- artsz-awesome - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-starts - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- Metal-Guide - Hammerspoon
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (objective-c)
- my-awesome - Hammerspoon/hammerspoon - c,osx pushed_at:2024-05 star:11.6k fork:0.6k Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - hammerspoon
- my-awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - `★11640` Staggeringly powerful macOS desktop automation with Lua (Objective-C)
- awesome-stars - Hammerspoon/hammerspoon - Staggeringly powerful macOS desktop automation with Lua (objective-c)
- awesome-from-stars - Hammerspoon/hammerspoon
README
# Hammerspoon
[![CI](https://github.com/Hammerspoon/hammerspoon/workflows/CI/badge.svg)](https://github.com/Hammerspoon/hammerspoon/actions?query=workflow%3ACI)
[![codecov.io](https://codecov.io/github/Hammerspoon/hammerspoon/coverage.svg?branch=master)](https://codecov.io/github/Hammerspoon/hammerspoon?branch=master)
[![Downloads current release](https://img.shields.io/github/downloads/Hammerspoon/hammerspoon/latest/total.svg)](https://github.com/Hammerspoon/hammerspoon/releases)
[![Downloads all releases](https://img.shields.io/github/downloads/Hammerspoon/hammerspoon/total.svg?maxAge=2592000)](https://github.com/Hammerspoon/hammerspoon/releases)
[![Latest tag](https://img.shields.io/github/tag/Hammerspoon/hammerspoon.svg)](https://github.com/Hammerspoon/hammerspoon/tags)
[![Latest release](https://img.shields.io/github/release/Hammerspoon/hammerspoon.svg)](https://github.com/Hammerspoon/hammerspoon/releases/latest)Discord: [Click to join](https://discord.gg/vxchqkRbkR)
## 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](https://github.com/Hammerspoon/hammerspoon/releases/latest)
* 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](https://www.hammerspoon.org/go/)
* [API docs](https://www.hammerspoon.org/docs/)
* [FAQ](https://www.hammerspoon.org/faq/)
* [Sample Configurations](https://github.com/Hammerspoon/hammerspoon/wiki/Sample-Configurations) supplied by various users
* [Contribution Guide](https://github.com/Hammerspoon/hammerspoon/blob/master/CONTRIBUTING.md) for developers looking to get involved
* An IRC channel for general chat/support/development (#hammerspoon on Libera)
* [Google Group](https://groups.google.com/forum/#!forum/hammerspoon/) for support## What is the history of the project?
Hammerspoon is a fork of [Mjolnir](https://github.com/sdegutis/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