Manual / Documentación actual del escritorio

Terminal & Editores

Kitty, tmux, cmux TUI, LazyVim, VS Code, banners de tareas e historia de la concha.

Este es el Manual del escritorio, publicado desde el mismo catálogo generado. Los botones, paneles y menús se refieren al escritorio instalado. Las actualizaciones pueden ser más recientes que la ISO disponible. Consulta el alcance de instalación y validación.

SUPER + Enter abre el terminal elegido (Kitty por defecto). SUPER + Ctrl + Enter abre o conecta la sesión principal de tmux. SUPER + P busca archivos por coincidencia aproximada; SUPER + Ctrl + P busca en su contenido. Aprender > Comandos Cmux, Comandos Tmux y Comandos LazyVim son referencias consultables: seleccionar un comando lo copia, no lo ejecuta.

Kitty muestra una estela corta en saltos de al menos dos celdas, como Enter, Home/End o movimientos entre palabras. Empieza tras 3 ms en reposo y desaparece en 0,05–0,15 segundos. Ajusta cursor_trail, cursor_trail_decay o cursor_trail_start_threshold en ~/.config/kitty/local.conf; cursor_trail 0 la desactiva. Tus opciones prevalecen sobre las del paquete y sobreviven a los cambios de tema.

Fuego del cursor

Configuración > Estilo > Terminal > Fuego del cursor ofrece Desactivado (predeterminado) y Activado. Activado usa el efecto cursor-trail-blaze integrado de Kitty al mover el cursor, sin detectar velocidad de escritura. Desactivado recupera la estela rápida normal y tu elección personal de shader.

Requiere Kitty 0.49+ y shader-slang, incluidos en las dependencias de Eitr. Activarlo valida el shader antes de guardar o recargar Kitty. La preferencia local está en ~/.config/eitr/terminal.json; el auxiliar escribe kitty/cursor-fire.conf, incluido al final por el cargador del usuario. Activado, selecciona el shader de fuego y baja el umbral a una celda. Fuentes, temas y archivos personales quedan intactos.

Elegir terminal

Configuración > Estilo > Terminal en Walker y Centro de control > Estilo > Terminal ofrecen Kitty (predeterminado) y Ghostty. El campo local terminal de ~/.config/eitr/terminal.json controla Super+Enter, tmux, las sesiones de usuario, los terminales de IA/proyectos y las acciones de Walker para abrir en un terminal. Si falta Ghostty, elegirlo abre el flujo normal de instalación del paquete oficial: Enter instala y Esc cancela. Kitty sigue seleccionado hasta que la instalación termine correctamente. Si después se elimina Ghostty, se usa Kitty. Ghostty es opcional y no se incluye en la ISO.

Al cambiar de tema se regenera ~/.config/ghostty/eitr.conf con los 16 colores ANSI y los colores de fondo, texto, selección y cursor de texto. Los cambios de fuente actualizan la familia elegida; el tamaño predeterminado es 10 puntos. Ghostty usa la misma zsh y su prompt, con opacidad del 75 % y sin margen interior en ventanas normales. Hyprland proporciona el desenfoque, las decoraciones y las reglas normales. La familia, tamaño y opción Auto/Claro/Oscuro del puntero en eitr/cursor.json siguen aplicándose mediante GTK y el compositor, por separado del cursor de texto.

El lanzador de Eitr carga el archivo generado. Guarda opciones personales como font-size = 12 o cursor-style = bar en ~/.config/ghostty/local.conf: se carga al final y se conserva al cambiar de tema. Las sesiones abiertas reciben la señal de recarga compatible tras cambios de tema o fuente. Algunas opciones solo afectan a ventanas nuevas. El rastro y Fuego del cursor de Kitty son exclusivos de Kitty; Ghostty no tiene un ajuste Blaze integrado equivalente.

