Skip to content

README.md

Latest commit

 

History

History
252 lines (178 loc) · 10.6 KB

README.md

File metadata and controls

252 lines (178 loc) · 10.6 KB
Raw

DankLinux Package Repository

DankLinux

DMS Wayland desktop environment packages built for Debian, Ubuntu, Fedora, and OpenSUSE

Built with Quickshell and Go

GitHub stars GitHub License OBS Build Ko-Fi donate

Available Packages

Desktop Environment

  • DMS - DankMaterialShell desktop environment

Core Compositor

  • niri - Scrollable-tiling Wayland compositor with smooth animations

Shell & Utilities

  • quickshell - QtQuick-based Wayland desktop shell framework
  • matugen - Material Design 3 color palette generator for themes
  • cliphist - Wayland clipboard manager with history support
  • danksearch - Fast application launcher and file search tool
  • dankcalendar-git - Calendar app with Local, Google, Microsoft, CalDAV, and iCloud support (dcal)
  • dgop - System package manager integration tool

Installation

📖 Full installation guide: danklinux.com/docs/dankmaterialshell/installation

DMS Desktop Environment

DMS packages are available via OBS (Debian/OpenSUSE), Launchpad PPA (Ubuntu), and Fedora COPR.

Required: DMS depends on packages from the danklinux repository (quickshell-git, matugen, cliphist, danksearch, dgop). Install the dependencies first, then install DMS. Niri is optional but recommended as the default compositor.

Debian 13 / Testing 
# 1. First add danklinux repository for dependencies (see below)

# 2. Add DMS stable repository
curl -fsSL https://download.opensuse.org/repositories/home:AvengeMedia:dms/Debian_13/Release.key | \
  sudo gpg --dearmor -o /etc/apt/keyrings/dms.gpg
echo "deb [signed-by=/etc/apt/keyrings/dms.gpg] https://download.opensuse.org/repositories/home:/AvengeMedia:/dms/Debian_13/ /" | \
  sudo tee /etc/apt/sources.list.d/dms.list
sudo apt update && sudo apt install dms

# Or for nightly builds (dms-git)
curl -fsSL https://download.opensuse.org/repositories/home:AvengeMedia:dms-git/Debian_13/Release.key | \
  sudo gpg --dearmor -o /etc/apt/keyrings/dms-git.gpg
echo "deb [signed-by=/etc/apt/keyrings/dms-git.gpg] https://download.opensuse.org/repositories/home:/AvengeMedia:/dms-git/Debian_13/ /" | \
  sudo tee /etc/apt/sources.list.d/dms-git.list
sudo apt update && sudo apt install dms-git
Ubuntu 26.04 LTS+ (Launchpad PPA) 
# 1. Add danklinux PPA for dependencies
sudo add-apt-repository ppa:avengemedia/danklinux
sudo apt update

# 2. Add DMS stable PPA
sudo add-apt-repository ppa:avengemedia/dms
sudo apt update && sudo apt install dms

# Or for nightly builds (dms-git)
sudo add-apt-repository ppa:avengemedia/dms-git
sudo apt update && sudo apt install dms-git

Note: Ubuntu 25.04 and older are not supported (require Qt 6.6+)

Fedora 41+ (COPR) 
# 1. Add danklinux COPR for dependencies
sudo dnf copr enable avengemedia/danklinux

# 2. Add DMS stable COPR
sudo dnf copr enable avengemedia/dms
sudo dnf install dms

# Or for nightly builds (dms-git)
sudo dnf copr enable avengemedia/dms-git
sudo dnf install dms
OpenSUSE Tumbleweed 
# 1. First add danklinux repository for dependencies (see below)

# 2. Add DMS stable repository
sudo zypper addrepo https://download.opensuse.org/repositories/home:AvengeMedia:dms/openSUSE_Tumbleweed/home:AvengeMedia:dms.repo
sudo zypper refresh && sudo zypper install dms

# Or for nightly builds (dms-git)
sudo zypper addrepo https://download.opensuse.org/repositories/home:AvengeMedia:dms-git/openSUSE_Tumbleweed/home:AvengeMedia:dms-git.repo
sudo zypper refresh && sudo zypper install dms-git

See DankMaterialShell for full documentation and configuration.

Dependencies (danklinux repository)

These packages are required for full DMS functionality:

Debian 13 (Trixie) / Testing

# Add Debian 13 Trixie Repository 
curl -fsSL https://download.opensuse.org/repositories/home:AvengeMedia:danklinux/Debian_13/Release.key | \
  sudo gpg --dearmor -o /etc/apt/keyrings/danklinux.gpg
