duxlabs-dev /dux-shell
Desktop shell for wayland compositors built with Quickshell & GO, optimized for niri, hyprland, sway, MangoWC, labwc, and MiracleWM.
★ 9,089⑂ 603👁 23⑃ 1,322● 2,904▤ 79
+14
日增长
9,089
stars
603
forks
23
watchers
1,322
prs
2,904
issues
79
releases
README
Dux Modular Shell
A modern desktop shell for Wayland
Built with Quickshell and Go, running on dux-qt-base

Dux Modular Shell (DMS) is a complete desktop shell for niri, Hyprland, MangoWC, Sway, labwc, Scroll, Miracle WM, and other Wayland compositors. It replaces waybar, swaylock, swayidle, mako, fuzzel, polkit, and everything else you'd normally stitch together to make a desktop.
Repository Structure
This is a monorepo containing both the shell interface and the core backend services:
dux-shell/
├── quickshell/ QML-based shell interface
│ ├── Modules/ UI components (panels, widgets, overlays)
│ ├── Services/ System integration (audio, network, bluetooth)
│ ├── Widgets/ Reusable UI controls
│ └── Common/ Shared resources and themes
├── core/ Go backend and CLI
│ ├── cmd/ dms CLI and duxinstall binaries
│ ├── internal/ System integration, IPC, distro support
│ └── pkg/ Shared packages
├── distro/ Distribution packaging
│ ├── fedora/ Fedora RPM specs
│ ├── debian/ Debian packaging
│ └── nix/ NixOS/home-manager modules
└── flake.nix Nix flake for declarative installation
See it in Action
https://github.com/user-attachments/assets/d310418b-cc44-4ace-ac0d-2fc0c851291d
More Screenshots
Installation
bash
curl -fsSL https://install.duxlabs.dev | sh
One command installs DMS and all dependencies on Arch, Fedora, Debian, Ubuntu, openSUSE, or Gentoo.
FreeBSD: native support is included in-tree; see distro/freebsd/README.md for supported integrations and setup notes.
Manual installation guide
Features
Dynamic Theming
Wallpaper-based color schemes that automatically theme GTK, Qt, terminals, editors (vscode, vscodium), and more using matugen and dank16.
System Monitoring
Real-time CPU, RAM, GPU metrics and temperatures built into the dms daemon (powered by dgop). Process list with search and management.
Powerful Launcher
Spotlight-style search for applications, files (dsearch), emojis, running windows, calculator, and commands. Extensible with plugins.
Control Center
Unified interface for network, Bluetooth, audio devices, display settings, and night mode.
Smart Notifications
Notification center with grouping, rich text support, and keyboard navigation.
Media Integration
MPRIS player controls, calendar sync, weather widgets, and clipboard history with image previews.
Session Management
Lock screen, idle detection, auto-lock/suspend with separate AC/battery settings, and a settings front-end for dux-greeter.
Plugin System
Extend functionality with the plugin registry. DMS keeps
~/.config/dms/plugins.lock.json synchronized with managed plugin installs and
their exact Git commits, so the same plugins can be reproduced on another machine.
Supported Compositors
WoTop issues
#324Multi-language / Localization / Translations58 comments · 2025-10-05#109[THEMES] Matugen Theme Improvments - Ghostty, GTK, QT, etc.42 comments · 2025-08-25#1206openconnect VPN with PKCS11 authentication12 comments · 2025-12-29#1207Combine the Running App and WorkSpace Switcher widget features and enable an All-in-One Solution10 comments · 2025-12-29#3138Hyprland workspaces no longer working9 comments · 2026-08-21#3770Settings for Corner Conflict Resolution Between Two Bars8 comments · 2026-10-12#3635design: settings window8 comments · 2026-09-30#1882Drag the Bar to Scroll8 comments · 2026-03-02
Discussions
#4217Kitty always launches as fullscreen1 comments · 2026-11-09#4198The launcher on the island disappears0 comments · 2026-11-07#4164mobile support0 comments · 2026-11-06#4122When will the flake nixosModules/homeModules be renamed?1 comments · 2026-11-04#4100It seams that some Arch packages installed by installer, may never be updated.0 comments · 2026-11-03#4051Power Menu in Full mode0 comments · 2026-10-31#3937Russian translation — POEditor access1 comments · 2026-10-26#3930Separate repo?2 comments · 2026-10-25
Latest release
Release v2.1.2 v2.1.2 2026-11-08Installation bash curl -fsSL https://install.duxlabs.dev | sh Assets Complete Packages - dms-full-amd64.tar.gz - Complete package for x86_64 systems (CLI binaries + QML source + shell completions + installation guide) - dms-full-arm64.tar.gz - Complete package for ARM64 systems (CLI binaries + QML source + shell completions + installation guide) - dms-full-freebsd-amd64.tar.gz - Complete package for FreeBSD x86_64 systems - dms-full-freebsd-arm64.tar.gz - Complete package for FreeBSD ARM64 systems Individual Components - dms-cli-amd64.gz - DMS CLI binary for x86_64 syste