Documentación

Todo lo necesario para instalar, configurar y moldear atlaswm a tu flujo de trabajo.

Bienvenido a la documentación de atlaswm. atlaswm es un compositor Wayland construido en torno a un plano 2D infinito: las ventanas se colocan en cualquier lugar de un lienzo sin límites, y tu monitor es una vista que desplazas sobre él, en X y en Y.

Esta es la caja de herramientas. Las páginas aquí recorren el modelo mental, la instalación y ejecución de atlaswm, y las primitivas — planos, etiquetas, blocs ocultos, grupos, anclas, zoom/vista general, atajos, submodos y reglas de ventanas — que combinas para construir el flujo que quieras.

¿Nuevo por aquí? Lee el modelo mental (el vocabulario que hace que todo resulte obvio), luego instálalo y prueba la primera ejecución. Cuando estés listo para moldearlo, las recetas de flujo de trabajo son configs listas para copiar y pegar para montajes estilo niri, driftwm, i3/sway o espaciales.

En esta sección

• Modelo mental — Plano, vista, filas, columnas, celdas, pestañas, divisiones y ventanas flotantes — el vocabulario que hace obvios los atajos.
• Instalación — Ejecuta atlaswm anidado en una ventana para desarrollo, o instala el flake y elígelo en tu greeter como una sesión GPU real.
• Primer arranque — Lanzar, foco, mover, desplazar, hacer zoom — el puñado de teclas que hace que el plano encaje en los primeros minutos.
• Configuración — Un solo archivo KDL recargado en vivo lo controla todo: la tecla mod, la entrada, los atajos, los submodos, la apariencia, las animaciones, las reglas y más.
• Atajos de teclado — Los atajos por defecto, cómo reasignarlos, los submodos resize / planes, y cómo mod "auto" elige Alt o Super.
• Conceptos — Planos, etiquetas, blocs gather/summon, la vista general, anclas, marcas, reglas de ventanas y grupos — las primitivas que compones en un flujo de trabajo.
• Integración — Barras y paneles vía wlr-layer-shell, los módulos de waybar atlas-submap / atlas-plane, y el scripting de atlaswm por IPC con atlasctl.
• Solución de problemas — NVIDIA EGL/dmabuf, tema del cursor, peculiaridades anidado bajo Hyprland, compartir pantalla y el env del portal, latencia de lanzamiento — lo que más molesta al principio.
• Receta: estilo niri — Una fila, desplazamiento de columnas en X — atlaswm como niri, en 2D. La tira desplazable horizontal, con la segunda dimensión lista cuando la quieras.
• Receta: estilo driftwm — Clústeres desconectados repartidos por el lienzo; desplaza, haz zoom y vista general entre ellos — el modelo de grupos de trabajo de driftwm en un plano 2D.
• Receta: estilo i3 / sway — Planos como espacios de trabajo numerados, divisiones h/v recursivas y pestañas a nivel del WM, atajos i3 familiares — el tilado manual sobre un lienzo infinito.
• Receta: centro espacial y satélites — Un centro con satélites repartidos por un gran plano; salta entre ellos por ancla nombrada o marca de ventana. El flujo que solo un plano infinito hace posible.

La documentación está en progreso — más páginas llegan en la fase 2.