hammerspoon README

The project's README from github.com/Hammerspoon/hammerspoon. As one markdown file: README.md.

Hammerspoon

CI codecov.io Downloads current release Downloads all releases Latest tag Latest release

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

Homebrew

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:

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:

hammerspoon (Hammerspoon/hammerspoon)

Searching Database…

Что это такое?Hammerspoon — это мост между macOS и движком для скриптов на Lua, который позволяет автоматизировать и контролировать ваш Mac через расширения, открывающие системные возможности для Lua-скриптов.
Это приложение, которое я запускаю, или библиотека, которую я подключаю в проект?Это самостоятельное приложение для macOS (Hammerspoon.app), которое работает в фоне и выполняет ваш конфигурационный файл на Lua, а не то, что встраивается в другой проект.
Как его установить и начать использовать?Установите через Homebrew (brew install hammerspoon --cask) или скачайте релиз и перетащите Hammerspoon.app в папку «Программы». Затем создайте ~/.hammerspoon/init.lua и заполните его своим кодом автоматизации.
Нужно ли знать Lua, чтобы им пользоваться?Да, автоматизации пишутся на Lua, так как расширения Hammerspoon управляются исключительно через Lua-скрипты.
Он что-нибудь полезное делает сразу после установки?Нет, Hammerspoon поставляется без готового поведения: он ничего не делает по умолчанию, пока вы не напишете собственный init.lua с использованием его API и примеров конфигураций из сообщества.
Он работает на любом Mac или только на новых?Он создан именно для macOS (изначально для OS X); ограничений на конкретный чип Mac или версию ОС не указано.
Зачем нужен Hammerspoon, если есть Mjolnir?Hammerspoon появился как форк Mjolnir, потому что команда хотела более цельного опыта работы, тогда как Mjolnir стремится оставаться минималистичным и использует внешне размещаемые расширения, управляемые через пакетный менеджер Lua.
Что именно можно автоматизировать с его помощью?Поскольку он открывает системные API как расширения Lua, можно писать скрипты для управления окнами, горячими клавишами и другими поведениями на уровне ОС; заявленная цель проекта — всё более полное покрытие системных API и более тесная интеграция между расширениями.
Size
158.6 MB
Stars
16.3K
Age
12y
Commits · 90 Days