Los terminales de tareas, menús, estado y configuración de Eitr siempre usan Kitty, incluidos eitr-menu-terminal, eitr-plugins y fif-terminal: dependen de sus opciones --class, --hold, --title y reglas de ventanas flotantes. Elegir Ghostty no los cambia.

Apariencia del terminal y desenfoque compartido

Configuración > Estilo > Terminal y Centro de control > Estilo > Terminal aplican opacidad, relleno y desenfoque a Kitty y Ghostty. La opacidad ofrece Sólido (100%), Ligero (90%), Medio (80%), Predeterminado (75%) y Fuerte (70%). El relleno ofrece Ninguno, Pequeño (4 puntos) y Cómodo (8 puntos). Los valores predeterminados conservan 75% de opacidad, sin relleno y desenfoque activado. Los terminales de utilidades conservan su fondo sólido y su relleno de tareas.

Desactivar el desenfoque lo elimina de las ventanas normales de Kitty y Ghostty, sin volverlas opacas. La intensidad es compartida: Suave (tamaño 2, una pasada), Media (tamaño 3, dos pasadas, predeterminada) y Fuerte (tamaño 5, tres pasadas). La misma opción aparece en Barra del escritorio de Walker y Barra del Centro de control, junto a apariencia. Hyprland 0.57 solo permite intensidad global: afecta a paneles, notificaciones, Vista general y otras aplicaciones que ya usan desenfoque. Elegir una intensidad no activa el desenfoque del terminal. Mayor intensidad exige más trabajo de GPU. Color del tema conserva su apariencia sólida.

Las preferencias del terminal están en eitr/terminal.json; blur-strength compartido está en quickshell/desktop-bar/bar-settings.json (versión 1). Estas preferencias regeneran kitty/appearance.conf, ghostty/eitr.conf y hypr/appearance.lua. El compositor carga la apariencia antes de hypr/local.lua, por lo que prevalecen las reglas personales. kitty/local.conf y ghostty/local.conf prevalecen sobre los ajustes predefinidos. Cambios de tema y actualizaciones del paquete regeneran los archivos. Kitty recibe SIGUSR1 y las sesiones compatibles de Ghostty reciben SIGUSR2; las opciones que no se pueden recargar se aplican a ventanas nuevas.

El comando eitr

eitr reúne las herramientas de Eitr; ejecútalo sin argumentos para ver la lista. Usa los mismos scripts que los menús para mantener el mismo comportamiento.

eitr update                  # System Update: snapshot, packages, AUR, Flatpak
eitr update aur              # only AUR packages, without a snapshot
eitr theme list              # installed themes, the current one marked *
eitr theme set "Eitr" # switch theme
eitr firewall on             # also: off, status
eitr snapshots               # recovery snapshots
eitr snapshots changes       # what each update changed
eitr reset keep-files        # factory reset, after the usual two warnings
eitr report                  # prepare a problem report
eitr handbook troubleshooting
eitr version
eitr about

eitr about abre la ventana de información de Eitr o enfoca la ventana existente.

eitr config y eitr git pasan sus argumentos a eitr-config y eitr-git. Cada comando tiene --help.

Tus propios hooks

Un hook es un pequeño script tuyo que Eitr ejecuta en un momento concreto para ampliar su comportamiento sin modificarlo. Coloca un ejecutable con el nombre de ese momento en ~/.config/eitr/hooks/:

Archivo Cuándo se ejecuta Argumento recibido
post-update después de Actualización del sistema o una actualización pacman/AUR system, pacman, yay o full
theme-set después de cambiar de tema nombre de la carpeta del tema
battery-low una vez cada vez que la batería baja al 15% porcentaje
post-boot en la primera sesión después de cada arranque ninguno

Para cambiar los colores de Spotify con Spicetify al cambiar de tema, crea ~/.config/eitr/hooks/theme-set:

#!/usr/bin/env bash
spicetify config color_scheme "$1" && spicetify apply

