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) setupPalette
lahabanaX
Saturday, October 03
18°
Partly cloudy
Este sitio usa dos paletas de la colección: X (oscura) y Catppuccin Latte (clara).
Qué lo hace diferente
Repositorios pequeños, un comando, una paleta en todo el escritorio.
- 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.
- 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.
- 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.
- 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.
- 05
Escenas interactivas
Fondos en JavaScript renderizados por el motor de xwww: arte procedural que reacciona a la paleta y al reloj.
- 06
Shell Quickshell
Barra con zonas, editor de ajustes completo, paneles, popups y widgets flotantes de escritorio con redactor visual.
- 07
Un solo comando
dots instala, actualiza y diagnostica todo el stack, desde paquetes y fuentes hasta el tema de login.
- 08
Abierto y documentado
Cada repositorio incluye guías, changelogs y esta documentación estilo wiki que estás leyendo.
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.
- 01
Interfaz
shell · nyx · overlaysUn único árbol Quickshell para ambas sesiones: barra, paneles, editor, bloqueo e isla Nyx.
- 02
Compositor
hyprland · niriHyprland en Lua y niri en KDL tras un backend elegido en ejecución, con overlays reversibles.
- 03
Motores
davinci · theme-sync · timex · xturingFondos, temas entre aplicaciones, hora y clima, y un frontend completo de ajustes en terminal.
- 04
Datos y contenido
palettes · backgroundUn único settings.json, un único almacén de paletas y la colección de fondos y escenas.
- 05
Instalación y sesión
dots · dotsniri · loginDos meta instaladores independientes, temas de login estáticos y la entrada de sesión Wayland.
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
Los widgets, ilustrados
Recreaciones web de las superficies del shell: barra, paneles, selectores y widgets de escritorio.
Islas de la barra
fig. 01Isla Nyx
fig. 0214:32
Saturday, October 03
Palette
Weather
Music
Monitor
Notes
Settings
Selector de paletas
fig. 03Palette
lahabanaX
Panel de plugins
fig. 04Plugins
63 installed● compatibleNyx
shell · mascot island
Screenshots
mixed · capture and record
Timex
mixed · calendar + weather
Keybinds
shell · shortcut editor
Calendario y clima
fig. 05Saturday, October 03
18°
Partly cloudy
Monitor del sistema
fig. 06System Monitor
3d 04hSelector de fondos
fig. 07Wallpaper
DP-1Reproductor de música
fig. 08Midnight Drive
By Neon Runner
SpeakerAjustes en terminal
fig. 09Pages
General
▸ Bar
Theme
Widgets
System
── Style ────────────
Widgets de escritorio
fig. 10Saturday, October 03
Visualizer · Cava
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.
Instalación y actualización
02Interfaz y sesión
06shell
interfaz QuickshellBarra, paneles, popups, editor de ajustes, pantalla de bloqueo y widgets neutrales al compositor.
~/.config/hypr/scripts/quickshellnyx
plugin de mascotasPlugin autocontenido de isla/notch con especies, estados de ánimo, datos en vivo y dock de centro de control.
.../quickshell/ui/plugins/nyxniri-shell
overlay del shellOverlay que añade el backend de niri y sus scripts al shell compartido.
merged into the shellnyx-niri
overlay de nyxAdaptación de la isla Nyx a niri: event stream, sin IPC de cursor y proveedor opcional.
merged into the nyx pluginlogin
greeter SDDMTema SDDM estático y monocromo con selector de sesión, acciones de energía y sin sudo en ejecución.
/usr/share/sddm/themes/xniri-login
entrada de sesiónInstala la entrada de sesión Wayland de Niri para que los gestores de pantalla la listen.
/usr/share/wayland-sessions/niri.desktop
Compositores
02Motores y herramientas
04davinci
kernel de fondosKernel de fondos sin interfaz: imágenes, vídeo, presentación, buscadores y escenas interactivas.
~/.local/bin/davincitheme-sync
motor de temasRegenera kitty, starship, nvim, VS Code, navegadores, rofi, cava, Qt y GTK desde una paleta.
~/.local/bin/theme-synctimex
plugin de hora y climaMotor meteorológico con proveedores, panel de calendario, isla de barra y caras de widget del clima.
.../quickshell/ui/plugins/timexxturing
ajustes en terminalTUI Rust/ratatui que expone todos los ajustes con búsqueda, ratón y grabación de atajos.
~/.local/bin/xturing
Datos y contenido
02Sistema de plugins
04plugin-api
contrato de pluginsEsquema normativo del manifiesto, versión de la API y evaluadores de compatibilidad en bash/Lua.
.../quickshell/plugin-api.jsonplugin-sdk
SDK de pluginsKit de ejecución: PluginHost, Settings reactivos, superficies, kit de widgets y API Lua mod.
.../quickshell/core/sdkplugins
hub de pluginsEl estándar, la carpeta con los 63 plugins, el registro de instalación y las pruebas de humo.
.../quickshell/ui/plugins/<id>transformpath
mapa de arquitecturaNotas de arquitectura, registro de decisiones y estado de la migración al sistema de plugins.
documentation · no payload
Sitio y comunidad
02Empieza
Empieza por la documentación
Instalación, actualizaciones, configuración de los compositores, plugins, fondos, escenas y temas, en inglés y español.