Hammerspoon

Hammerspoon es una aplicación de automatización de escritorio para macOS que conecta un motor de scripting Lua con las API del sistema. Está dirigida a personas que saben escribir pequeños scripts y quieren atajos de teclado personalizados, flujos de trabajo con ventanas y automatización basada en eventos. Instalarla por sí sola no proporciona un conjunto de automatizaciones listo para usar: el comportamiento depende de tu configuración.

Capacidades

• Asignar atajos de teclado y automatizar el posicionamiento de ventanas, las acciones de aplicaciones y los flujos de trabajo del escritorio.
• Responder a eventos de pantalla, red, alimentación y otros eventos del sistema mediante callbacks de Lua.
• Inspeccionar y controlar dispositivos de audio compatibles, el portapapeles y el comportamiento de entrada.
• Mostrar notificaciones, menús e interfaces personalizadas mediante las API disponibles.
• Integrar tareas de shell, AppleScript y extensiones compatibles de aplicaciones y del sistema.
• Instalar plugins opcionales y reutilizables de Lua llamados Spoons; cada Spoon tiene su propia configuración y dependencias.

Instalación y configuración

Instala brew install --cask hammerspoon o descarga el ZIP oficial, descomprímelo y mueve Hammerspoon.app a Aplicaciones. Ábrela y crea ~/.hammerspoon/init.lua. Usa su menú para editar y volver a cargar la configuración; consulta la Consola para detectar errores y realizar experimentos interactivos con Lua. Una configuración inicial sencilla puede asignar un atajo de teclado a una notificación y, después, ampliarse para automatizar ventanas o aplicaciones. La guía oficial de introducción y la documentación de la API ofrecen ejemplos funcionales.

Concede a Hammerspoon acceso a Accesibilidad en Ajustes del Sistema de macOS cuando automatices aplicaciones de escritorio o la entrada. Otras operaciones pueden requerir sus propios permisos del sistema, como Automatización o Grabación de pantalla. Activa solo los permisos que necesite tu configuración. Los scripts y Spoons se ejecutan con las capacidades de tu usuario; revisa el código antes de instalarlo.

El cask también enlaza la herramienta de línea de comandos hs incluida. La comunicación por línea de comandos se configura mediante el módulo IPC de Hammerspoon; el enlace por sí solo no activa todas las funciones IPC.

Sistemas y dependencias

La versión actual1.1.1 y Homebrew Cask requieren macOS13 o posterior. Cask enumera plataformas Mac con Intel y Apple Silicon. Hammerspoon es específico para Mac; sus integraciones con las API de macOS no se ofrecen como clientes para Windows, Linux, iOS o Android. Los requisitos de versiones anteriores no deben sustituir a los de1.1.1. El material oficial consultado no especifica un mínimo fijo de RAM ni de espacio en disco.

El ZIP oficial1.1.1 ocupa9,704,557 bytes, según los metadatos del recurso de la versión en GitHub. La aplicación instalada, los scripts y las cachés ocupan espacio adicional. Lua y las extensiones de la aplicación están incluidas; el cask no declara ninguna dependencia adicional de paquetes formula ni ningún conflicto explícito con cask. Se necesitan Xcode y las herramientas de compilación para compilar el código fuente, pero no para usar la aplicación publicada. Los Spoons opcionales, los comandos de shell y las integraciones pueden requerir herramientas o cuentas de servicio instaladas por separado.

Los atajos de teclado personalizados y la automatización de ventanas pueden coincidir con atajos o gestores de ventanas configurados en otros lugares. Estas interacciones dependen de la configuración y no constituyen un conflicto declarado del paquete. Desactiva o modifica las asignaciones duplicadas cuando sea necesario. Los cambios del sistema operativo y el comportamiento de accesibilidad de la aplicación de destino pueden afectar a API de automatización concretas.

Datos, cuentas, coste y licencia

La automatización local básica no requiere una cuenta ni una suscripción de Hammerspoon. El proyecto es gratuito y cuenta con licencia MIT, que permite su uso y modificación, incluso con fines comerciales, siempre que se conserven los avisos requeridos. Las bibliotecas incluidas y los Spoons opcionales mantienen sus respectivas licencias; los servicios alojados a los que accedan tus scripts pueden tener costes y cuentas independientes. Las preguntas frecuentes oficiales indican que los informes de fallos están activados de forma predeterminada y pueden desactivarse en Preferencias; consulta la política de privacidad del proyecto.

El zap de Homebrew incluye ~/.hammerspoon, las preferencias de la aplicación, las cachés y el estado guardado. Ese directorio de configuración contiene tus scripts Lua personalizados y Spoons, así que haz una copia de seguridad antes de realizar una limpieza profunda. Eliminar la aplicación no revierte todas las acciones externas realizadas por tus scripts ni elimina las cuentas utilizadas por las integraciones.

Referencias oficiales

• Producto: https://www.hammerspoon.org/
• Introducción: https://www.hammerspoon.org/go/
• Documentación de la API: https://www.hammerspoon.org/docs/
• Preguntas frecuentes y privacidad: https://www.hammerspoon.org/faq/ y https://www.hammerspoon.org/privacy.html
• Código fuente, licencia MIT y versiones: https://github.com/Hammerspoon/hammerspoon
• Repositorio oficial de Spoons: https://github.com/Hammerspoon/Spoons