Macro pad compacto de 12 teclas diseñado para controlar flujos de trabajo en macOS mediante automatizaciones con Hammerspoon.

El dispositivo funciona como un teclado USB (HID) que envía combinaciones de teclas Hyper (Ctrl + Alt + Cmd + tecla). Hammerspoon escucha estos atajos y los convierte en acciones del sistema, apertura de aplicaciones, modos de concentración y control multimedia.

Además, incluye un potenciómetro rotatorio para controlar el volumen de forma precisa, convirtiendo el macro pad en una pequeña superficie de control para el escritorio.

La idea del proyecto es crear una herramienta simple, fiable y totalmente personalizable para mejorar la productividad diaria en macOS.

Características

• 12 botones programables
• Potenciómetro rotatorio para control de volumen
• Dispositivo USB tipo teclado (HID)
• Integración completa con Hammerspoon
• Modos de trabajo o “escenas” de productividad
• Acceso rápido a aplicaciones
• Control multimedia (Music / Podcasts / Play)
• Bloqueo de pantalla
• Diseño de teclas codificado por colores

• Firmware totalmente configurable

   

Componentes necesarios

Este macro pad está construido con componentes sencillos, economicos y fáciles de conseguir. Dejo linkados los enlaces para comprar los componente que yo use. Se pueden encontrar mas economicos en Aliexpress o similares. Yo dejo los usados para la construcción del proyecto en mi caso:

• Arduino Pro Micro (ATmega32U4): Este microcontrolador permite que el dispositivo funcione como un teclado USB nativo.
• Switches - Botones: Botones pulsadores momentáneos para tecla de Teclado Gateron Cherry MX.
• Potenciometro: Potenciómetro lineal de 10k para el control del volumen.
• Cables silicona: Kit de cables eléctricos de silicona de calibre 24 AWG.

Piezas impresas en 3D

Todas las piezas están diseñadas para imprimirse fácilmente, yo use una Bambu Lab A1 Mini:

• Macro Pad Box: Carcasa superior donde iran switches y el potenciometro.
• Carcasa inferior: Tapa para cerrar la caja con tornilleria M3.
• 12 keycaps (teclas) de perfil bajo.
• Perilla para el potenciómetro

Software

El macro pad utiliza Hammerspoon para automatizar macOS. El dispositivo envía atajos Hyper, que Hammerspoon interpreta para ejecutar acciones o lanzar aplicaciones.

Dejo también el repositorio de Gitlab donde descargar el código con el firmware que instalar en el Arduino. El propio repositorio contiene un README.md con todas las instrucciones para modificar el codigo y adaptarlo a vuestras necesidades.