Skip to content

Sonero 0.1.3 — Arch package and an update check

Choose a tag to compare

@Tatsu21 Tatsu21 released this 18 Sep 23:43
· 24 commits to main since this release

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 PKGBUILD now 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 to api.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
    to 0.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.deb

On 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 .deb and 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 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.3-x86_64.AppImage    # or just: Sonero

MIT licensed.