equisdots · X Linux
equisdots
The X desktop: an Arch-based stack with Hyprland in the Lua era and a niri port, a compositor-neutral Quickshell shell, a 63-plugin standard, a live palette engine and a wallpaper kernel with interactive scenes.
bash <(curl -fsSL https://raw.githubusercontent.com/equisdots/dots/main/dots) setupPalette
lahabanaX
Saturday, October 03
18°
Partly cloudy
This site uses two palettes from the collection: X (dark) and Catppuccin Latte (light).
What makes it different
Small repositories, one command, one palette across the whole desktop.
- 01
Hyprland, Lua era
Compositor configuration written against the Lua API (0.55+), split into reusable modules for keybinds, rules, animations and colors.
- 02
niri, too
The same desktop also runs on niri: the shell, palettes, widgets and the Nyx mascot are shared, and a separate dotsniri meta manages the niri stack.
- 03
63 plugins, one standard
Self-contained features declare plugin.json, ship their own settings pages, bar modules and panels, and are discovered by folder. dots installs, toggles and updates them without touching the core.
- 04
Live palette engine
base16 palettes with semantic roles: switching one recolors the bar, window borders, widgets and running scenes without a reload.
- 05
Interactive scenes
JavaScript wallpapers rendered by the xwww engine: procedural art that reacts to the palette and the clock.
- 06
Quickshell shell
Bar with zones, a full settings editor, panels, popups and floating desktop widgets with a visual redactor.
- 07
One command
dots installs, updates and diagnoses the whole stack, from packages and fonts to the login theme.
- 08
Open and documented
Every repository ships guides, changelogs and a wiki-style documentation site you are reading now.
One desktop, built in layers
Five layers with a single contract each: install, data, engines, compositor and interface. The plugin system sits beside them and extends every surface without forking the core.
- 01
Interface
shell · nyx · overlaysOne Quickshell tree for both sessions: bar, panels, editor, lock screen and the Nyx island.
- 02
Compositor
hyprland · niriLua Hyprland and KDL niri behind a runtime-selected backend, with reversible overlays.
- 03
Engines
davinci · theme-sync · timex · xturingWallpapers, cross-app theming, time and weather, and a complete terminal settings frontend.
- 04
Data and content
palettes · backgroundOne settings file, one palette store and the wallpaper plus scene collection.
- 05
Install and session
dots · dotsniri · loginTwo independent meta installers, static login themes and the Wayland session entry.
How the pieces move
Four paths explain the desktop: one palette recolors everything, one kernel drives every wallpaper, one manifest extends every surface, and one shell runs on both compositors.
One palette, every surface
settings.json selects a slug; the palette store feeds the shell, window borders, theme-sync and running scenes.
- settings.jsonbar.palette
- palettes/*.jsonbase16 + roles
- shell + bordersbar, panels, frames
- theme-synckitty, nvim, gtk…
- xwww scenespalette provider
One kernel, every wallpaper
davinci resolves a file, URL or scene directory, picks xwww or mpvpaper, and refreshes the lock-screen cache.
- davincifile · url · scene
- xwwwstill + JS scene
- mpvpapervideo
- layer surfacethe screen
- lock · SDDMcurrent_wallpaper.png
One manifest, every surface
A plugin.json is discovered, compatibility-checked and mounted by the generic hosts; the plugin owns its UI.
- plugin.jsonid + provides
- scan foldersuser wins
- enable · compatapi 1.0.0
- generic hostsPluginHosts
- UI surfacespanels · bars · settings
One shell, two compositors
The session selects the backend at runtime; the bar, panels, widgets and Nyx consume the same adapter surface on Hyprland and niri.
- sessionXDG_CURRENT_DESKTOP
- Compositor.qmlruntime backend
- HyprlandLua · hyprctl
- niriKDL · niri msg
- shared shellsame widgets
The widgets, illustrated
Web recreations of the shell surfaces: bar, panels, pickers and desktop widgets.
Bar islands
fig. 01Nyx island
fig. 0214:32
Saturday, October 03
Palette
Weather
Music
Monitor
Notes
Settings
Palette switcher
fig. 03Palette
lahabanaX
Plugins panel
fig. 04Plugins
63 installed● compatibleNyx
shell · mascot island
Screenshots
mixed · capture and record
Timex
mixed · calendar + weather
Keybinds
shell · shortcut editor
Calendar and weather
fig. 05Saturday, October 03
18°
Partly cloudy
System monitor
fig. 06System Monitor
3d 04hWallpaper picker
fig. 07Wallpaper
DP-1Music player
fig. 08Midnight Drive
By Neon Runner
SpeakerTerminal settings
fig. 09Pages
General
▸ Bar
Theme
Widgets
System
── Style ────────────
Desktop widgets
fig. 10Saturday, October 03
Visualizer · Cava
Every repository, illustrated
All 22 repositories of the organization, grouped by the layer they own. Each card links to its source and shows where its payload lands.
Install and update
02Interface and session
06shell
Quickshell UICompositor-neutral bar, panels, popups, settings editor, lock screen and desktop widgets.
~/.config/hypr/scripts/quickshellnyx
mascot pluginSelf-contained island/notch plugin with species, moods, live stats and a control-center dock.
.../quickshell/ui/plugins/nyxniri-shell
shell overlayOverlay that adds the Niri compositor backend and the niri scripts to the shared shell.
merged into the shellnyx-niri
nyx overlayGraceful niri adaptation of the Nyx island: event stream, no cursor IPC, optional provider.
merged into the nyx pluginlogin
SDDM greeterMonochrome static SDDM theme with session picker, power actions and no runtime sudo.
/usr/share/sddm/themes/xniri-login
session entryInstalls the Niri Wayland session entry so display managers list it at login.
/usr/share/wayland-sessions/niri.desktop
Compositors
02Engines and tools
04davinci
wallpaper kernelHeadless wallpaper kernel: stills, video, slideshow, search providers and interactive scenes.
~/.local/bin/davincitheme-sync
theming engineRegenerates kitty, starship, nvim, VS Code, browsers, rofi, cava, Qt and GTK from one palette.
~/.local/bin/theme-synctimex
time & weather pluginProvider-driven weather engine plus the calendar panel, bar island and weather widget faces.
.../quickshell/ui/plugins/timexxturing
terminal settings UIRust/ratatui TUI that exposes every settings option with search, mouse and shortcut recording.
~/.local/bin/xturing
Data and content
02Plugin system
04plugin-api
plugin contractNormative manifest schema, host API version and the bash/Lua compatibility evaluators.
.../quickshell/plugin-api.jsonplugin-sdk
plugin SDKRuntime kit: PluginHost, reactive Settings, surfaces, widget kit and the Lua mod API.
.../quickshell/core/sdkplugins
plugin hubThe standard, the 63-plugin concentration folder, the install registry and smoke tests.
.../quickshell/ui/plugins/<id>transformpath
architecture mapArchitecture notes, decision log and live status of the plugin system migration.
documentation · no payload
Get started
Start with the documentation
Installation, updates, compositor configuration, plugins, wallpapers, scenes and theming, in English and Spanish.