Skip to content

SUB/WAVE Desktop 0.8.1

Choose a tag to compare

@perminder-klair perminder-klair released this 04 Aug 08:44
· 37 commits to main since this release

What's new

A Windows fix release. If you are on Windows, this is the one to take. On macOS and Linux nothing looks different, though the new diagnostic log is there too.

  • The Windows build no longer stalls. The symptom was ugly and hard to describe: a white empty window, a busy cursor, almost no CPU use, and the audio still playing perfectly behind it. The cause was the SDK's trace log. It writes one record per rendered frame and per audio callback, and each record is a full open/stat/write/close on a file that grows without bound, done inline on the thread that runs the window. Behind an antivirus filter driver (Bitdefender is where this got caught) that is enough to jam the message pump. Shipping builds now turn that log off, and CI fails the build if any release workflow forgets the flag. Crash reporting is not part of the trace log and still works. (#23, #28)
  • A diagnostic log worth attaching to a bug report. The back panel has a SERVICE section with a "Diagnostic log" row showing the folder it lives in. It records boot, playback, network and error breadcrumbs, it is capped in size, and it is deliberately not per-frame. It is the replacement for the log that caused the bug above, built so it cannot repeat it.
  • Windows renders through Direct2D and DirectWrite, with dirty-region updates instead of the old software RGBA to BGRA copy. That arrives with Native SDK 0.7.2, which this release picks up on the way to 0.8.0.
  • Opening a link on Windows no longer flashes a console window. Every outbound link (the station site, Ko-fi, the release page) briefly popped a black console window when launched from the tray. Also fixed upstream in 0.7.2.
  • Built on Native SDK 0.8.0.

Downloads

File Platform Notes
SUBWAVE-Player-0.8.1.dmg macOS (Apple Silicon: M1/M2/M3/M4) Ad-hoc signed: right-click → Open on first launch
SUBWAVE-Player-0.8.1-intel.dmg macOS (Intel, 2020 and earlier Macs) Ad-hoc signed: right-click → Open on first launch
SUBWAVE-Player-0.8.1-windows-x64.zip Windows x64 Built on real Windows in CI, which also launches the binary as a smoke test
SUBWAVE-Player-0.8.1-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.

Building from source

Requires Zig 0.16 and @native-sdk/cli 0.8.0. 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.0 (vercel-labs/native#156 is open). The v0.8.0 notes said that patch had gone upstream, which was wrong. The script is idempotent and tells you where it stands.

Build releases with native build -Dtrace=off. Without that flag you get the stall described above.

Full Changelog: v0.8.0...v0.8.1