Repository navigation
Sonero 0.1.0 — First release
The first public release of Sonero — a per-application audio mixer, router and
equalizer for Linux, built directly on PipeWire.
It creates a set of virtual sound cards and lets you send each application to
whichever one you like, so your game, your call, your music and your browser each get
their own volume, their own equalizer and their own output device — live, without
restarting anything.
This is a personal project I use every day, released in the hope that it is useful to
someone else. It is not a commercial product and has no telemetry, account or
"pro" tier.
What is in it
- Six output channels — System (master), Game, Chat, Media, Browser, Aux — with
volume, mute, solo, balance and live VU meters. - App routing — every playing application appears as a chip you move between
channels; the assignment survives restarts. - Equalizer per channel, 10 / 15 / 31 bands, 24 built-in presets, plus save,
import and export of your own. - Automatic per-channel gain on request: it holds the highest gain (up to +6 dB)
that keeps the channel clear of full scale — slow up, immediate down. - Every output device treated equally — USB, Bluetooth, HDMI, S/PDIF and onboard
analog are detected, badged and routable, each with its own transmission format
(rate and bit depth for wired, codec for Bluetooth). Two channels can play to two
different devices at once. - Bluetooth — automatic switch to the best A2DP codec the headset offers, and
battery level through BlueZ. - SteelSeries Arctis Nova Pro Wireless — battery read from the base station over
USB HID. - Streaming mix for OBS — a
Sonero Streamsource with an independent send level
per channel, so viewers hear a different balance than you do. - Desktop integration — tray icon showing device battery and a compact volume
window, desktop notifications, autostart at login, and background operation so the
channels stay alive when the window is closed.
Requirements
- PipeWire 0.3+ with WirePlumber — already running on every current desktop.
- Qt 6.2+ (the AppImage carries its own).
- x86-64.
Which file to download
| File | For |
|---|---|
Sonero-0.1.0-x86_64.AppImage |
Anything. Portable, built on the oldest glibc, carries its own Qt. |
sonero_0.1.0-ubuntu2204_amd64.deb |
Ubuntu 22.04, Linux Mint 21.x |
sonero_0.1.0-ubuntu2404_amd64.deb |
Ubuntu 24.04, Linux Mint 22.x |
Sonero-0.1.0-arch-x86_64.AppImage |
Arch, or a distribution at least as new |
Sonero-0.1.0-fedora-x86_64.AppImage |
Fedora, or a distribution at least as new |
The last two exist because CI builds on those distributions to catch bundling
regressions. They link a newer glibc and offer nothing the portable one does not.
# AppImage — needs FUSE 2, or run with --appimage-extract-and-run
chmod +x Sonero-0.1.0-x86_64.AppImage
./Sonero-0.1.0-x86_64.AppImage
# Debian / Ubuntu / Mint
sudo apt install ./sonero_0.1.0-ubuntu2204_amd64.debOn Arch and Fedora, building from source is also a good option and leaves you with a
small binary that follows your distribution's Qt updates — see the README.
Worth knowing before you install
- The AppImage deletes the bundle it replaces. Updating means downloading a new
file, so without that every version you ever ran would pile up in~/Downloads. It
only removes a bundle a previous run recorded — never a file it went looking for,
and never the one you just started. If you keep two versions side by side on
purpose, running one deletes the other. - On GNOME the tray icon needs the AppIndicator extension. GNOME ships no tray of
its own; without the extension the window still works, but there is no tray icon and
no background mode to return from. - Two features ask for permission, from Settings → System integration, which
shows the exact commands before your desktop asks for a password: a udev rule for
SteelSeries battery (the.debinstalls it for you), and a systemd drop-in that
turns on BlueZ's experimental interfaces for Bluetooth battery. Both are reversible
by deleting one file. - Changing a device's sample rate or bit depth lands on the next WirePlumber load.
ALSA fixes the format when the PCM is opened, and Sonero will not restart your audio
session behind your back — that would drop every Bluetooth link.
Not finished yet
These are visible in the app but greyed out and labelled, rather than left looking
clickable:
- Profiles — saving whole configurations as named profiles is not implemented.
- Microphone page — the
Sonero Microphonesource is live and apps can record
from it, but every control on that page (gain, mute, level, noise suppression, gate,
monitoring) is inert. The DSP behind them is not wired. - SteelSeries hardware EQ — the dock accepts the HID writes and nothing audible
changes; unsolved, so the card is disabled. The per-channel equalizer runs in
software and works with any headset.
Tested hardware
Detection is generic, so any output PipeWire exposes should work. These are the ones
this release was actually tested against:
| Device | Connection |
|---|---|
| SteelSeries Arctis Nova Pro Wireless | USB base station |
| Sennheiser MOMENTUM 4 Wireless | Bluetooth, and wired over USB |
| Sony WH-CH720N | Bluetooth |
LDAC is untested. The codec picker ranks whatever A2DP profiles BlueZ reports and
puts LDAC on top, but none of the headsets above offers it, so that path has never run
on real hardware. Which codecs you are offered at all also depends on how your
distribution built PipeWire.
Battery over USB HID is model-specific, so only the Arctis Nova Pro Wireless is
implemented. Everything else still plays audio normally. If you want your headset
supported and you do not write C++, hid/SKILL.md
is a written procedure meant to be handed to an AI assistant so it can do the work.
How this was built
Sonero was written with AI assistance — Anthropic's Claude, used as a pair programmer.
Every feature started as something I asked for, every change was read before it was
kept, and the parts that matter — gain staging, EQ headroom, the HID protocol,
Bluetooth codec behaviour — were checked against real hardware and real recordings.
Said openly because the project is open; the code is the same either way.
Feedback
Bug reports and pull requests are welcome. It is built in spare time, by one person,
and will move at that pace. If something breaks, the two most useful things to include
are the version from Settings → About — it names the exact commit — and the log,
which Sonero writes to the terminal:
./Sonero-0.1.0-x86_64.AppImage # or just: SoneroMIT licensed.