Skip to content

Sonero 0.1.0 — First release

Choose a tag to compare

@Tatsu21 Tatsu21 released this 30 Aug 21:17
· 34 commits to main since this 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 Stream source 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.deb

On 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 .deb installs 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 Microphone source 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: Sonero

MIT licensed.