Repository navigation
Releases
Sonero 0.1.6 — Stability and efficiency
A stability and efficiency release: a channel sent to another output no longer crackles, idle channels stop using CPU, and the microphone page grows device selection and echo cancellation.
Fixed
- Crackling on any output other than the default. A channel routed to a second device (a USB headset, HDMI, S/PDIF) played garbled, broken-up audio. Each channel's two halves ran on two different clocks with nothing keeping them in step. They now share one clock, and the output buffers a few milliseconds before it starts.
- Your voice in your own screen share. Discord's screen share captured Sonero's channels as ordinary apps, so people in the call heard themselves, and every other app came through twice. Channel outputs are now marked virtual and are left out of the share.
- Device notifications no longer stack up: a device that disconnects and reconnects (HDMI when a monitor sleeps) shows one notification, after the list has settled.
New
- Microphone input selection. Pick which microphone Sonero Microphone records from, or follow the system default. An unplugged choice is kept and comes back when the device does.
- Echo cancellation. For speakers instead of headphones: what your speakers play is removed from the microphone, using PipeWire's WebRTC echo canceller. Choose which output the speakers are on.
- In-app updates. Settings → Updates checks GitHub once a day (can be switched off). Updates install only when you press Update: the AppImage replaces itself, and a
.debis installed through apt after your password prompt. Every download is checked against the SHA-256 GitHub publishes. Other installs are told the command to run. - New packages: a snap, and openSUSE / Fedora / Debian / Arch builds on the openSUSE Build Service.
Faster
- Idle channels use no CPU. A channel with nothing playing into it now sleeps until an app starts playing, instead of processing silence on every audio cycle.
- Less work in the background. With the window closed to the tray, the meters stop refreshing. Only what has to keep running continues: auto-gain, app routing, battery levels and the tray menu.
- Channel processing is about 20% faster, with identical output.
- Builds are about 40% faster on 4–8 core machines.
Removed
- The headset onboard EQ card on the Devices page. The headset accepted the writes but never changed the sound, so the card only looked like it worked. Use the per-channel equalizer on the Channels page.
Upgrading
Settings carry over unchanged. Any headset EQ you had saved is ignored.
Development build (main)
Automatic build of main, replaced on every push. Not a release —
for a version that was actually cut, use the Releases page.
Commit: 5bc3759
Built: 2026-11-09 21:44 UTC
Sonero-*-x86_64.AppImage without a distribution in the name is the
portable one — built on the oldest glibc, so it runs almost anywhere.
The -arch and -fedora builds need a distribution at least as new.
Sonero 0.1.5 — Harmonic bass, and an interface you can repaint
Two features you can see, and one change underneath them that you cannot: every
output channel now runs Sonero's own processing instead of the daemon's. That is
what made the bass stage possible, and it is also the reason this release touches
everyone's audio and not only the people who switch the new things on.
Read that last part twice before upgrading. 0.1.4 built each channel out of a
PipeWire module-filter-chain and let the sink's own volume control do the fader.
0.1.5 replaces both with a pair of nodes Sonero owns and one chain running between
them. Routing, the stream mix for OBS and the device handling are unchanged and
still go through the same code as before — but the path your audio actually takes
is new, and it has run on one person's machine.
For the microphone, the Arch package and the update check, see the
0.1.4 and
0.1.3 notes — all three are
unchanged here.
What's new
- Harmonic bass synthesis, on every channel. A small driver cannot move enough
air to reproduce 40 Hz, and asking it to with an equalizer does not produce bass —
it produces excursion, and distortion of everything else playing at the same time.
So Sonero synthesises the harmonics of the bass instead, in the range the driver
does reproduce, and your hearing reconstructs the fundamental that is not there.
Crossover, level, how many orders, the balance between even and odd, and the
envelope timing are all yours, with aReplace lowsoption that filters the
original out rather than adding to it — the setting that earns its keep on small
drivers and Bluetooth. - The harmonics come from Chebyshev polynomials, not from clipping or
tanh.
T_n(cos x) = cos(n x)is an identity, so feeding a sinusoid through the n-th
polynomial produces exactly its n-th harmonic — per-order control rather than a
waveshaper's mush. The low band is normalised by its own envelope before shaping
and scaled back by it afterwards, which is the difference between harmonics that
breathe with the bass line and a constant buzz under the music. - Themes, as files you can write. Thirteen colours and a font in a JSON file.
Every shade in between — a hover against its surface, a slider groove, the tint
behind a soloed channel — is derived from those thirteen, so a coherent interface
costs thirteen decisions instead of thirty-six. Import, export and switch from the
Profiles page. Six examples ship: Nord, Gruvbox, Cyberpunk, Phosphor and two
light ones. - The built-in theme cannot be broken. It is compiled into the binary and is
only ever applied over, never replaced, so a theme file that is wrong, truncated
or written for an older version changes colours and nothing else — and selecting
the built-in one in Profiles is always a way back. An optional style-sheet block
covers what colours cannot say; Export stylesheet… writes out the whole sheet
with your colours already resolved, as the reference for writing one. - Themes reach the parts that are painted, not styled — the equalizer curve, the
VU meters, the channel strips' accents and the app chips, none of which a style
sheet can touch. Channel colours keep their own hue so green still means Game, but
take their saturation and lightness from the theme. - Battery without a list of blessed products. Read from the kernel's own
power_supplyclass, which publishes a charge level for any HID device whose
driver knows one. A vendor protocol is now one source behind a shared interface
rather than the feature itself — SteelSeries base stations still use that path
because they report battery no other way, and adding another vendor costs one file. - Devices behind a receiver are handled. For anything on a dongle the USB
descriptors describe the dongle — a Logitech Lightspeed receiver reports itself as
"USB Receiver" — so the power supply's own model name is matched as well. This was
found by probing real hardware, where matching on the USB strings alone silently
reported no battery.
Fixed
- Bluetooth battery never worked. PipeWire publishes the same Bluetooth sink
under two names, one with the MAC's colons intact, and a D-Bus object path may not
contain a colon. Every lookup was rejected withInvalid object path— five times
per device per refresh, filling the log — and no percentage ever arrived. It reads
now. - A device plugged in while the Channels page was open stayed invisible until you
switched channels or restarted Sonero. The page built its output list once and
never watched for changes, although the backend has published a revision counter
all along and the Mixer and Devices pages both use it. - The Channels page showed "Default output" for every channel, whatever it was
actually routed to. Rebuilding the list dropped the selection and nothing put it
back. - Qt failed to register Sonero with the desktop portal on every launch. The
desktop file name was set after the application object was constructed, by which
point the Wayland plugin had already registered the process — so the registration
that stuck was the one made before the name was known, and the window icon and
notifications were not tied toSonero.desktop.
What is finished and what is not
Working:
- The bass stage runs on all six output channels, with its own settings per channel,
remembered across restarts. The equalizer, the limiter and the fader are Sonero's
own code now, and the equalizer behaves exactly as it did in 0.1.4 — band gains
clamped to ±12 dB and the curve's boost compensated ahead of the filters. - Themes apply live, with no restart, and are remembered.
Not finished:
- The bass crossover is per channel, not per device. It should follow the
transducer — it is the frequency where your driver stops delivering — so
switching a channel from headphones to speakers means setting it again. Making it
a property of the device is the obvious next step and is not in this release. - A theme's optional style-sheet block can break its own layout. Nothing
validates it. The thirteen colours are the supported surface; the sheet is an
escape hatch, and the built-in theme behind it is why a bad one is recoverable. - There is no preview. You apply a theme to see it.
- Noise suppression still needs RNNoise at build time, exactly as in 0.1.4. It is
in the.deband the AppImage; from source it ispackaging/build-rnnoise.sh
everywhere except Arch.
What "tested" means here: 42 new automated cases across five suites, 139 in total,
and the bass measured rather than described. A pure 50 Hz sine has no harmonics in
it, so anything at 100 or 150 Hz was synthesised — and halving the input halves them
again, within a decibel of a factor of two, which is what separates this from a
distortion pedal. The same measurement through the running graph matches the offline
model within about 1 dB per frequency. The limiter never passes its ceiling whatever
is driving it, and the chain's output does not change with the block size PipeWire
happens to hand over.
What has not happened is other people listening to it, on other headphones. The
numbers say the algorithm is doing what it claims; whether the settings suit your
hardware is a judgement no test makes. If it sounds wrong, that is worth an issue.
Requirements
- PipeWire 0.3+ with WirePlumber — already running on every current desktop.
- Qt 6.2+ (the AppImage carries its own).
- RNNoise 0.2, for the microphone's noise suppression only. In the
.deband the
AppImage already;rnnoiseon Arch;packaging/build-rnnoise.shelsewhere. - x86-64.
Which file to download
| File | For |
|---|---|
| none — build the package | Arch, Manjaro, EndeavourOS (see the command below) |
Sonero-0.1.5-x86_64.AppImage |
Anything. Portable, built on the oldest glibc, carries its own Qt. |
sonero_0.1.5-ubuntu2204_amd64.deb |
Ubuntu 22.04, Linux Mint 21.x |
sonero_0.1.5-ubuntu2404_amd64.deb |
Ubuntu 24.04, Linux Mint 22.x |
sonero_0.1.5-ubuntu2604_amd64.deb |
Ubuntu 26.04 |
sonero_0.1.5-debian13_amd64.deb |
Debian 13 (trixie) |
Sonero-0.1.5-arch-x86_64.AppImage |
Arch, if you would rather not build |
Sonero-0.1.5-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.
# Arch, Manjaro, EndeavourOS — builds a real package and installs it with pacman
git clone https://github.com/Tatsu21/sonero.git
yay -B sonero/packaging/aur/sonero
# without an AUR helper: makepkg -si -D sonero/packaging/aur/sonero
# and packaging/aur/sonero-git builds main as it stands
# AppImage — needs FUSE 2, or run with --appimage-extract-and-run
chmod +x Sonero-0.1.5-x86_64.AppImage
./Sonero-0.1.5-x86_64.AppImageUpgrading
Your settings carry over. The bass stage starts switched off on every channel, so
0.1.5 sounds like 0.1.4 until you turn it on — which is the point: if something
sounds different immediately after upgrading, that is the rewritten channel path and
not a setting, and it is worth an issue.
Sonero 0.1.4 — The microphone
One feature, and it is the one that was missing: the microphone now processes your
voice instead of passing it through. Everything else here is repair work on what
0.1.3 shipped.
The microphone is new, and new in the way that matters — this is the first
release where it does anything to your audio. It is tested: 21 automated tests
over the chain and the noise model, and the whole path measured through real
recordings. It is also a few days old, half its stages have no controls yet, and
it has run on one person's hardware. Treat it as the good beta it is; the section
below says exactly what is finished and what is not.
For the Arch package and the update check, see the
0.1.3 notes — both are
unchanged here.
What's new
- A microphone that does something. The
Sonero Microphonesource your
applications select now runs a broadcast chain instead of forwarding audio: a
high-pass, learned noise suppression, a gate that fades between sentences rather
than chopping them, a de-esser, a ten-band voice equalizer, a compressor and a
brick-wall limiter. Presets for podcasting, streaming and meetings, and aRaw
preset that switches every stage off so you can hear what it is doing. - Noise suppression is RNNoise, and it runs ahead of everything else so the
gate and the compressor measure speech against silence rather than against your
room. On a quiet room here it takes about 9 dB out of the noise floor. - It works on every distribution, not just Arch. RNNoise is packaged by Arch
and by nobody else — not Debian trixie, not Ubuntu 22.04 or 24.04, not Fedora in
any release — so the.deband the AppImage now carry it built and linked in.
Building from source yourself:packaging/build-rnnoise.sh. - A voice equalizer of its own, ten bands, with presets. Every application
recording from Sonero hears that curve, not just the one you set it up in.
Fixed
- The microphone is no longer listed on the Channels page. It is an input: it
has no output device to pick and no place in the stream mix. Worse, both pages
owned an equalizer for it, and the Channels page overwrote the microphone's copy
on every launch — so a curve set there did not survive a restart. - The combo box arrows were a small dash rather than an arrow, in every
dropdown in the app. - The mixer left a third of the window empty beside the channel strips, and
Master and Aux sat a few pixels lower than the other four because their header
glyphs are a different kind of character. - The udev command on the Devices page pointed at a relative path, so copying
it worked only for someone sitting in the source tree. It now shows the rule's
real location and points at the one-click fix in Settings.
The microphone: what is finished and what is not
Working, and what the chain runs today:
- The chain preset, input gain, output level, mute, noise suppression and the
ten-band voice equalizer — all live, all remembered across restarts. - The gate, de-esser, compressor and limiter run. They are part of every preset
and they are why the microphone already sounds processed.
Not finished:
- The gate, de-esser and compressor have no controls. They run at their
preset's values and their cards are markedPREPARED. Choosing a different chain
preset is the only way to change them for now. - The input device cannot be chosen. The chain follows the system default
microphone. - Monitoring — hearing yourself — is not implemented.
- Noise suppression needs RNNoise. It is in the
.deband the AppImage; if you
build from source without it, that one stage reports itself unavailable and your
audio passes through untouched rather than silently going missing.
What "tested" means here: 15 automated tests over the processing chain, 6 over the
noise model, and the whole path measured through real recordings — mute produces
digital silence, a +10 dB equalizer band arrives as +10 dB, and the limiter never
passes its ceiling whatever the input gain is set to. What has not happened is
other people using it, on other microphones, in other rooms. If it does something
strange, that is worth an issue.
Requirements
- PipeWire 0.3+ with WirePlumber — already running on every current desktop.
- Qt 6.2+ (the AppImage carries its own).
- RNNoise 0.2, for the microphone's noise suppression only. In the
.deband
the AppImage already;rnnoiseon Arch;packaging/build-rnnoise.shelsewhere. - x86-64.
Which file to download
| File | For |
|---|---|
| none — build the package | Arch, Manjaro, EndeavourOS (see the command below) |
Sonero-0.1.4-x86_64.AppImage |
Anything. Portable, built on the oldest glibc, carries its own Qt. |
sonero_0.1.4-ubuntu2204_amd64.deb |
Ubuntu 22.04, Linux Mint 21.x |
sonero_0.1.4-ubuntu2404_amd64.deb |
Ubuntu 24.04, Linux Mint 22.x |
sonero_0.1.4-debian13_amd64.deb |
Debian 13 (trixie) |
Sonero-0.1.4-arch-x86_64.AppImage |
Arch, if you would rather not build |
Sonero-0.1.4-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.
# Arch, Manjaro, EndeavourOS — builds a real package and installs it with pacman
git clone https://github.com/Tatsu21/sonero.git
yay -B sonero/packaging/aur/sonero
# without an AUR helper: makepkg -si -D sonero/packaging/aur/sonero
# and packaging/aur/sonero-git builds main as it stands
# AppImage — needs FUSE 2, or run with --appimage-extract-and-run
chmod +x Sonero-0.1.4-x86_64.AppImage
./Sonero-0.1.4-x86_64.AppImage
# Debian / Ubuntu / Mint
sudo apt install ./sonero_0.1.4-ubuntu2204_amd64.debyay -S sonero still does not work: the package is not on the AUR, because
registrations there remain closed. The PKGBUILDs are finished and CI builds them
on every push; the day registrations reopen, the command above becomes
yay -S sonero.
Worth knowing before you install
- Your microphone will sound different. The chain starts on the Podcast preset,
which gates, compresses and de-esses. If you preferred it raw, the chain preset
at the top of the Microphone page has aRawsetting that switches every stage
off. - The update check is off until you switch it on, in Settings → Updates.
Nothing contacts GitHub until you ask. - 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. - 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.deband the pacman package install 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.
- The microphone's gate, de-esser and compressor — see the section above.
- 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.
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, and for the microphone especially: it is
the newest thing here and the least exercised. 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 c...
Sonero 0.1.3 — Arch package and an update check
Two ways to keep Sonero current: a proper package on Arch, and an update check
inside the app that tells you when a release exists — if you ask it to.
The audio path is untouched. Mixing, routing, the equalizer and device handling
behave exactly as they did in 0.1.2, so this is a safe upgrade from it.
What's new
- A package for Arch, Manjaro and EndeavourOS. A
PKGBUILDnow lives in the
repository, so Sonero installs the way everything else on your system does:
compiled against your Qt and PipeWire, handed to pacman, removable with
pacman -R sonero, and carrying the udev rule that makes SteelSeries headset
battery work — no extra step in Settings. It is not on the AUR yet: registrations
there are closed at the time of writing, so you point your helper at the
directory instead of at a package name. See below for the command. - An update check, off until you turn it on. Settings → Updates has one
switch. With it on, Sonero asks GitHub once a day whether a newer release exists
and tells you; Check now does the same on demand. It is off out of the box,
because contacting a server is not something an audio mixer should do uninvited. - What the update button does depends on how you installed Sonero, and it works
that out from where it is running. A packaged install (pacman,.deb, anything
under/usr) gets the command for its package manager and nothing else — Sonero
does not write to files pacman or dpkg own. An AppImage gets a real self-update:
the new bundle is downloaded beside the running one, checked that it really is
an AppImage, and started only when you say so. The old bundle is removed by the
new one on its first run, the same tidying Sonero already did after a manual
download. - The check sends no identity, no settings and no telemetry. It is one HTTPS
request toapi.github.com, and the answer is only trusted if it came from
GitHub. SECURITY.md
spells out the trust model, including what it does not give you — releases are
not signed. - A build from a source tarball reports its real version. The version comes from
the newest git tag, and a tarball carries no git history, so it used to fall back
to0.0.0— a package built that way would have told the update check it was
permanently out of date. Packagers can now pass the version the package is named
after.
This release cannot announce itself. 0.1.2 has no update check, so if that is
what you are running, this is the last upgrade you will have to notice on your own.
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 |
|---|---|
| none — build the package | Arch, Manjaro, EndeavourOS (see the command below) |
Sonero-0.1.3-x86_64.AppImage |
Anything. Portable, built on the oldest glibc, carries its own Qt. |
sonero_0.1.3-ubuntu2204_amd64.deb |
Ubuntu 22.04, Linux Mint 21.x |
sonero_0.1.3-ubuntu2404_amd64.deb |
Ubuntu 24.04, Linux Mint 22.x |
sonero_0.1.3-debian13_amd64.deb |
Debian 13 (trixie) |
Sonero-0.1.3-arch-x86_64.AppImage |
Arch, if you would rather not build |
Sonero-0.1.3-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.
# Arch, Manjaro, EndeavourOS — builds a real package and installs it with pacman
git clone https://github.com/Tatsu21/sonero.git
yay -B sonero/packaging/aur/sonero
# without an AUR helper: makepkg -si -D sonero/packaging/aur/sonero
# and packaging/aur/sonero-git builds main as it stands
# AppImage — needs FUSE 2, or run with --appimage-extract-and-run
chmod +x Sonero-0.1.3-x86_64.AppImage
./Sonero-0.1.3-x86_64.AppImage
# Debian / Ubuntu / Mint
sudo apt install ./sonero_0.1.3-ubuntu2204_amd64.debOn 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 update check is off until you switch it on. Nothing contacts GitHub, and
nothing is ever downloaded or installed, until you ask for it in
Settings → Updates. - 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.deband the pacman package install 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.3-x86_64.AppImage # or just: SoneroMIT licensed.
Sonero 0.1.2 — Tray hotfix
A hotfix for one bug that loses your session, plus the release-pipeline fixes that
kept 0.1.0 and 0.1.1 from ever attaching their packages.
Nothing about how the app works has changed. For what Sonero is and what is in it, see
the 0.1.0 release notes.
Fixed
Closing the tray's volume window shut down the whole application. With the window
hidden to the tray — the normal state when "run in background" is on — opening
Volume… from the tray menu and then closing it took Sonero with it, and your
channels, routing and virtual devices went away with the process.
Qt ends an application when the last window carrying WA_QuitOnClose is closed, and
that attribute is on by default for every top-level window. With the main window
hidden, the volume window was the only visible one, so closing it met that condition
exactly. It no longer takes part in the count.
Closing the main window still quits the app when "run in background" is off, as before.
Also in this release
None of this changes the program, but it is why the previous two tags produced no
downloads:
- The version is read correctly inside the Arch and Fedora build containers. git
refused to read a checkout it considered foreign there, the tag lookup fell back
silently, and those packages were built as version0.0.0— which is what stopped
0.1.0 from publishing. - A release build now fails immediately when the version it resolved is not the one
the tag names, instead of failing at the end after everything is already built. - A failed tag lookup says so loudly, quoting git's own error, rather than
swallowing it and quietly falling back. - README corrections — the microphone page, the unfinished features and the CI
coverage were described as they used to be rather than as they are.
Download
| File | For |
|---|---|
Sonero-0.1.2-x86_64.AppImage |
Take this one. Portable, carries its own Qt, built on the oldest glibc so it runs almost anywhere. |
sonero_0.1.2-ubuntu2204_amd64.deb |
Ubuntu 22.04, Linux Mint 21.x |
sonero_0.1.2-ubuntu2404_amd64.deb |
Ubuntu 24.04, Linux Mint 22.x |
Sonero-0.1.2-arch-x86_64.AppImage |
Arch, or a distribution at least as new |
Sonero-0.1.2-fedora-x86_64.AppImage |
Fedora, or a distribution at least as new |
Upgrading
Drop-in — settings, presets and routing are untouched.
# AppImage: run the new file. It replaces the menu entry and deletes the bundle
# it supersedes, so the old one does not linger in your downloads folder.
chmod +x Sonero-0.1.2-x86_64.AppImage
./Sonero-0.1.2-x86_64.AppImage
# Debian / Ubuntu / Mint
sudo apt install ./sonero_0.1.2-ubuntu2204_amd64.debQuit any running instance from the tray menu first, so the new one takes over the
PipeWire graph rather than handing the launch to the old process.
Still not finished
Unchanged from 0.1.0, and still greyed out and labelled in the app: Profiles, the
microphone controls (the source itself works), and the SteelSeries hardware EQ.
LDAC remains untested.
MIT licensed.
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.