Actualización y diagnóstico
Cómo dots update, list, doctor y uninstall mantienen la pila sincronizada y cómo corregir los fallos más comunes.
dots gestiona toda la pila desde un único comando. Actualizar descarga todos
los repositorios, vuelve a desplegar la carga útil y mantiene el demonio de
fondos de pantalla alineado con la versión fijada. El diagnóstico es una pasada
independiente de solo lectura que indica qué falta o está desincronizado.
Referencia de comandos
| Comando | Acción |
|---|---|
dots install |
Clonar o actualizar cada repositorio y colocar su carga útil. |
dots update |
dots install más la comprobación de la versión de xwww. |
dots system |
Ejecutar el instalador de hyprland (paquetes, fuentes, login, PAM, requiere sudo). |
dots doctor |
Comprobar binarios, clones y rutas instaladas. Termina con código distinto de cero si falla. |
dots list |
Estado de los repositorios: clean, dirty o missing. |
dots plugins |
Plugins instalados; subcomandos available, add, remove, enable, disable. |
dots reset |
Reinstalación limpia forzada de la carga útil (los datos de usuario se conservan). |
dots uninstall |
Eliminar los wrappers y el temporizador de actualización; las configuraciones y los clones permanecen. |
dots update
dots doctor
dots list
El stack de niri (dotsniri)
La sesión de niri tiene su propio meta instalador, dotsniri, paralelo a
dots. Usa una raíz de clones aparte (~/.local/share/equisdots-niri) y nunca
toca una instalación de dots en paralelo, así que los dos stacks conviven en
una máquina.
| Comando | Acción |
|---|---|
dotsniri install |
Clonar/actualizar y desplegar el stack de niri (repos propios + shell/nyx compartidos). |
dotsniri update |
Descargar los repos propios más las bases compartidas shell/nyx y volver a desplegar. |
dotsniri deploy |
Volver a desplegar desde los clones existentes (reaplica los overlays tras un dots update). |
dotsniri desktop <niri|hyprland|both> |
Fijar la sesión por defecto y aplicar o retirar los overlays del shell. |
dotsniri login <install|remove|status> |
Gestionar la entrada de sesión del gestor de pantalla (vía niri-login, sudo). |
dotsniri system [--apply] |
Instalar paquetes de la distro (niri, portales, ...). |
dotsniri doctor |
Comprobar binarios, clones, deploy, el backend del shell y niri validate. |
dotsniri doctor --self-test |
Comprobar la sintaxis del toolkit; funciona sin niri. |
dotsniri plugins [list|available|add|remove|enable|disable] |
Gestionar el conjunto de plugins con paridad con dots plugins. |
dotsniri reset |
Reinstalación limpia forzada del deploy de niri (elimina los clones propios). |
bash <(curl -fsSL https://raw.githubusercontent.com/equisdots/niri-meta/main/bin/dotsniri) install
dotsniri doctor
dotsniri desktop niri
Los overlays del shell son condicionales y reversibles: un archivo compartido
solo se reemplaza por su variante niri mientras se selecciona la sesión niri, y
dotsniri deploy los reaplica cuando dots update reescribe el shell. Ver
Compositor niri.
Qué hace dots update
Para cada repositorio de la organización (dots, palettes, theme-sync,
davinci, shell, nyx, hyprland, timex, xturing, login, además del
estándar de plugins y las fuentes de los plugins por defecto):
- Descarga
origin/maincon profundidad 1 y restablece por la fuerza el clon gestionado a esa versión. El restablecimiento forzado también recupera de los force-push ascendentes, donde un pull de avance rápido fallaría siempre. - Si
dotscambió durante la descarga, el script se vuelve a ejecutar con la nueva versión antes de tocar ninguna carga útil. - Despliega la carga útil de ese repositorio, omitiendo los clones con cambios locales.
Tras la fase de carga útil, dots update compara el binario xwww en
ejecución con la versión fijada en scripts/install-xwww.sh y reinstala cuando
difieren (XWWW_VERSION anula la versión fijada). También escribe el estado de
versión que usan la página Acerca de y el emergente del actualizador.
Los plugins por defecto se vuelven a desplegar mediante la convención del
registro sin escribir sus interruptores, así que los usuarios existentes
conservan las funciones. Los plugins de usuario en
~/.config/hypr/plugins-user/ nunca se tocan, y un plugin con compat
incumplido no se monta. Actualice o añada un plugin concreto con
dots plugins add <id> (o el panel de Plugins); ver
Plugins y extensiones.
Cambios locales en clones gestionados
Los clones gestionados son de solo lectura desde el punto de vista de dots.
Un clon con cambios sin confirmar se conserva exactamente como está y su carga
útil no se despliega, de modo que una copia obsoleta nunca puede degradar
ni eliminar archivos activos.
dots list # shows dirty clones
git -C ~/.local/share/equisdots/shell status
Reconcilie confirmando o guardando los cambios, o apartando el clon:
mv ~/.local/share/equisdots/shell{,.local}
dots install
dots doctor señala cada clon sucio para que las actualizaciones no se detengan
en silencio.
Reinstalación forzada con dots reset
dots reset es la salida de emergencia para una instalación rota: elimina los
archivos gestionados (configuración/scripts de Hyprland, shell, configuraciones
de aplicaciones) y los clones gestionados, reinstala todo desde el último
origin/main y vuelve a aplicar la paleta activa. Nunca toca sus datos:
settings.json, los overrides de config/, wallpapers/, el almacén de
paletas (dock/palettes, incluidos los cambios de la comunidad y del editor),
display-config, idle-settings.json y las instantáneas
hyprland-backup-* sobreviven. También es la forma de recuperar clones
gestionados sucios que bloquean su carga útil durante update/install. La
pila del sistema (sudo) queda fuera: ejecute dots system para paquetes,
fuentes, tema de login y PAM.
dots install, dots update y dots reset normalizan un ~ inicial en
wallpaperDir de settings.json a una ruta absoluta, para que el selector de
fondos siempre encuentre la colección (un ~ literal dejaba la rejilla vacía y
hacía fallar cada aplicación con File not found).
Reglas de combinación de settings.json
dots install nunca sobrescribe sus ajustes. El archivo se siembra desde
default_settings.json solo cuando falta, y en cada actualización se reescribe
como valores predeterminados distribuidos más sus valores con jq:
- El objeto
dockanterior a equisdots se migra a la clave canónicabar. - Se eliminan las claves heredadas que ya no lee nadie.
- Los valores predeterminados distribuidos se aplican como base; sus valores
ganan, y los arrays de usuario como
bar.zonesse conservan tal cual.
Si la combinación falla, el archivo se deja intacto y dots imprime una
advertencia.
El temporizador mensual de actualización
dots install registra un temporizador de usuario de systemd que ejecuta la
actualización de los dotfiles mensualmente:
systemctl --user status dotfiles-update.timer
systemctl --user list-timers dotfiles-update.timer
dots uninstall elimina el temporizador y los wrappers. El servicio apunta a
~/.config/hypr/scripts/dotfiles-update.sh; dots doctor avisa cuando la
unidad apunta a otro sitio.
Comprobaciones de dots doctor
El doctor es el primer diagnóstico que debe ejecutar. Informa, en orden:
- Binarios requeridos:
git,rsync,hyprland,qs,jq,curl,python3,cava,playerctl,wl-paste,cliphist,brightnessctl,pamixer,kitty,rofi,xwww-daemon,mpvpaper. - Binarios opcionales:
grim,slurp,satty,hyprpicker,blueman-applet,nm-applet,gsettings,cargo. - Comprobación de fuentes mediante
fc-match "Hack Nerd Font". - La versión de
xwwwen ejecución frente a la versión fijada. - Clones de repositorios y clones con cambios.
- El registro de plugins: ids duplicados, desajustes carpeta/manifiesto y colisiones en ejecución.
- Rutas de la carga útil instalada (paletas,
hyprland.lua,Shell.qml, wrappers,settings.jsony más). - Versión de Hyprland (se requiere 0.55+ para Lua) y
~/.local/binenPATH. - Piezas del sistema:
/etc/pam.d/quickshell, la configuración del tema SDDM, el tema estático y el gestor de pantalla activo. - El temporizador mensual de actualización.
dots doctor; echo "exit: $?"
El comando termina con 1 cuando al menos un elemento ha fallado, lo que lo
hace utilizable en scripts.
Solución de problemas
- La actualización informa de
local changes; skipping its payload(cambios locales; se omite su carga útil): reconcilie el clon como se muestra arriba y vuelva a ejecutardots update. - Fallo en la descarga (red): la copia existente se conserva y el resto de la actualización continúa; reintente más tarde.
settings.json could not be migrated(no se pudo migrar settings.json): consulte la advertencia; el archivo está intacto. Compruebe quejqestá instalado.hyprland < 0.55: actualice el paquete del compositor; la configuración Lua necesita soporte de Lua.- Discrepancia de xwww:
dots update(oscripts/install-xwww.sh) reinstala la versión fijada. - Un plugin aparece listado pero no se monta: compruebe en
dots doctoruna violación decompato una colisión de id y usedots plugins add <id> --forcesolo si el desajuste es intencionado. - El gestor de pantalla activo no es SDDM: el tema de inicio de sesión estático
no se mostrará;
dots systemcambia el enlace del gestor de pantalla. - Fallo en la fase de sistema: inspeccione el registro más reciente con
ls -t /tmp/hyprland-install-*.log | head -1.
Páginas relacionadas
- Instalación para la primera configuración.
- Arquitectura y repositorios para el diseño de la instalación y los contratos.
- Contribución y seguridad para notificar problemas.