sergio
c07356d8bc
mirada-compositor tiene dos backends: winit (anidado) y drm (nativo sobre TTY, verificado en hardware). README con la selección de backend, los requisitos de cada uno y MIRADA_STARTUP/MIRADA_DRM_TIMEOUT; SDD con la estructura del backend DRM. Pendiente: puntero en DRM, VT switch, hotplug. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
mirada-compositor — el Cuerpo de carmen
Un compositor Wayland teselante real, sobre smithay. Es el Cuerpo
de la arquitectura Cerebro↔Cuerpo de mirada (ver
crates/modules/mirada/SDD.md): habla el protocolo Wayland con los
clientes, compone sus superficies y aplica la geometría que decide el
Cerebro.
Tiene dos backends gráficos:
winit— corre anidado, como una ventana dentro de tu sesión gráfica actual (X11 o Wayland). Para desarrollar y probar sin dejar el escritorio.drm— corre nativo sobre una TTY, sin sesión anfitriona: toma la GPU (DRM/KMS/GBM/EGL), el teclado (libinput) y la pantalla entera. Es carmen como tu escritorio de verdad.
Sin argumentos elige solo: con DISPLAY/WAYLAND_DISPLAY → winit;
sin ellos → drm. O fuérzalo: mirada-compositor --winit / --drm.
Backends
winit — anidado
cargo run -p mirada-compositor -- --winit
Necesita una sesión gráfica anfitriona (X11 o Wayland) donde dibujar su ventana; sin ella aborta con un mensaje que lo explica.
drm — nativo sobre TTY
cargo run -p mirada-compositor -- --drm
Corre directo sobre el hardware. Requiere una TTY (Ctrl+Alt+F3),
una GPU con /dev/dri, y seatd o logind para la sesión. Toma la
pantalla completa; sal con Super+Shift+e o Ctrl+C.
MIRADA_STARTUP=<cmd>— lanza una app al arrancar (MIRADA_STARTUP=foot).MIRADA_DRM_TIMEOUT=<s>— cierra el compositor solo tras N segundos (0 o sin definir = sin tope).
Dos modos
-
Autónomo (por defecto) — lleva un
Desktop(demirada-brain) embebido. Es un compositor teselante completo en un solo proceso.cargo run -p mirada-compositor -
Enlazado — el Cuerpo escucha en un socket y la app
mirada(el Cerebro GPUI) se conecta y decide la geometría.# terminal 1 — el Cuerpo MIRADA_SOCKET=/tmp/mirada.sock cargo run -p mirada-compositor # terminal 2 — el Cerebro MIRADA_SOCKET=/tmp/mirada.sock cargo run -p mirada
Probarlo
Al arrancar imprime el WAYLAND_DISPLAY que abrió. Lanza cualquier
cliente Wayland contra él:
WAYLAND_DISPLAY=wayland-1 foot # o weston-terminal, alacritty, …
Las ventanas se teselan solas. El teclado, con la ventana del compositor
enfocada, maneja el escritorio con atajos Super+…: foco Super+j/k,
los 7 layouts en Super+t/m/g/c/r/d/s (o ciclar con Super+space), área
maestra Super+h/l, nmaster Super+,/., promover a maestra
Super+Return, escritorios Super+1..9, cerrar Super+q. Cierra la
ventana del compositor para salir.
Atajos de teclado
Los atajos son configurables en RON: ~/.config/mirada/keymap.ron. En
modo autónomo, el Cuerpo lo carga al arrancar (si no existe, escribe uno
por defecto documentado) y lo recarga en caliente — edita el archivo,
guarda, y los atajos cambian sin reiniciar. En modo enlazado el keymap es
asunto del Cerebro (la app mirada).
cargo run -p mirada-brain --example keymap-default # ver el formato
El compositor en sí no interpreta atajos: sólo intercepta las
combinaciones que el Cerebro le pide (GrabKeys) y le devuelve la
pulsada. Qué significa cada una lo decide mirada-brain. Ver el SDD.
Control externo
En modo autónomo, el compositor abre un socket de control y mirada-ctl
lo maneja desde la terminal — al estilo de swaymsg/hyprctl:
mirada-ctl focus-next # cambia el foco
mirada-ctl focus-window 5 # enfoca una ventana concreta
mirada-ctl workspace 3 # va al escritorio 3
mirada-ctl windows # lista las ventanas
En modo enlazado el socket de control lo abre el Cerebro (la app
mirada), no el compositor.
Qué implementa
wl_compositor, xdg_shell (toplevels y popups), wl_shm, wl_seat
(teclado), wl_output y wl_data_device (selección). Composición con
GlesRenderer — en winit sobre la ventana, en drm con un
DrmCompositor por salida.
Reusa mirada-body para la contabilidad de salidas y superficies, y
mirada-link para el cable hacia un Cerebro externo. Toda la lógica
espacial es agnóstica de Wayland y vive en los crates de
crates/modules/mirada/.
Pendiente
Del backend DRM: puntero/ratón (hoy sólo teclado), conmutación de VT, hotplug de monitores. Aislamiento de clientes. Ver el SDD.