sergio
b3b44e2c72
Un escritorio en «modo launcher» necesita un lanzador. `mirada-launcher` es una app nueva, sin dependencias: escanea los `.desktop` del estándar XDG y lanza el que elijas desde una lista de terminal que se filtra escribiendo. - Recorre los directorios `applications/` de XDG en orden de prioridad (el del usuario tapa a los del sistema, dedup por id de archivo), parsea el grupo `[Desktop Entry]` (salta `NoDisplay`/`Hidden`, exige `Type=Application`), y limpia los códigos de campo del `Exec`. - Interfaz de terminal sin raer modo: número = lanzar, texto = filtrar (si deja una sola, la lanza), Enter vacío = salir. Las apps con `Terminal=true` se envuelven en `foot -e`. - Pensado para abrirse en una terminal pequeña; al lanzar termina y el programa queda corriendo, reparentado a init. El keymap por defecto ata `Super+p` a `spawn:foot -e mirada-launcher` (`Super+d` ya era el layout CenteredMaster). 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.
Lleva teclado y ratón por libinput: el foco sigue al puntero y los
clics y la rueda llegan a la ventana que tienes debajo. El cursor toma
la forma que pide el cliente (la «I» sobre texto, una mano…) y cae a un
cuadrado por defecto sobre el escritorio. Super+arrastre con el
botón izquierdo mueve una ventana, con el derecho la redimensiona — al
arrastrarla, la ventana pasa a flotar. Cada ventana lleva un marco
fino: azul la que tiene el foco, gris las demás.
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).
Como sesión de escritorio
Para usar carmen como tu escritorio de verdad — entrar a una sesión, no sólo probarlo:
-
Compila e instala los binarios en el
PATH:cargo build --release -p mirada-compositor -p mirada-ctl -p mirada-launcher sudo install -m755 target/release/mirada-compositor \ target/release/mirada-ctl target/release/mirada-launcher /usr/local/bin/ sudo install -m755 session/mirada-session /usr/local/bin/ -
Arranca desde una TTY:
mirada-sessionO regístralo en un gestor de login copiando
session/carmen.desktopa/usr/share/wayland-sessions/— aparecerá carmen como sesión. -
Autoarranque — los programas que quieras al iniciar van en
~/.config/mirada/autostart, uno por línea (#comenta). Tienes un ejemplo ensession/autostart.example:mkdir -p ~/.config/mirada cp crates/apps/mirada-compositor/session/autostart.example \ ~/.config/mirada/autostart
Dentro de la sesión, Ctrl+Alt+F1…F12 salta a otra TTY y vuelve sin
romper carmen.
Lanzador de aplicaciones
mirada-launcher escanea los .desktop del sistema y lanza el que
elijas. Es un programa de terminal sin dependencias: lo abres en una
terminal pequeña y filtras escribiendo. El keymap por defecto ata
Super+p a spawn:foot -e mirada-launcher — pulsa el atajo, escribe
unas letras del nombre, Enter.
Necesita mirada-launcher y foot en el PATH (ver la instalación de
arriba). Suelto también vale: mirada-launcher en cualquier terminal.
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+…: el lanzador de
aplicaciones Super+p, una terminal Super+Shift+Return, 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, y ratón en el backend DRM), wl_output, wl_data_device
(selección) y xdg-decoration — fuerza decoración del servidor y no
dibuja ninguna, así las ventanas van sin barra de título. 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: conmutación de VT, hotplug de monitores, multi-GPU.
Puntero en el backend winit. Aislamiento de clientes. Ver el SDD.