Hazlo ejecutable con chmod +x ~/.config/eitr/hooks/theme-set. Cada hook dispone de 60 segundos; su salida y los fallos van a ~/.local/state/eitr/hooks.log. Un fallo nunca detiene la actualización ni el cambio de tema. eitr hook list enumera los hooks; eitr hook run theme-set eitr prueba uno. Las actualizaciones nunca modifican esta carpeta.

cmux TUI

Ejecuta cmux en Kitty o cmux --session work para nombrar la sesión. cmux TUI es opcional junto a tmux; no sustituye Kitty ni sus atajos. Las instalaciones nuevas incluyen un binario oficial con versión fijada en /usr/bin/cmux; instalaciones previas por usuario pueden tener prioridad en PATH. Compruébalo con command -v cmux. Se incluye less para leer salidas y archivos de texto.

El prefijo predeterminado es Ctrl-b: suéltalo y pulsa la siguiente tecla.

Atajo Acción
Ctrl-b ? Mostrar atajos actuales
Ctrl-b W Crear espacio de trabajo
Ctrl-b c Crear pantalla
Ctrl-b % / Ctrl-b " Dividir a la derecha / abajo
Ctrl-b t Nueva pestaña de terminal
Ctrl-b h/j/k/l Enfocar izquierda/abajo/arriba/derecha
Ctrl-b s Mostrar/ocultar barra lateral
Ctrl-b d Salir localmente o desconectar de un servidor

Para que una sesión continúe sin interfaz, ejecuta cmux --headless --session work y después cmux attach --session work para conectarte. Las pestañas de navegador requieren Chrome/Chromium. Cerrar pestañas, paneles o espacios puede afectar a tareas en curso; compruébalo antes. Aprender > Comandos Cmux incluye sesiones, navegación, ratón y atajos de cierre. Los valores predeterminados pueden cambiar o personalizarse: Ctrl-b ? es la referencia actual.

Terminales de tareas

Los terminales abiertos por menús y notificaciones de actualización o informes flotan centrados sobre tus ventanas, con fondo sólido del tema. Las sesiones de asistentes de IA y proyectos LazyVim de Desarrollo se abren como ventanas normales en mosaico, con fondo translúcido, igual que tus terminales. Los terminales normales son interactivos y no llevan marca. Instalación, actualización y configuración muestran el banner rúnico de EITR; las tareas correctas suelen cerrarse y los fallos permanecen visibles hasta cerrarlos. Los informes informativos pueden quedar abiertos. Reiniciar Elephant no debe cerrar aplicaciones lanzadas: las aplicaciones y terminales abiertos desde menús, atajos y botones de la barra usan ámbitos de aplicación separados en una sesión uwsm. Sin uwsm, se inician directamente. Elephant mantiene la terminación solo del proceso para auxiliares del escritorio e inicios sin uwsm.

Pulsa Esc para cerrar los terminales de tareas, cuentas, informes y Acerca de que esperan una tecla. Enter sigue sirviendo para respuestas y confirmaciones, como confirmar que has anotado la clave de recuperación y apagar el instalador.

Historial del shell

history lista comandos recientes. En zsh, comprueba la ruta real con:

printf '%s\n' "$HISTFILE"

Para abrirlo en Neovim:

nvim "$HISTFILE"

El historial puede contener tokens o credenciales: no lo copies en un informe de errores. Cierra otros shells antes de editarlo a mano, pues pueden volver a guardar su historial en memoria. El historial extendido de zsh puede incluir fechas y comandos de varias líneas: elimina la entrada completa, no un fragmento cualquiera. Guarda una copia privada si necesitas deshacerlo.

Apariencia de los editores

Cambiar de tema actualiza las preferencias generadas de VS Code y LazyVim. Las sesiones LazyVim compatibles se actualizan sin reabrirlas. Tus ajustes o plugins pueden elegir colores propios; compruébalos si el editor no sigue al escritorio. La fuente predeterminada se integra solo donde la aplicación lo admite.