equisdots

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) 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°
Shell surfaces · bar, palette and timexfig. 01

This site uses two palettes from the collection: X (dark) and Catppuccin Latte (light).

01Highlights

What makes it different

Small repositories, one command, one palette across the whole desktop.

  1. 01

    Hyprland, Lua era

    Compositor configuration written against the Lua API (0.55+), split into reusable modules for keybinds, rules, animations and colors.

  2. 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.

  3. 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.

  4. 04

    Live palette engine

    base16 palettes with semantic roles: switching one recolors the bar, window borders, widgets and running scenes without a reload.

  5. 05

    Interactive scenes

    JavaScript wallpapers rendered by the xwww engine: procedural art that reacts to the palette and the clock.

  6. 06

    Quickshell shell

    Bar with zones, a full settings editor, panels, popups and floating desktop widgets with a visual redactor.

  7. 07

    One command

    dots installs, updates and diagnoses the whole stack, from packages and fonts to the login theme.

  8. 08

    Open and documented

    Every repository ships guides, changelogs and a wiki-style documentation site you are reading now.

02Stack

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.

0504030201PLUGINS
Isometric stack mapside rail · plugin system
  1. 01

    Interface

    shell · nyx · overlays

    One Quickshell tree for both sessions: bar, panels, editor, lock screen and the Nyx island.

  2. 02

    Compositor

    hyprland · niri

    Lua Hyprland and KDL niri behind a runtime-selected backend, with reversible overlays.

  3. 03

    Engines

    davinci · theme-sync · timex · xturing

    Wallpapers, cross-app theming, time and weather, and a complete terminal settings frontend.

  4. 04

    Data and content

    palettes · background

    One settings file, one palette store and the wallpaper plus scene collection.

  5. 05

    Install and session

    dots · dotsniri · login

    Two independent meta installers, static login themes and the Wayland session entry.

03Flows

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
04Widgets

The widgets, illustrated

Web recreations of the shell surfaces: bar, panels, pickers and desktop widgets.

Bar islands

fig. 01
2
14:32:07
18%42%86%
Floating islands for workspaces, clock and status; palette-tinted, blur-aware.

Nyx island

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

14:32

Saturday, October 03

22°
◐

Palette

☼

Weather

♫

Music

▤

Monitor

▦

Notes

⚙

Settings

FavoritesAll2 / 5
Mascot island that unfolds into a control center: species, live stats and quick actions.

Palette switcher

fig. 03

Palette

lahabana
Filter palettes

X

Lahabana
Tokio
Bogota
Madrid
Helsinki
Paris
Miami
Oslo
Praha
Switch the whole desktop palette without opening the settings editor.

Plugins panel

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, each with its own switch, settings page and keybind surface.

Calendar and weather

fig. 05
14:32:07

Saturday, October 03

‹OCTOBER 2026›
MTWTFSS
282930123456789101112131415161718192021222324252627282930311

18°

Partly cloudy

1519°
1818°
2116°
0014°
Clock, month grid and forecast in one popup, fed by the local weather cache.

System monitor

fig. 06

System Monitor

3d 04h
CPU62%
RAM48%
Disk71%
GPU35%
C0
C1
C2
C3
C4
C5
C6
C7
54°C312 procs16 threads
CPU, memory, disks and GPU with per-core detail.

Wallpaper picker

fig. 07

Wallpaper

DP-1
AllVidFav6 items
JS
Stills, video and interactive scenes with reveal transitions.

Music player

fig. 08

Midnight Drive

By Neon Runner

Speaker
01:2403:58
Album art, progress and a live spectrum fed by the shared Cava instance.

Terminal settings

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
The whole settings panel in a ratatui TUI, keyboard and mouse friendly.

Desktop widgets

fig. 10
14:32:07

Saturday, October 03

22°Clear

Visualizer · Cava

Clock, weather and visualizer cards placed anywhere, edited with the redactor.
05Repositories

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.

22 repos7 layers63 plugins

Get started

Start with the documentation

Installation, updates, compositor configuration, plugins, wallpapers, scenes and theming, in English and Spanish.