Repository navigation
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.