Repository navigation
What's new
- Copy what's playing. A copy button next to the like heart puts "Title — Artist · Album" on your clipboard, and its icon turns into a check mark for a moment so you know it worked. Press C or use the tray's Copy track for the same thing. Right-click the cover art to copy the title, artist or album on its own. In TIMELINE, click (or right-click) any track under PLAYED to copy that one, which helps when the song you wanted was two tracks ago. (#53)
- System-wide shortcuts on macOS and Windows. Turn them on in the back panel, then hold Ctrl+Opt+Shift (Ctrl+Alt+Shift on Windows) and press P to play or pause, M to mute, L to like, or C to copy the track, from any app. They're off by default because a system-wide shortcut takes that key combination away from every other app. If another app already uses one, the switch says so. Shift is part of the combination so it doesn't collide with AltGr letters like ł or ć on Windows keyboards. Linux doesn't get them yet: the toolkit has no global-shortcut support there.
- A long show name no longer pushes the top-bar buttons off the window. The show and the context line (time of day, vibe, weather) now get cut short with "…" instead.
- The keyboard shortcuts list in the back panel now includes Y (lyrics) and C (copy).
- Built on Native SDK 0.11.1.
Downloads
| File | Platform | Notes |
|---|---|---|
SUBWAVE-Player-0.12.0.dmg |
macOS (Apple Silicon: M1/M2/M3/M4) | Ad-hoc signed: allow it once in System Settings (below) |
SUBWAVE-Player-0.12.0-intel.dmg |
macOS (Intel, 2020 and earlier Macs) | Ad-hoc signed: allow it once in System Settings (below) |
SUBWAVE-Player-0.12.0-windows-x64.zip |
Windows x64 | Built on real Windows in CI, which also launches the binary as a smoke test |
SUBWAVE-Player-0.12.0-linux-x64.deb |
Debian 13+, Ubuntu 24.04+ and derivatives, x64 | sudo apt install ./<file> |
SUBWAVE-Player-0.12.0-linux-x64.rpm |
Fedora and openSUSE, x64 | sudo dnf install ./<file>; unsigned, so zypper needs --allow-unsigned-rpm |
SUBWAVE-Player-0.12.0-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.12.0-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.11.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.11.1 (vercel-labs/native#156). 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.1...v0.12.0