Hammerspoon

Hammerspoon é um aplicativo de automação para desktop no macOS que conecta um mecanismo de scripts em Lua às APIs do sistema. Ele é voltado a pessoas que se sentem à vontade para escrever pequenos scripts e querem atalhos de teclado personalizados, fluxos de trabalho com janelas e automações acionadas por eventos. A instalação, por si só, não fornece um conjunto pronto de automações: o comportamento depende da sua configuração.

Recursos

• Defina teclas de atalho e automatize o posicionamento de janelas, ações de aplicativos e fluxos de trabalho do desktop.
• Reaja a eventos de tela, rede, energia e outros eventos do sistema com callbacks em Lua.
• Inspecione e controle dispositivos de áudio compatíveis, a área de transferência e o comportamento de entrada.
• Exiba notificações, menus e interfaces personalizadas por meio das APIs disponíveis.
• Integre tarefas de shell, AppleScript e extensões compatíveis de aplicativos e do sistema.
• Instale plugins Lua reutilizáveis opcionais, chamados Spoons; cada Spoon tem sua própria configuração e dependências.

Instalação e configuração

Instale brew install --cask hammerspoon ou baixe o arquivo ZIP oficial, extraia-o e mova Hammerspoon.app para Aplicativos. Abra o aplicativo e crie ~/.hammerspoon/init.lua. Use o menu para editar e recarregar a configuração; consulte o Console para verificar erros e fazer experimentos interativos em Lua. Uma configuração inicial simples pode associar uma tecla de atalho a uma notificação e, depois, evoluir para automações de janelas ou aplicativos. O guia oficial de introdução e a documentação da API fornecem exemplos funcionais.

Conceda ao Hammerspoon acesso à Acessibilidade nos Ajustes do Sistema do macOS ao automatizar aplicativos do desktop ou ações de entrada. Operações adicionais podem exigir permissões próprias do sistema, como Automação ou Gravação de Tela. Ative somente as permissões necessárias para sua configuração. Scripts e Spoons são executados com os recursos disponíveis para o seu usuário; revise o código antes de instalá-los.

O cask também disponibiliza a ferramenta de linha de comando hs incluída no pacote. A comunicação pela linha de comando é configurada pelo módulo IPC do Hammerspoon; ter a ferramenta disponível, por si só, não ativa todos os recursos de IPC.

Sistemas e dependências

A versão atual 1.1.1 e o Homebrew Cask exigem macOS 13 ou posterior. O Cask lista plataformas Mac com Intel e Apple Silicon. O Hammerspoon é específico para Mac; suas integrações com as APIs do macOS não são fornecidas como clientes para Windows, Linux, iOS ou Android. Os requisitos de versões anteriores não devem ser usados no lugar dos de 1.1.1. O material oficial consultado não especifica um mínimo fixo de RAM ou espaço em disco.

O arquivo ZIP oficial 1.1.1 tem 9,704,557 bytes, de acordo com os metadados do recurso da versão no GitHub. O aplicativo instalado, os scripts e os caches ocupam espaço adicional. Lua e as extensões do aplicativo estão incluídos; o cask não declara dependências adicionais de formula nem conflitos explícitos de cask. Xcode e as ferramentas de compilação são necessários para compilar o código-fonte, não para usar o aplicativo da versão distribuída. Spoons opcionais, comandos de shell e integrações podem exigir ferramentas instaladas separadamente ou contas de serviço.

Teclas de atalho personalizadas e automações de janelas podem se sobrepor a atalhos ou gerenciadores de janelas configurados em outros lugares. Essas interações dependem da configuração e não constituem um conflito declarado do pacote. Desative ou ajuste associações duplicadas quando necessário. Mudanças no sistema operacional e o comportamento de acessibilidade dos aplicativos de destino podem afetar APIs de automação específicas.

Dados, contas, custo e licença

A automação local básica não exige uma conta nem assinatura do Hammerspoon. O projeto é gratuito e licenciado sob a MIT, permitindo seu uso e modificação, inclusive para fins comerciais, desde que os avisos exigidos sejam mantidos. Bibliotecas incluídas e Spoons opcionais mantêm suas respectivas licenças; serviços hospedados acionados pelos seus scripts podem ter custos e exigir contas próprias. A FAQ oficial informa que o envio de relatórios de falhas vem ativado por padrão e pode ser desativado em Preferências; consulte a política de privacidade do projeto.

O Homebrew zap inclui ~/.hammerspoon, preferências do aplicativo, caches e estado salvo. Esse diretório de configuração contém seus scripts Lua personalizados e Spoons, portanto faça um backup antes de uma limpeza profunda. Remover o aplicativo não desfaz todas as ações externas realizadas pelos seus scripts nem exclui contas usadas por integrações.

Referências oficiais

• Produto: https://www.hammerspoon.org/
• Introdução: https://www.hammerspoon.org/go/
• Documentação da API: https://www.hammerspoon.org/docs/
• FAQ e privacidade: https://www.hammerspoon.org/faq/ e https://www.hammerspoon.org/privacy.html
• Código-fonte, licença MIT e versões: https://github.com/Hammerspoon/hammerspoon
• Repositório oficial de Spoons: https://github.com/Hammerspoon/Spoons