Traducido del inglés; el inglés es la referencia autorizada para precios y condiciones.

Getting started

PaperWM.spoon en macOS: instalación y configuración básica

PaperWM.spoon es un complemento gratuito para Hammerspoon en macOS que gestiona ventanas en mosaicos desplazables. Para configurarlo, instala Hammerspoon, clona el repositorio PaperWM.spoon en la carpeta Spoons de Hammerspoon, carga e inicia el Spoon desde init.lua y concede los permisos que solicite macOS. Los comandos siguen el README del proyecto, consultado el 2026-11-12.

5 min de lectura ·

Datos clave

  • PaperWM.spoon es un Spoon de Hammerspoon, no una app independiente para Mac.
  • Su README incluye un comando para clonar el proyecto y ejemplos de configuración Lua.
  • El README pide cambiar dos ajustes de Mission Control: desactivar la reorganización automática de espacios y activar «Pantallas con Spaces separados».
  • Encaja si quieres una configuración Lua ajustable; si prefieres no mantener la configuración de Hammerspoon, puedes elegir otra herramienta.

Instala Hammerspoon primero

Descarga Hammerspoon desde su sitio oficial, consultado el 2026-11-12. Ábrelo una vez y sigue las solicitudes de permisos de macOS. Hammerspoon ejecuta scripts de automatización, así que revisa lo que instalas y el código que cargas. El README de PaperWM.spoon describe el complemento y su instalación. No hemos probado estos pasos en todas las versiones de macOS.

El README oficial de PaperWM.spoon, consultado el 2026-11-12, indica este comando de instalación:

``bash git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon ``

Ejecútalo en Terminal. Clona el repositorio en la carpeta Spoons que usa Hammerspoon. Si tienes un directorio de configuración personalizado, cambia el destino para que coincida.

Configura Mission Control

El README dirige a Preferencias del Sistema → Escritorio y Dock, sección Mission Control. En las versiones actuales de macOS, abre Ajustes del Sistema → Escritorio y Dock y desplázate hasta Mission Control. Desactiva Reorganizar automáticamente los espacios según el uso más reciente y activa Pantallas con Spaces separados. El texto y la ubicación pueden variar según la versión de macOS. El README recomienda estas opciones como parte de la configuración.

Son ajustes de todo el sistema que afectan al comportamiento de los espacios. Antes de cambiarlos, decide si te convienen. Si usas varias pantallas, comprueba que el comportamiento de los espacios sea el que quieres.

Carga e inicia el Spoon

Abre el archivo de configuración de Hammerspoon en ~/.hammerspoon/init.lua y añade estas líneas Lua:

``lua PaperWM = hs.loadSpoon("PaperWM") PaperWM:bindHotkeys(PaperWM.default_hotkeys) PaperWM:start() ``

Guarda el archivo. En el icono de Hammerspoon de la barra de menús, elige Reload Config. La primera línea carga el Spoon, la segunda registra sus atajos predeterminados documentados y la tercera empieza a gestionar ventanas. El README también explica cómo instalarlo con SpoonInstall y muestra atajos personalizados. Empieza con los valores predeterminados para comprobar que se haya cargado antes de cambiar teclas.

Para detener PaperWM.spoon, llama a PaperWM:stop() desde la consola o configuración de Hammerspoon. Si al iniciarlo indica que falta el Spoon, comprueba que la carpeta clonada se llama PaperWM.spoon y esté dentro de la carpeta Spoons que usa Hammerspoon. Revisa la consola de Hammerspoon por si hay errores de Lua antes de cambiar varios ajustes a la vez.

Comprueba los atajos y haz un cambio cada vez

El README de PaperWM.spoon, consultado el 2026-11-12, documenta los atajos predeterminados para cambiar el enfoque con Option–Command–flechas, intercambiar ventanas con Option–Command–Shift–flechas y recorrer anchuras con Option–Command–R. También muestra atajos para ventanas flotantes, espacios y tamaño. Si uno entra en conflicto con otra app, edita la tabla Lua y vuelve a cargar la configuración. Si el complemento deja de responder, revisa la consola de Hammerspoon.

La configuración del Spoon permite filtrar apps y ajustar proporciones. El README señala window_filter y window_ratios como opciones de configuración. Cambia solo los parámetros que identifiques en la documentación y prueba con una ventana normal y otra app que quieras excluir. Los desarrolladores también advierten que macOS limita cuánto puede desplazarse una ventana fuera de pantalla; por eso, los mosaicos de los bordes pueden quedar parcialmente visibles.

Esta herramienta se basa en Lua. Es adecuada si te manejas con archivos de configuración y quieres la flexibilidad de Hammerspoon. Si prefieres una app independiente con una ventana de ajustes, quizá te resulte laborioso mantenerla. Para instalar PaperWM.spoon, sigue las instrucciones de su README y consulta el repositorio antes de empezar, ya que los proyectos de código abierto pueden cambiar.

El README de PaperWM.spoon dice que está «Inspirado en PaperWM» y enlaza al proyecto PaperWM, consultado el 2026-11-12. Son implementaciones independientes y tienen instrucciones distintas.

Desarrollamos SlidePane, una app de macOS para configurar diseños de ventanas sin mantener scripts Lua. Puede convenirte si prefieres los ajustes de una app y controles de atajos integrados; PaperWM.spoon encaja mejor si quieres el modelo programable de Hammerspoon. Consulta Instala SlidePane y empieza la prueba gratuita.

Páginas relacionadas

El artículo Niri para Mac compara otro flujo con desplazamiento. Atajos y distribuciones de teclado explica cómo revisar las combinaciones de teclas de la app.