Dux Labs
Dux Icons Installation
Dux Icons Installation
Dux Icons installs a single dux-icons command. Install it from the Dux repositories or from source. Nothing else is needed, and the build itself never needs root.
Requirements
- Python 3.9 or newer
- Monochrome mode and clipping of oversized artwork need Qt 6.7 or newer in Qt apps
Distribution Packages
Dux Icons ships one package, dux-icons, which follows tagged releases. There is no -git build. It is a plain Python script, so the package is architecture independent and needs only python3 and hicolor-icon-theme.
Arch Linux
paru -S dux-icons
Fedora & CentOS
sudo dnf copr enable duxlabs/dux-repo
sudo dnf install dux-icons
Debian
Packages are published on OBS for Debian 13 (Trixie), Debian Testing, and Debian Sid.
- Debian 13 (Trixie)
- Debian Testing
- Debian Sid
curl -fsSL https://download.opensuse.org/repositories/home:duxlabs-dev:dux-repo/Debian_13/Release.key | \
sudo gpg --dearmor -o /etc/apt/keyrings/home-duxlabs-dev-dux-repo.gpg
echo "deb [signed-by=/etc/apt/keyrings/home-duxlabs-dev-dux-repo.gpg] https://download.opensuse.org/repositories/home:/duxlabs-dev:/dux-repo/Debian_13/ /" | \
sudo tee /etc/apt/sources.list.d/home-duxlabs-dev-dux-repo.list
sudo apt update
sudo apt install dux-icons
curl -fsSL https://download.opensuse.org/repositories/home:duxlabs-dev:dux-repo/Debian_Testing/Release.key | \
sudo gpg --dearmor -o /etc/apt/keyrings/home-duxlabs-dev-dux-repo.gpg
echo "deb [signed-by=/etc/apt/keyrings/home-duxlabs-dev-dux-repo.gpg] https://download.opensuse.org/repositories/home:/duxlabs-dev:/dux-repo/Debian_Testing/ /" | \
sudo tee /etc/apt/sources.list.d/home-duxlabs-dev-dux-repo.list
sudo apt update
sudo apt install dux-icons
curl -fsSL https://download.opensuse.org/repositories/home:duxlabs-dev:dux-repo/Debian_Unstable/Release.key | \
sudo gpg --dearmor -o /etc/apt/keyrings/home-duxlabs-dev-dux-repo.gpg
echo "deb [signed-by=/etc/apt/keyrings/home-duxlabs-dev-dux-repo.gpg] https://download.opensuse.org/repositories/home:/duxlabs-dev:/dux-repo/Debian_Unstable/ /" | \
sudo tee /etc/apt/sources.list.d/home-duxlabs-dev-dux-repo.list
sudo apt update
sudo apt install dux-icons
Ubuntu
Ubuntu 26.04 LTS+ (Resolute Raccoon) is supported via Launchpad PPA.
sudo add-apt-repository ppa:duxlabs/dux-repo
sudo apt update
sudo apt install dux-icons
openSUSE
Dux Icons is available through the Open Build Service (OBS) for openSUSE Tumbleweed, Leap 16/16.1, and Slowroll.
- Tumbleweed
- Leap 16
- Leap 16.1
- Slowroll
sudo zypper addrepo https://download.opensuse.org/repositories/home:duxlabs-dev:dux-repo/openSUSE_Tumbleweed/home:duxlabs-dev:dux-repo.repo
sudo zypper refresh
sudo zypper install dux-icons
sudo zypper addrepo https://download.opensuse.org/repositories/home:duxlabs-dev:dux-repo/16.0/home:duxlabs-dev:dux-repo.repo
sudo zypper refresh
sudo zypper install dux-icons
sudo zypper addrepo https://download.opensuse.org/repositories/home:duxlabs-dev:dux-repo/16.1/home:duxlabs-dev:dux-repo.repo
sudo zypper refresh
sudo zypper install dux-icons
sudo zypper addrepo https://download.opensuse.org/repositories/home:duxlabs-dev:dux-repo/openSUSE_Slowroll/home:duxlabs-dev:dux-repo.repo
sudo zypper refresh
sudo zypper install dux-icons
Void Linux
Void carries the stable dux-icons package.
echo "repository=https://void.duxlabs.dev/dux-repo/current" | sudo tee /etc/xbps.d/dux.conf
sudo xbps-install -Su
sudo xbps-install -S dux-icons
On the first sync, xbps-install shows the Dux Labs signing key fingerprint and asks you to trust it.
Distribution packages install the dux-icons command to /usr/bin, and its data to /usr/share/dux-icons.
The package only installs the generator. Pick Dux Icons in DMS (see With DMS), or run dux-icons yourself (see Without DMS).
Build from Source
git clone https://github.com/duxlabs-dev/dux-icons.git
cd dux-icons
make install
This installs the dux-icons command into ~/.local/bin, and its data into ~/.local/share/dux-icons. Make sure ~/.local/bin is on your PATH. Set PREFIX to install somewhere else, and DESTDIR to stage. make uninstall removes both.
For development, make link links the command to your checkout instead of copying it.
With DMS
DMS runs dux-icons when the command is on your PATH. Pick Dux Icons under Settings → Appearance → Icons. DMS builds the theme, and rebuilds it:
- on every wallpaper or theme change
- when an app is installed or removed
- when the shell starts
The same card has three options:
| Option | Does |
|---|---|
| Icon shape | Picks the badge outline |
| Themed app icons | Paints app icons in tones of your colors in place of their own |
| Shaded icons | Fills the badges with a soft gradient |
From a terminal:
dms ipc call settings set iconThemeDark dux-icons
dms ipc call settings set iconMonoApps true
dms ipc call settings set iconShape squircle
dms ipc call settings set iconGradient true
See Icon Theming for the rest of the icon settings in DMS.
Without DMS
Give it the two colors:
dux-icons --badge '#9ecaff' --glyph '#003258'
This builds the theme into ~/.local/share/icons/dux-icons. Desktops list it as Dux Icons in their icon theme setting. Run it again after installing or removing apps.