Hammerspoon - puissant outil d’automatisation du bureau macOS implémenté en Lua

• Outil d’automatisation open source permettant de contrôler l’environnement macOS avec des scripts Lua, jouant un rôle de passerelle entre le système d’exploitation et le moteur de scripting
• Expose les fonctionnalités du système via divers modules d’extension (extensions), qu’il est possible de combiner pour automatiser des tâches complexes comme la gestion des fenêtres ou le contrôle des entrées
• L’installation est prise en charge via Homebrew ou par téléchargement manuel, mais l’outil ne fonctionne qu’après avoir rédigé soi-même le fichier de configuration ~/.hammerspoon/init.lua
• Le projet est un fork de Mjolnir et vise à offrir une expérience utilisateur plus intégrée, tout en poursuivant l’extension des API système et le renforcement de l’intégration entre extensions
• Il s’est imposé comme une plateforme d’automatisation avancée permettant aux développeurs et aux power users de contrôler macOS avec une grande finesse

---

Présentation de Hammerspoon

• Hammerspoon est un puissant outil d’automatisation pour macOS (anciennement OS X), qui fonctionne comme une passerelle reliant le système d’exploitation à un moteur de scripting Lua
  • Les utilisateurs peuvent contrôler diverses fonctionnalités du système via des scripts Lua
• Les fonctionnalités principales sont fournies par des modules d’extension (extensions), qui exposent des fonctions spécifiques du système
  • Cela permet d’automatiser de nombreuses tâches, comme la gestion des fenêtres, le contrôle audio ou la configuration des périphériques d’entrée

Installation

• Installation manuelle
  • Télécharger la dernière release sur GitHub
  • Déplacer Hammerspoon.app dans le dossier Applications
• Installation avec Homebrew
  • Commande : brew install hammerspoon --cask

Configuration initiale et utilisation

• Juste après l’installation, l’outil ne fait rien par défaut : l’utilisateur doit créer lui-même le fichier ~/.hammerspoon/init.lua
• Ressources utiles :
  • Getting Started Guide
  • Documentation API
  • FAQ
  • Recueil d’exemples de configuration
  • Guide de contribution pour les développeurs
  • Support via le canal IRC (#hammerspoon sur Libera) et le Google Group

Histoire du projet

• Hammerspoon a commencé comme un fork du projet Mjolnir
  • Mjolnir visait une structure d’application minimale et gérait les extensions sous forme de packages Lua externes
  • Hammerspoon a été développé sur cette base afin d’offrir une expérience utilisateur plus intégrée

Orientation future du projet

• Élargir la couverture des API système
• Renforcer l’intégration entre les modules d’extension
• Améliorer l’expérience utilisateur

Architecture technique et statistiques

• Répartition principale des langages : Objective-C 51 %, Lua 24,7 %, C 16,3 %, HTML 5,6 %, Shell 0,7 %, Python 0,5 %
• Statistiques GitHub : 14.9k stars, 678 forks, 133 contributeurs
• Licence : MIT License
• Site officiel : www.hammerspoon.org

Principaux tags

• macOS, automation, lua, objective-c, osx, mjolnir, hammerspoon, irc