Repolode
mogenson

mogenson/PaperWM.spoon

Un gestor de ventanas en mosaico y desplazable para macOS, escrito como plugin Spoon para la app de automatización Hammerspoon.

Alternativa open source a:MagnetRectangle

Estrellas
1,791
Forks
87
Issues abiertos
23
Último commit
hace 6 días

¿Qué es?

PaperWM.spoon organiza las ventanas en macOS en una franja horizontal de columnas que se desplaza a izquierda y derecha, de forma similar a la extensión PaperWM para GNOME. Las ventanas nuevas se colocan automáticamente en mosaico, y cada columna se puede redimensionar, apilar como un acordeón o dividir con otra ventana.

Se ejecuta dentro de Hammerspoon y se configura en Lua. Los usuarios asignan atajos de teclado para enfocar, intercambiar y redimensionar ventanas, moverlas entre espacios de Mission Control y ponerlas en modo flotante. Las opciones permiten configurar el espacio entre ventanas, las barras de estado y los docks externos, los anchos predeterminados por app, los filtros para elegir apps y pantallas, y el desplazamiento y arrastre con el mouse o el trackpad.

El proyecto requiere macOS, Hammerspoon y la opción de Mission Control que asigna espacios propios a cada pantalla. Entre sus limitaciones está que macOS no permite mover una ventana completamente fuera de la pantalla, por lo que las ventanas en mosaico que quedan fuera del área visible se ubican en un margen junto al borde de la pantalla.

Funciones clave

  • 01Franja horizontal desplazable de columnas de ventanas en mosaico
  • 02Acciones de enfoque, intercambio y redimensionamiento de ventanas mediante atajos de teclado de Hammerspoon
  • 03Columnas apiladas en forma de acordeón y diseños de pantalla dividida
  • 04Mover ventanas entre espacios de Mission Control
  • 05Deslizar con el trackpad y arrastrar o desplazarse con el mouse para mover ventanas
  • 06Espacios entre ventanas, desplazamiento de barras externas y anchos predeterminados por app configurables

Casos de uso

  • Usuarios de Mac que quieren mosaicos desplazables al estilo de GNOME PaperWM sin salir de macOS
  • Desarrolladores que mantienen abiertas muchas ventanas de editores y terminales y quieren organizar sus espacios de trabajo con el teclado
  • Usuarios con varias pantallas o espacios de Mission Control que quieren una disposición coherente de las ventanas

Inicio rápido

  1. 1

    Clona el Spoon en el directorio Spoons de Hammerspoon

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

    Ajusta la configuración de Mission Control en Ajustes del Sistema, tal como se describe en el README

  3. 3

    Carga el Spoon e inícialo en ~/.hammerspoon/init.lua

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

Antes de usarlo

  • Requiere macOS y la aplicación de automatización Hammerspoon.
  • Antes de usarlo, hay que cambiar la configuración de Mission Control para usar Spaces separados en cada pantalla.
  • Las ventanas que quedarían organizadas fuera de la pantalla se colocan en un margen en los bordes de la pantalla; además, es difícil detectar cuándo se arrastran ventanas entre Spaces o pantallas.

Temas

Preguntas frecuentes

¿Qué es PaperWM.spoon?
Un gestor de ventanas en mosaico y desplazable para macOS, escrito como plugin Spoon para la app de automatización Hammerspoon. PaperWM.spoon organiza las ventanas en macOS en una franja horizontal de columnas que se desplaza a izquierda y derecha, de forma similar a la extensión PaperWM para GNOME. Las ventanas nuevas se colocan automáticamente en mosaico, y cada columna se puede redimensionar, apilar como un acordeón o dividir con otra ventana.
¿PaperWM.spoon es gratuito? ¿Qué licencia tiene?
PaperWM.spoon es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿PaperWM.spoon sigue mantenido?
Mantenimiento activo. El último commit de PaperWM.spoon fue el 13 oct 2026.
¿Para qué puedo usar PaperWM.spoon?
Usuarios de Mac que quieren mosaicos desplazables al estilo de GNOME PaperWM sin salir de macOS Desarrolladores que mantienen abiertas muchas ventanas de editores y terminales y quieren organizar sus espacios de trabajo con el teclado Usuarios con varias pantallas o espacios de Mission Control que quieren una disposición coherente de las ventanas
¿Cómo se instala PaperWM.spoon?
Clona el Spoon en el directorio Spoons de Hammerspoon: git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon Ajusta la configuración de Mission Control en Ajustes del Sistema, tal como se describe en el README Carga el Spoon e inícialo en ~/.hammerspoon/init.lua: PaperWM = hs.loadSpoon("PaperWM") PaperWM:bindHotkeys(PaperWM.default_hotkeys) PaperWM:start()
¿Dónde consigo PaperWM.spoon?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/mogenson/PaperWM.spoon

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados