equisdots

equisdots · X Linux


equisdots

El escritorio X: un stack sobre Arch con Hyprland en la era Lua y un port a niri, un shell Quickshell neutral al compositor, un estándar de 63 plugins, un motor de paletas en vivo y un kernel de fondos con escenas interactivas.

bash <(curl -fsSL https://raw.githubusercontent.com/equisdots/dots/main/dots) setup
2
14:32:07
18%42%86%

Palette

lahabana
Filter palettes

X

Lahabana
Tokio
Bogota
Madrid
Helsinki
Paris
Miami
Oslo
Praha
14:32:07

Saturday, October 03

‹OCTOBER 2026›
MTWTFSS
282930123456789101112131415161718192021222324252627282930311

18°

Partly cloudy

1519°
1818°
2116°
0014°
Superficies del shell · barra, paleta y timexfig. 01

Este sitio usa dos paletas de la colección: X (oscura) y Catppuccin Latte (clara).

01Claves

Qué lo hace diferente

Repositorios pequeños, un comando, una paleta en todo el escritorio.

  1. 01

    Hyprland, era Lua

    Configuración del compositor escrita contra la API Lua (0.55+), dividida en módulos reutilizables para atajos, reglas, animaciones y colores.

  2. 02

    niri, también

    El mismo escritorio corre también sobre niri: el shell, las paletas, los widgets y la mascota Nyx son compartidos, y un meta aparte, dotsniri, gestiona el stack de niri.

  3. 03

    63 plugins, un estándar

    Funciones autocontenidas declaran plugin.json, traen su propia página de ajustes, módulos de barra y paneles, y se descubren por carpeta. dots las instala, activa y actualiza sin tocar el núcleo.

  4. 04

    Motor de paletas en vivo

    Paletas base16 con roles semánticos: cambiar una recolorea la barra, los bordes de ventana, los widgets y las escenas activas sin recargar.

  5. 05

    Escenas interactivas

    Fondos en JavaScript renderizados por el motor de xwww: arte procedural que reacciona a la paleta y al reloj.

  6. 06

    Shell Quickshell

    Barra con zonas, editor de ajustes completo, paneles, popups y widgets flotantes de escritorio con redactor visual.

  7. 07

    Un solo comando

    dots instala, actualiza y diagnostica todo el stack, desde paquetes y fuentes hasta el tema de login.

  8. 08

    Abierto y documentado

    Cada repositorio incluye guías, changelogs y esta documentación estilo wiki que estás leyendo.

02Stack

Un escritorio, construido por capas

Cinco capas con un contrato claro cada una: instalación, datos, motores, compositor e interfaz. El sistema de plugins se sienta al lado y extiende cada superficie sin bifurcar el núcleo.

0504030201PLUGINS
Mapa isométrico del stackriel lateral · sistema de plugins
  1. 01

    Interfaz

    shell · nyx · overlays

    Un único árbol Quickshell para ambas sesiones: barra, paneles, editor, bloqueo e isla Nyx.

  2. 02

    Compositor

    hyprland · niri

    Hyprland en Lua y niri en KDL tras un backend elegido en ejecución, con overlays reversibles.

  3. 03

    Motores

    davinci · theme-sync · timex · xturing

    Fondos, temas entre aplicaciones, hora y clima, y un frontend completo de ajustes en terminal.

  4. 04

    Datos y contenido

    palettes · background

    Un único settings.json, un único almacén de paletas y la colección de fondos y escenas.

  5. 05

    Instalación y sesión

    dots · dotsniri · login

    Dos meta instaladores independientes, temas de login estáticos y la entrada de sesión Wayland.

03Flujos

Cómo se mueven las piezas

Cuatro recorridos explican el escritorio: una paleta lo recolorea todo, un kernel gobierna cada fondo, un manifiesto extiende cada superficie y un shell corre en ambos compositores.

Una paleta, todas las superficies

settings.json elige un slug; el almacén de paletas alimenta el shell, los bordes de ventana, theme-sync y las escenas activas.

  • settings.jsonbar.palette
  • palettes/*.jsonbase16 + roles
  • shell + bordesbarra, paneles, marcos
  • theme-synckitty, nvim, gtk…
  • escenas xwwwproveedor de paleta

Un kernel, cada fondo

davinci resuelve un archivo, URL o directorio de escena, elige xwww o mpvpaper y refresca la caché de bloqueo.

  • davinciarchivo · url · escena
  • xwwwimagen + escena JS
  • mpvpapervídeo
  • superficiela pantalla
  • bloqueo · SDDMcurrent_wallpaper.png

Un manifiesto, todas las superficies

Un plugin.json se descubre, se comprueba su compatibilidad y lo montan hosts genéricos; el plugin posee su UI.

  • plugin.jsonid + provides
  • escanear carpetasgana el usuario
  • activar · compatapi 1.0.0
  • hosts genéricosPluginHosts
  • superficies UIpaneles · barras · ajustes

Un shell, dos compositores

La sesión elige el backend en ejecución; barra, paneles, widgets y Nyx consumen la misma superficie del adaptador en Hyprland y niri.

  • sesiónXDG_CURRENT_DESKTOP
  • Compositor.qmlbackend en ejecución
  • HyprlandLua · hyprctl
  • niriKDL · niri msg
  • shell compartidomismos widgets
04Widgets

Los widgets, ilustrados

Recreaciones web de las superficies del shell: barra, paneles, selectores y widgets de escritorio.

Islas de la barra

fig. 01
2
14:32:07
18%42%86%
Islas flotantes para espacios, reloj y estado; tintadas con la paleta y compatibles con blur.

Isla Nyx

fig. 02
14:3218°42%
⌕Search widgets, actions…⌘K

14:32

Saturday, October 03

22°
◐

Palette

☼

Weather

♫

Music

▤

Monitor

▦

Notes

⚙

Settings

FavoritesAll2 / 5
Isla de mascotas que se despliega en un centro de control: especies, datos en vivo y acciones rápidas.

Selector de paletas

fig. 03

Palette

lahabana
Filter palettes

X

Lahabana
Tokio
Bogota
Madrid
Helsinki
Paris
Miami
Oslo
Praha
Cambia la paleta de todo el escritorio sin abrir el editor de ajustes.

Panel de plugins

fig. 04

Plugins

63 installed● compatible
⌕Filter pluginsallonoff
✕

Nyx

shell · mascot island

▣

Screenshots

mixed · capture and record

◷

Timex

mixed · calendar + weather

⌘

Keybinds

shell · shortcut editor

4 enabled59 availableregistry v1
63 plugins, cada uno con su interruptor, página de ajustes y superficie de atajos.

Calendario y clima

fig. 05
14:32:07

Saturday, October 03

‹OCTOBER 2026›
MTWTFSS
282930123456789101112131415161718192021222324252627282930311

18°

Partly cloudy

1519°
1818°
2116°
0014°
Reloj, rejilla mensual y previsión en un popup, alimentado por la caché local.

Monitor del sistema

fig. 06

System Monitor

3d 04h
CPU62%
RAM48%
Disk71%
GPU35%
C0
C1
C2
C3
C4
C5
C6
C7
54°C312 procs16 threads
CPU, memoria, discos y GPU con detalle por núcleo.

Selector de fondos

fig. 07

Wallpaper

DP-1
AllVidFav6 items
JS
Imágenes, vídeo y escenas interactivas con transiciones de entrada.

Reproductor de música

fig. 08

Midnight Drive

By Neon Runner

Speaker
01:2403:58
Carátula, progreso y espectro en vivo desde la instancia compartida de Cava.

Ajustes en terminal

fig. 09
xturingbarsettings.json

Pages

General

▸ Bar

Theme

Widgets

System

◈ d_stylealign=start● saved

── Style ────────────

Preset‹ modular ›
▸Thickness[-] 48 [+]
Roundness1.0
Opacity85%
↑↓ move · ←→ adjust? help
Todo el panel de ajustes en una TUI ratatui, manejable con teclado y ratón.

Widgets de escritorio

fig. 10
14:32:07

Saturday, October 03

22°Clear

Visualizer · Cava

Tarjetas de reloj, clima y visualizador colocables en cualquier sitio, editadas con el redactor.
05Repositorios

Todos los repositorios, ilustrados

Los 22 repositorios de la organización, agrupados por la capa que poseen. Cada tarjeta enlaza a su código y muestra dónde aterriza su payload.

22 repos7 layers63 plugins

Empieza

Empieza por la documentación

Instalación, actualizaciones, configuración de los compositores, plugins, fondos, escenas y temas, en inglés y español.