Resumen/Scripts y CLI
x — herramienta de instalación de niri/equisdots
tools/niri-install.sh es el instalador no interactivo del escritorio
niri/equisdots para X Linux. Se ejecuta como usuario destino (nunca como
root) y delega el stack en el meta instalador oficial
equisdots/niri-meta (dotsniri) en
modo online. El instalador de texto lo selecciona con desktop=niri; no forma
parte de la fase x setup --user.
Qué hace
- Clona o actualiza
equisdots/niri-metaen la caché del usuario ($XDG_CACHE_HOME/x/niri-meta, refmainpor defecto). - Ejecuta
dotsniri setup -y: instala los paquetes del stack niri (niri, xwayland-satellite, quickshell, portales, herramientas de sesión, fuentes, ...), clona los repos propios/compartidos de equisdots, despliega la shell Quickshell compartida, los overlays de niri, plugins, configs de apps, unidades de usuario y la entrada de sesión niri. - Selecciona niri como escritorio por defecto (
dotsniri desktop niri). - Instala el tema SDDM estático de X/equisdots (desde el clon compartido
equisdots/login) y habilitasddm.
Los repos de equisdots son entradas de solo lectura; no se modifica nada de la
org equisdots. La raíz de datos compartida sigue siendo ~/.config/hypr; la
config del compositor niri vive en ~/.config/niri.
Requisito de hardware
niri renderiza mediante EGL/GBM y descarta los renderizadores EGL software.
Necesita una GPU con aceleración hardware real. En una VM, activa la
aceleración 3D (por ejemplo virtio-vga-gl/VirGL); si no, niri arranca sin
renderer y no muestra una salida usable. Hyprland puede usar renderizado
software y seguir funcionando en esa misma VM.
Entorno
| Variable | Default | Significado |
|---|---|---|
X_NIRI_REF | main | Rama/ref de niri-meta a clonar/actualizar. |
X_NIRI_CACHE_DIR | $XDG_CACHE_HOME/x | caché de clones. |
X_NIRI_DRYRUN | 0 | imprime el plan sin tocar el sistema. |
X_NIRI_SKIP_LOGIN | 0 | no instala el tema SDDM ni habilita sddm. |
El instalador de texto crea un %wheel NOPASSWD: ALL temporal durante el
setup, porque dotsniri instala paquetes, PAM, la entrada de sesión y el tema
de login con sudo.
El wrapper instalado es ~/.local/bin/dotsniri; invócalo con la ruta completa
si ~/.local/bin no está en tu PATH.
Validación
bash -n tools/niri-install.sh
X_NIRI_DRYRUN=1 tools/niri-install.sh
niri validate -c ~/.config/niri/config.kdl
~/.local/bin/dotsniri doctor
Ver también
- Selector de escritorio del instalador
hyprland.md— el tool de setup de Hyprland/equisdots.