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.