Instalación
Requisitos y la forma recomendada de instalar el escritorio equisdots, además del primer inicio de sesión y la solución de problemas.
La forma recomendada de instalar equisdots es el meta instalador dots. Una
única ejecución de setup instala las piezas del sistema (paquetes, fuentes,
tema de inicio de sesión, servicio PAM, configuraciones externas) y la carga
útil de usuario (configuración del compositor, shell, paletas, motores) de
todos los repositorios.
Requisitos
- Arch Linux o una derivada (EndeavourOS, Manjaro, CachyOS, Garuda).
- Linux 6.x o posterior recomendado, 4 GB de RAM mínimo, 8 GB recomendado.
- Hyprland 0.55 o posterior (la configuración es Lua), o niri 26.04 o posterior para la sesión de niri.
git,rsync,jq, Quickshell (qs),xwww-daemon,mpvpapery la Hack Nerd Font. El conjunto de plugins por defecto también usacliphistyfd.
dots doctor comprueba todo esto y termina con un código de error cuando falta
algo; el paquete completo de fondos de pantalla es opcional y ocupa unos
1,37 GB.
Instalación con un solo comando
El instalador clona toda la organización por sí mismo; no se necesita ningún clon previo:
bash <(curl -fsSL https://raw.githubusercontent.com/equisdots/dots/main/dots) setup -y
El indicador -y responde a las preguntas con los valores predeterminados
recomendados y omite el paquete de fondos de pantalla. Tras la primera
ejecución, el comando dots está disponible en ~/.local/bin/dots.
Instalación manual
Paso a paso, desde un clon del repositorio dots:
git clone https://github.com/equisdots/dots.git
cd dots
./dots system # system stack (sudo): packages, fonts, login, PAM, xwww
./dots install # clone every repo and place the user payload
./dots doctor # verify binaries, clones and installed paths
Prefiera setup cuando sea posible; ejecuta ambas fases en el orden correcto:
./dots setup # payload first when git/rsync exist, then the system stack
./dots setup -y # non-interactive with defaults
Si falta git o rsync, setup ejecuta primero la pila del sistema (los
instala) y después reintenta la carga útil. Un fallo en la fase de sistema
nunca aborta la fase de carga útil, y viceversa.
Qué hace cada fase
dots system ejecuta el instalador de
hyprland:
- Instala paquetes de la distribución mediante un ayudante de AUR (Hyprland, Quickshell, kitty, dunst, grim, slurp, cliphist, rofi, cava, gpu-screen-recorder y más), además de la Hack Nerd Font y temas (adw-gtk3, Papirus, Bibata).
- Instala el demonio de fondos de pantalla xwww desde la versión precompilada verificada por suma de comprobación, con compilación desde el código fuente como alternativa.
- Instala el tema SDDM estático de equisdots/login.
- Instala
/etc/pam.d/quickshellpara la pantalla de bloqueo y las configuraciones de kitty, Neovim y starship. - Configura NVIDIA cuando corresponde, incluidos los parámetros del kernel.
dots install clona cada repositorio en ~/.local/share/equisdots y coloca la
carga útil:
- Configuración de Hyprland en
~/.config/hypr, más las configuraciones de rofi, dunst y cava. - Shell Quickshell, la isla de mascotas Nyx, paletas, theme-sync, davinci, timex y xturing.
- El estándar de plugins (
plugin-api,plugin-sdk, el hubplugins) y el conjunto por defecto: screenshots, timex, lector RSS, portapapeles, quicknotes, búsqueda de archivos, sysmon y keybinds. - Scripts de envoltura (wrappers) en
~/.local/biny el temporizador de actualización mensual.
install copia sobre una configuración activa, pero trata settings.json con
cuidado: solo se siembra cuando falta y después siempre se combina como valores
predeterminados más sus valores. Para un purgado completo debe eliminar
~/.config/hypr usted mismo.
Instalación independiente de Hyprland
Sin el meta instalador:
git clone https://github.com/equisdots/hyprland.git
cd hyprland
chmod +x install.sh
./install.sh # full install
./install.sh --dotfiles-only # config only, no packages
./install.sh --nvidia-only # NVIDIA setup only
./install.sh -y # non-interactive defaults
El instalador independiente omite el paso que llama a dots install cuando lo
dirige dots system (DOTS_SYSTEM_RUN=1), porque el meta instalador ejecuta
la carga útil justo después.
Demonio de fondos de pantalla
El instalador fija una versión de xwww. Anúlela cuando sea necesario:
XWWW_VERSION=v0.13.2 ./scripts/install-xwww.sh
FORCE_XWWW=1 ./install.sh # reinstall an existing binary
La sesión de niri (dotsniri)
El mismo escritorio corre sobre el compositor niri.
El stack de niri tiene su propio meta instalador, dotsniri, separado de dots
y con su propia raíz de clones (~/.local/share/equisdots-niri), así que una
instalación de dots en paralelo nunca se modifica:
bash <(curl -fsSL https://raw.githubusercontent.com/equisdots/niri-meta/main/bin/dotsniri) install
dotsniri doctor # check binaries, clones, deploy and config
dotsniri desktop niri # select niri as the default session
dotsniri despliega la configuración del compositor niri (~/.config/niri),
los overlays del shell que hacen neutral al compositor la interfaz Quickshell
compartida, el estándar de plugins y su conjunto por defecto, y la entrada de
sesión del gestor de pantalla. Reutiliza la raíz compartida: settings.json,
paletas, fondos y el shell permanecen en ~/.config/hypr, así que Hyprland y
niri corren en paralelo desde una única configuración. Ver
Compositor niri para el panorama completo.
Instalar y gestionar plugins
dots install despliega los plugins por defecto mediante la convención del
registro sin escribir interruptores, así que los usuarios existentes conservan
las funciones. Desde la CLI:
dots plugins # plugins instalados y su estado
dots plugins available # el registro: instalados vs disponibles
dots plugins add <id> # descarga, despliega por convención y activa
dots plugins add <id> --no-enable --force
dots plugins remove <id>
dots plugins enable <id>
dots plugins disable <id>
El panel de Plugins (SUPER + SHIFT + M) hace lo mismo desde la UI: cada plugin
instalado tiene un interruptor maestro y un acceso Configure cuando trae página
de ajustes. El hub de 63 plugins y el estándar se documentan en
Plugins y extensiones.
Verificar la instalación
dots doctor
dots list
dots plugins
command -v dots hyprland qs davinci theme-sync
fc-match "Hack Nerd Font"
dots list debe informar de cada repositorio como clean, y dots doctor
debe terminar sin elementos faltantes. Cada línea ! indica lo que requiere
atención.
Primer inicio de sesión
- Reinicie, especialmente si el controlador de NVIDIA cambió.
- Elija Hyprland (o Niri) en el gestor de pantalla (
SUPER + Returnabre kitty,SUPER + Del lanzador). - El primer arranque inicializa el demonio de fondos de pantalla, elige un fondo de pantalla aleatorio e inicia los servicios en segundo plano.
Solución de problemas
git/rsync missing: ejecute./dots systemprimero y luego./dots install.- Fallo al clonar: compruebe la red y vuelva a ejecutar
./dots install. Los fallos nunca son fatales para los demás repositorios. - Fallo en la fase de sistema: la carga útil se instala igualmente. Inspeccione
ls -t /tmp/hyprland-install-*.log | head -1y reintente./dots system. - Los glifos se ven como cajas: falta la Hack Nerd Font; vuelva a ejecutar
./dots system. - No se encuentra
dotsodavinci:~/.local/binno está enPATH(dots doctorlo señala). - Discrepancia de versión de xwww: ejecute
./dots update, que reinstala la versión fijada cuando el binario en ejecución difiere. - Un plugin no aparece: compruebe
dots plugins, verifique sucompatcondots doctory recargue conhyprctl reload(odotsniri deployen niri).
Desinstalación
./dots uninstall # removes wrappers and the updater timer
./hyprland/uninstall.sh # removes deployed configs (standalone installer)
dots uninstall conserva los archivos de configuración y los clones
gestionados; el tema de inicio de sesión tiene su propio
./install.sh --uninstall en
equisdots/login.
Siguientes pasos
Lea Actualización y diagnóstico para mantener la instalación sincronizada y después Escritorio Hyprland o Compositor niri para la superficie de configuración, y Plugins y extensiones para la capa de extensión.