Hammerspoon

Hammerspoon — приложение для автоматизации на рабочем столе macOS, связывающее движок сценариев Lua с системными API. Оно предназначено для тех, кто умеет писать небольшие сценарии и хочет настроить персональные сочетания клавиш, оконные сценарии и автоматизацию по событиям. Одна лишь установка не предоставляет готовый набор автоматизаций: поведение определяется вашей конфигурацией.

Возможности

• Назначение горячих клавиш и автоматизация размещения окон, действий приложений и рабочих процессов на компьютере.
• Реагирование на события экрана, сети, питания и другие системные события с помощью обратных вызовов Lua.
• Просмотр сведений о поддерживаемых аудиоустройствах, буфере обмена и поведении ввода, а также управление ими.
• Отображение уведомлений, меню и пользовательских интерфейсов с помощью доступных API.
• Интеграция задач оболочки, AppleScript и поддерживаемых расширений приложений и системы.
• Установка дополнительных многоразовых плагинов Lua под названием Spoons; для каждого Spoon предусмотрены собственная настройка и зависимости.

Установка и настройка

Установите brew install --cask hammerspoon или загрузите официальный ZIP-архив, распакуйте его и переместите Hammerspoon.app в папку «Программы». Запустите приложение и создайте ~/.hammerspoon/init.lua. Через меню можно редактировать конфигурацию и перезагружать её; проверяйте ошибки в Console и проводите интерактивные эксперименты с Lua. В простой начальной конфигурации можно назначить горячую клавишу для показа уведомления, а затем добавить автоматизацию окон или приложений. В официальном руководстве Getting Started и документации API приведены рабочие примеры.

Предоставьте Hammerspoon доступ к функциям универсального доступа в системных настройках macOS, если автоматизируете настольные приложения или ввод. Для некоторых дополнительных операций могут потребоваться отдельные системные разрешения, например для автоматизации или записи экрана. Включайте только те разрешения, которые нужны вашей конфигурации. Сценарии и Spoons выполняются с возможностями вашей учётной записи; проверяйте код перед установкой.

cask также содержит ссылку на входящий в комплект инструмент командной строки hs. Связь через командную строку настраивается посредством модуля IPC в Hammerspoon; сама ссылка не включает все функции IPC.

Системы и зависимости

Текущий выпуск 1.1.1 и Homebrew Cask требуют macOS 13 или новее. В описании Cask указаны платформы Mac с процессорами Intel и Apple Silicon. Hammerspoon предназначен только для Mac; интеграции с API macOS не предоставляются в виде клиентов для Windows, Linux, iOS или Android. Требования более ранних выпусков нельзя считать требованиями для 1.1.1. В изученных официальных материалах не указаны минимальные требования к оперативной памяти или дисковому пространству.

Размер официального ZIP-архива 1.1.1 составляет 9,704,557 байт согласно метаданным ресурса выпуска на GitHub. Установленное приложение, сценарии и кэши занимают дополнительное место. Lua и расширения приложения входят в комплект; cask не указывает дополнительных зависимостей формулы и не сообщает о явных конфликтах cask. Для компиляции исходного кода нужны Xcode и инструменты сборки, но для использования выпущенного приложения они не требуются. Для дополнительных Spoons, команд оболочки и интеграций могут понадобиться отдельно установленные инструменты или учётные записи сервисов.

Пользовательские горячие клавиши и автоматизация окон могут пересекаться с сочетаниями клавиш или настройками оконных менеджеров. Такие взаимодействия зависят от конфигурации и не заявлены как конфликт пакетов. При необходимости отключите или измените дублирующиеся назначения. Изменения ОС и поведение универсального доступа в целевых приложениях могут влиять на отдельные API автоматизации.

Данные, учётные записи, стоимость и лицензия

Для базовой локальной автоматизации не нужны учётная запись Hammerspoon или подписка. Проект бесплатный и распространяется по лицензии MIT, которая разрешает использование и изменение, в том числе в коммерческих целях, при условии сохранения обязательных уведомлений. Входящие в комплект библиотеки и дополнительные Spoons сохраняют собственные лицензии; у размещённых в сети сервисов, к которым обращаются ваши сценарии, могут быть отдельные расходы и требования к учётным записям. Согласно официальному разделу FAQ, отправка отчётов о сбоях включена по умолчанию; её можно отключить в Preferences. Ознакомьтесь с политикой конфиденциальности проекта.

Команда zap в Homebrew включает ~/.hammerspoon, настройки приложения, кэши и сохранённое состояние. В этом каталоге конфигурации хранятся ваши пользовательские сценарии Lua и Spoons, поэтому создайте резервную копию перед полной очисткой. Удаление приложения не отменяет все внешние действия, выполненные сценариями, и не удаляет учётные записи, используемые интеграциями.

Официальные материалы

• Продукт: https://www.hammerspoon.org/
• Начало работы: https://www.hammerspoon.org/go/
• Документация API: https://www.hammerspoon.org/docs/
• FAQ и конфиденциальность: https://www.hammerspoon.org/faq/ и https://www.hammerspoon.org/privacy.html
• Исходный код, лицензия MIT и выпуски: https://github.com/Hammerspoon/hammerspoon
• Официальный репозиторий Spoon: https://github.com/Hammerspoon/Spoons