Skip to content

SUB/WAVE Desktop 0.9.2

Choose a tag to compare

@perminder-klair perminder-klair released this 14 Aug 11:06
· 26 commits to main since this release

What's new

One fix, and it's a Linux one.

  • The back panel no longer makes the app unusable on Linux. Opening it cost about a second of input latency on every press and every scroll, and the spectrum visualizer visibly dropped frames while it was open (#36). The cause was a full-viewport Gaussian blur the SDK paints behind every sheet and dialog. On Linux there is no GPU path, so every frame is rasterized on the CPU, and at a typical window size on a fractional-scale desktop that blur works out to roughly 400 million weighted samples per frame. The renderer caches it, but the cache key is a hash of the pixels underneath, so the visualizer animating behind the panel invalidated it about 25 times a second.

    Measured with the SDK's frame profiler, back panel open: input latency went from 580ms to 74ms, and the worst frame from 1.2 seconds to 89ms. The blur is gone entirely, which the design brief called for anyway, and the dim behind the panel stays exactly as it was.

    If you reported the FLAC visualizer running slower than MP3: same cause, and it wasn't the codec. Anything that made the backdrop change more often made the cache miss more often.

    macOS and Windows were never affected, since both render on the GPU.

  • Still built on Native SDK 0.9.0. No SDK change in this release.

One thing this does not fix: on Linux the whole window is redrawn on the CPU every frame with no dirty-rect tracking, so a large or maximized window is expensive regardless of what's on screen. That one belongs upstream in the SDK.

Downloads

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