Volume Plasmoid

This is a KDE Plasma desktop widget.

It show a volume slider for each playing program/audio stream.

Screenshots

Features

Core Functionality

• One bar per app/stream
• Interactive volume adjustment - Can use scrollwheel or click on a bar to change its volume
• Filtering - Hide unwanted applications with simple banlist (also supports regex)
• Latency - Shows audio latency (by computing (quant / rate) * 1000)
• Fully Customizable - You can change all colors, spacing, border radius, alignment, fonts, ...

Requirements

• KDE Plasma 6.4+

Installation

1. Clone/download this repository
2. Run the included ./install.sh

Adding to Desktop

After installation:

1. Right-click on your desktop or panel
2. Select "Add Widgets..."
3. Search for "Volume Display"
4. Drag the widget to your desired location

Scripts

• install.sh - Install the plasmoid
• remove.sh - Remove the plasmoid
• rundev.sh - Run development version

Troubleshooting

No audio streams showing

• Ensure audio applications are actively playing (not just open)
• Check if PipeWire/PulseAudio is running
• Try toggling "Show Inactive" in configuration if streams are paused

Widget not appearing after installation

• Restart Plasma: systemctl --user restart plasma-plasmashell
• Check installation: kpackagetool6 --type Plasma/Applet --list | grep volume
• Look for errors: journalctl --user -f | grep plasma

Volume control not working

• Verify the application isn't muted in system volume control
• Check if the stream supports volume adjustment (some system sounds don't)
• Try clicking at different positions on the volume bar

Development

Testing Changes

After changing anything run ./rundev.sh to run "plasmoidviewer".

This will show log messages in the terminal.

License

GPL-2.0+