Skip to content

SUB/WAVE Desktop 0.11.1

Choose a tag to compare

@perminder-klair perminder-klair released this 10 Nov 01:10
· 7 commits to main since this release

What's new

Linux gets real packages. The player itself is the same as 0.11.0.

  • One install command per distro. Until now Linux was a tarball: unpack it, install GTK4 and GStreamer yourself, no menu entry. This release adds a .deb, an .rpm and a pacman package. Each pulls in what the player needs through your package manager, adds SUBWAVE Player to the app menu with its icon, and uninstalls cleanly.

    sudo apt install ./SUBWAVE-Player-0.11.1-linux-x64.deb            # Debian 13+, Ubuntu 24.04+, Mint, Pop!_OS
    sudo dnf install ./SUBWAVE-Player-0.11.1-linux-x64.rpm            # Fedora
    sudo zypper install --allow-unsigned-rpm ./SUBWAVE-Player-0.11.1-linux-x64.rpm   # openSUSE
    sudo pacman -U ./SUBWAVE-Player-0.11.1-linux-x64.pkg.tar.zst      # Arch, Manjaro, EndeavourOS

    On Arch, download the file first and install the local copy. Handing pacman the release URL fails, because pacman insists on a signature for anything it fetches itself and these packages are unsigned:

    curl -LO https://github.com/getsubwave/subwave-desktop/releases/download/v0.11.1/SUBWAVE-Player-0.11.1-linux-x64.pkg.tar.zst
    sudo pacman -U ./SUBWAVE-Player-0.11.1-linux-x64.pkg.tar.zst

    Every release now installs each package in a Debian 13, Ubuntu 24.04, Fedora, openSUSE Tumbleweed and Arch container before it is published, so a dependency that doesn't resolve stops the release instead of reaching you. That checks the install, not the sound: nobody has listened on each of those distros yet.

    The packages don't add a repository, so an update is a fresh download. The player tells you when one is out.

  • macOS and Windows are rebuilt from the same source with no changes.

Downloads

File Platform Notes
SUBWAVE-Player-0.11.1.dmg macOS (Apple Silicon: M1/M2/M3/M4) Ad-hoc signed: allow it once in System Settings (below)
SUBWAVE-Player-0.11.1-intel.dmg macOS (Intel, 2020 and earlier Macs) Ad-hoc signed: allow it once in System Settings (below)
SUBWAVE-Player-0.11.1-windows-x64.zip Windows x64 Built on real Windows in CI, which also launches the binary as a smoke test
SUBWAVE-Player-0.11.1-linux-x64.deb Debian 13+, Ubuntu 24.04+ and derivatives, x64 sudo apt install ./<file>
SUBWAVE-Player-0.11.1-linux-x64.rpm Fedora and openSUSE, x64 sudo dnf install ./<file>; unsigned, so zypper needs --allow-unsigned-rpm
SUBWAVE-Player-0.11.1-linux-x64.pkg.tar.zst Arch and derivatives, x64 Download, then sudo pacman -U ./<file> (not the URL: pacman wants a signature for remote files)
SUBWAVE-Player-0.11.1-linux-x64.tar.gz Any other Linux x64 Needs GTK 4.12+ and GStreamer installed by hand

Not sure which Mac you have? → Apple menu → About This Mac. "Apple M…" means the first file; "Intel" means the -intel one.

Linux needs GTK 4.12 or newer, which leaves out Debian 12 and Ubuntu 22.04; those build from source. AAC streams additionally need the GStreamer libav plugin, which the .deb and .rpm recommend; MP3 and the Ogg mounts work without it.

The Mac downloads aren't notarized yet, so the first launch gets blocked with a warning that macOS can't check the app. Open System Settings → Privacy & Security, scroll down to the SUBWAVE Player line and click Open Anyway. You only do this once.

Closing the window keeps the music playing on macOS and Windows, where the app lives on in the tray. On Linux, closing the window quits, because the GTK host has no tray to bring it back from.

Building from source

Requires Zig 0.16 and @native-sdk/cli 0.10.1. After installing the CLI, run ./scripts/apply-sdk-patches.sh: there is one local patch left, a fractional-HiDPI fix for Linux text rendering, and it is still needed on 0.10.1 (vercel-labs/native#156 is open). The script is idempotent and tells you where it stands.

Build releases with native build -Dtrace=off. Without that flag the SDK's per-frame trace log can stall the window on Windows, which is what v0.8.1 fixed.

Full Changelog: v0.11.0...v0.11.1