equisdots
Menú

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, mpvpaper y la Hack Nerd Font. El conjunto de plugins por defecto también usa cliphist y fd.

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/quickshell para 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 hub plugins) y el conjunto por defecto: screenshots, timex, lector RSS, portapapeles, quicknotes, búsqueda de archivos, sysmon y keybinds.
  • Scripts de envoltura (wrappers) en ~/.local/bin y 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

  1. Reinicie, especialmente si el controlador de NVIDIA cambió.
  2. Elija Hyprland (o Niri) en el gestor de pantalla (SUPER + Return abre kitty, SUPER + D el lanzador).
  3. 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 system primero 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 -1 y reintente ./dots system.
  • Los glifos se ven como cajas: falta la Hack Nerd Font; vuelva a ejecutar ./dots system.
  • No se encuentra dots o davinci: ~/.local/bin no está en PATH (dots doctor lo 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 su compat con dots doctor y recargue con hyprctl reload (o dotsniri deploy en 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.

Editar esta página en GitHub