Zen Mode es un script de Hammerspoon, distribuido en GitHub por el usuario cabeen, que ofrece un modo de enfoque global en macOS accionado por un único atajo de teclado. Su objetivo es silenciar visualmente todo lo que compite por la atención del usuario —el fondo de escritorio, los iconos del Dock, los indicadores del Menu Bar y otras ventanas— y dejar únicamente la ventana activa, centrada y a altura completa, enmarcada por un fondo negro con esquinas redondeadas.
A diferencia de los modos zen integrados en editores concretos como VS Code u Obsidian, esta herramienta funciona en cualquier aplicación con ventana: terminal, navegador, lector de PDF o cualquier otra. Tampoco se trata de una aplicación, sino de unas 250 líneas de código en Lua sin dependencias externas, fáciles de revisar y modificar.
El funcionamiento se basa en dibujar un canvas a pantalla completa mediante CoreGraphics, elevado al nivel de ventana del cursor para cubrir también el Menu Bar y el Dock, y practicar un recorte transparente donde se sitúa la ventana enfocada. Al pulsar la combinación Opción+Cmd+Z se activa y se desactiva; Esc también sale del modo. La ventana conserva su tamaño original y se restaura exactamente en su posición al desactivar el modo.
La transición de entrada se ejecuta en dos fases para minimizar parpadeos: primero la ventana se desliza al centro mientras la pantalla se oscurece, y solo después crece en altura bajo la oscuridad. La salida invierte el orden. La animación corre a 60 Hz y, si una aplicación tarda en aplicar un cambio de marco, se rendered menos fotogramas intermedios sin alterar la duración total.
El proyecto incluye tabla de atajos, instrucciones de instalación (brew install --cask hammerspoon), concesión de permisos de Accesibilidad y configuración de init.lua, además de compararse con alternativas como HazeOver, FocusDim o el modo de pantalla completa nativo de macOS.