SoundRoot SoundRoot
GitHub

Installation guide

Get SoundRoot running.

Two options: KDE Store (easiest) or build from source (for developers).

Get it on KDE Store Download on GitHub Releases Linux · .plasmoid Direct Download

Requirements

Component Required version Notes
KDE Plasma 6.0+ Plasma 5 not supported
Qt 6.4+ Ships with Plasma 6
PipeWire 0.3 / 1.x With pipewire-pulse running
CMake (build only) 3.20+ Only needed for source builds
A

KDE Store (recommended)

Easiest — one-click install via KDE Get New Widgets

Easiest
1

Right-click your panel → Add Widgets

Or open System Settings → Plasma Widgets

2

Click "Get New Widgets…" → "Download New Plasma Widgets"

3

Search for "SoundRoot" and click Install

4

Drag the SoundRoot widget onto your panel

GitHub Releases

Download a pre-built .plasmoid package from the releases page

1

Go to the Releases page

Find the latest release and download the .plasmoid file

2

Install from command line

kpackagetool6 -i soundroot-*.plasmoid
3

Restart plasmashell and add the widget to your panel

B

Build from Source

For developers, testers, or latest changes

Clone the repo, build with CMake, and install locally:

# Clone
git clone https://github.com/DeadlineDoggo/audiorouter.git
cd audiorouter

# Configure
cmake -B build

# Build
cmake --build build

# Install locally (no sudo)
bash install-local.sh

# Restart plasmashell to pick up the new widget
kquitapp6 plasmashell && kstart plasmashell

Troubleshooting

Widget doesn't appear after install +
Restart plasmashell: kquitapp6 plasmashell && kstart plasmashell
Or log out and back in.
No audio streams showing +
Make sure pipewire-pulse is running: systemctl --user status pipewire-pulse. Start it with systemctl --user start pipewire-pulse.
Global shortcuts not working +
Open System Settings → Shortcuts → Custom Shortcuts and look for the SoundRoot component. Assign shortcuts there, or in the widget's config page under "Keyboard Shortcuts".
CMake can't find KDE dependencies +
Install KDE ECM and Frameworks dev packages. On Arch: sudo pacman -S extra-cmake-modules plasma-framework5. On Ubuntu/Debian: sudo apt install extra-cmake-modules libkf6*-dev.