dux-shell README

项目的 README,来自 github.com/duxlabs-dev/dux-shell。合并为一个 markdown 文件:README.md。

Dux Modular Shell

Dux Modular Shell

A modern desktop shell for Wayland

Built with Quickshell and Go, running on dux-qt-base

Documentation GitHub stars GitHub License GitHub release Arch version AUR version (git) Ko-Fi donate Discord

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
Desktop Dashboard Launcher Control Center

Installation

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

Works best with niri, Hyprland, Sway, MangoWC, labwc, Scroll, and Miracle WM with full workspace switching, overview integration, and monitor management. Other Wayland compositors work with reduced features.

Compositor configuration guide

Command Line Interface

Control the shell from the command line or keybinds:

dms run              # Start the shell
dms ipc call spotlight toggle
dms ipc call audio setvolume 50
dms ipc call wallpaper set /path/to/image.jpg
dms brightness list  # List available displays
dms plugins search   # Browse plugin registry
dms plugins lock     # Refresh the portable plugin lockfile
dms plugins restore ~/plugins.lock.json

Full CLI and IPC documentation

Documentation

Dux Projects

DMS is one piece of the suite. The rest lives in its own repos:

Development

See component-specific documentation:

See CONTRIBUTING.md for editor setup, the i18n workflow, and Go style guidelines.

Building from Source

Core + Duxinstall:

cd core
make              # Build dms CLI
make duxinstall   # Build installer

Shell:

quickshell -p quickshell/

NixOS:

{
  inputs.dms.url = "github:duxlabs-dev/dux-shell";

  # Use in home-manager or NixOS configuration
  imports = [ inputs.dms.homeModules.dank-material-shell ];
}

Contributing

Contributions welcome. Bug fixes, widgets, features, translation, documentation and plugins all help.

Credits

Star History

Star History Chart

License

MIT License - See LICENSE for details.

dux-shell (duxlabs-dev/dux-shell)

正在搜索数据库…

这是什么?它是一个面向 Wayland 的完整桌面外壳,基于 Quickshell 和 Go 构建。它可以替代你通常需要自行拼凑的多个工具,例如状态栏、锁屏、空闲管理器、通知、启动器和 polkit 认证代理。
它是窗口管理器,还是只是一个状态栏?它本身不是窗口管理器。它运行在现有的 Wayland 合成器(如 niri、Hyprland 或 Sway)之上,负责处理其周围的桌面功能。
有什么限制吗?其他 Wayland 合成器也可以使用,但功能会有所减少。FreeBSD 已内置支持,其专属设置说明见 distro/freebsd/README.md。
它自己能显示 CPU、内存和 GPU 的使用情况吗?可以。dms 守护进程内置实时 CPU、内存和 GPU 指标以及温度显示,由 dgop 提供支持,还有一个可搜索的进程列表,可以在其中管理进程。
它能根据我的壁纸为应用配色吗?可以。它使用 matugen 和 dank16 根据壁纸生成配色方案,并将其应用到 GTK、Qt、终端以及 vscode 和 vscodium 等编辑器上。
启动器能搜索文件和运行命令吗?可以。除了应用,它还能通过 dsearch 搜索文件、表情符号、正在运行的窗口和计算器结果,可以运行命令,并支持通过插件扩展。
大小
180.9 MB
星标
9.1K
时长
1年
提交 · 90 天