Repository navigation
SUB/WAVE Desktop 0.9.0
What's new
One new feature, and it is the first time the player can tell you something while you are not looking at it.
-
Track notifications. When the song changes, you get a desktop notification with the track, the artist, and the show it is airing on. It works on macOS, Windows and Linux. It is off by default and lives in the back panel under NOTIFICATIONS, because turning on OS notifications for someone who never asked is not a nice thing for an update to do.
Two rules keep it quiet. It only fires when the player is in the background, since if you are looking at the window the LIVE stage already names the track, and it only fires while you are actually tuned in, because this is a player and not a station ticker. It also stays silent on the first track after launch, which is a quirk of how the station feed fills in rather than a song change.
This is as close to a Now Playing surface as the SDK can currently get. It only pushes: there is still no MPRIS, no macOS Now Playing widget, and no hardware media key support, so nothing outside the app can control playback. Those need SDK support that does not exist yet.
-
Built on Native SDK 0.8.4, up from 0.8.0. Nothing in the app needed changing for the upgrade itself, and the Linux fractional-HiDPI patch still applies cleanly.
Downloads
| File | Platform | Notes |
|---|---|---|
SUBWAVE-Player-0.9.0.dmg |
macOS (Apple Silicon: M1/M2/M3/M4) | Ad-hoc signed: right-click → Open on first launch |
SUBWAVE-Player-0.9.0-intel.dmg |
macOS (Intel, 2020 and earlier Macs) | Ad-hoc signed: right-click → Open on first launch |
SUBWAVE-Player-0.9.0-windows-x64.zip |
Windows x64 | Built on real Windows in CI, which also launches the binary as a smoke test |
SUBWAVE-Player-0.9.0-linux-x64.tar.gz |
Linux x64 | Needs glibc 2.39+ and GTK4 (Ubuntu 24.04+, Fedora 40+, Arch); older distros build from source |
Not sure which Mac you have? → Apple menu → About This Mac. "Apple M…" means the first file; "Intel" means the -intel one.
One thing that reads as a bug if nobody says it: 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.
If notifications do not appear after you turn them on, check that your OS lets the app post them at all (macOS System Settings → Notifications, Windows Settings → Notifications, and a running notification daemon on Linux). The app cannot tell whether the system actually showed one, so it fails silently by design rather than nagging you.
Building from source
Requires Zig 0.16 and @native-sdk/cli 0.8.4. 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.8.4 (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.8.1...v0.9.0