echo "deb [signed-by=/etc/apt/keyrings/danklinux.gpg] https://download.opensuse.org/repositories/home:/AvengeMedia:/danklinux/Debian_13/ /" | \
  sudo tee /etc/apt/sources.list.d/danklinux.list
sudo apt update

# Install packages
sudo apt install niri quickshell-git matugen cliphist danksearch dgop dankcalendar-git
Alternative: Debian Testing (Rolling) 
# Add Debian Testing Repository 
curl -fsSL https://download.opensuse.org/repositories/home:AvengeMedia:danklinux/Debian_Testing/Release.key | \
  sudo gpg --dearmor -o /etc/apt/keyrings/danklinux.gpg
echo "deb [signed-by=/etc/apt/keyrings/danklinux.gpg] https://download.opensuse.org/repositories/home:/AvengeMedia:/danklinux/Debian_Testing/ /" | \
  sudo tee /etc/apt/sources.list.d/danklinux.list
sudo apt update && sudo apt install niri quickshell-git matugen cliphist danksearch dgop dankcalendar-git

Ubuntu 26.04 LTS+ (Launchpad PPA)

Note: Ubuntu 25.04 and older are not supported (require Qt 6.6+)

# Add PPA and install packages
sudo add-apt-repository ppa:avengemedia/danklinux
sudo apt update
sudo apt install niri quickshell-git matugen cliphist danksearch dgop dankcalendar-git

Fedora 41+ (COPR)

# Add COPR and install packages
sudo dnf copr enable avengemedia/danklinux
sudo dnf install quickshell-git matugen cliphist danksearch dgop dankcalendar-git ghostty dms-greeter

OpenSUSE Tumbleweed

# Add repository and install packages
sudo zypper addrepo https://download.opensuse.org/repositories/home:AvengeMedia:danklinux/openSUSE_Tumbleweed/home:AvengeMedia:danklinux.repo
sudo zypper refresh
sudo zypper install niri quickshell-git matugen cliphist danksearch dgop dankcalendar-git

Architecture Support

All packages support:

  • x86_64 (AMD64) - Fully tested
  • aarch64 (ARM64) - Built for ARM devices

Package Variants

  • Stable packages (dms, niri, matugen, cliphist, dms-greeter) - Tagged releases
  • Git packages (dms-git, niri-git, quickshell-git, dms-greeter-git) - Latest development code, updated daily

Getting Started

  1. Select niri or niri-git from your display manager
  2. Configure: ~/.config/niri/config.kdl
  3. For DMS desktop environment, see DankMaterialShell

Upstream Projects

  • DankMaterialShell - DMS desktop environment
  • dank-greeter - greetd greeter (dms-greeter / dms-greeter-git), published into danklinux Copr/OBS/PPA/Void
  • Niri - Scrollable-tiling Wayland compositor
  • Quickshell - QtQuick desktop shell toolkit
  • Matugen - Material You color generator
  • Cliphist - Wayland clipboard manager
  • Danksearch - Application launcher
  • Dgop - Package manager integration

Build Status

Open Build Service (Debian/OpenSUSE)

Launchpad PPA (Ubuntu)

Fedora COPR

Automatic rebuilds on Fedora Qt updates

quickshell, quickshell-git and qt6ct-kde link private Qt ABI and must be rebuilt whenever Fedora ships a new qt6-qtbase, qt6-qtdeclarative or qt6-qtwayland. The Rebuild for Fedora Qt updates workflow (.github/workflows/run-qt-rebuild.yml) runs hourly: it queries the Fedora repos for every Fedora chroot in the COPR project, compares against distro/fedora/qt6-baseline.json, bumps the three specs once and triggers the COPR builds. Run it by hand from the Actions tab, or fire repository_dispatch with event type fedora-qt-update (the api.danklinux.com server does this when a matching bodhi update reaches stable).

Debian and Ubuntu get the same treatment from Rebuild for Debian/Ubuntu Qt updates (.github/workflows/run-qt-rebuild-deb.yml, hourly): it reads the published OBS Debian repos and the Ubuntu archive, keeps distro/qt6-baseline-deb.json, bumps .dbN on OBS (debian only, openSUSE rebuilds itself) and uploads ppaN for the affected Ubuntu series only. Void ships no Qt private-ABI package here.

Contributing

Packaging specs and automation maintained in this repository.

  • Packaging issues: GitHub Issues
  • Upstream bugs: Report to respective project repositories

License

Packages retain their upstream licenses: Niri (GPL-3.0), Quickshell (LGPL-3.0), Matugen (GPL-2.0), Cliphist (GPL-3.0).