a keyboard-first soundcloud client for desktop
flutter, macos / windows / linux
web soundcloud is fine, tabs are not
desktop clients for it either don't exist or they're electron wrapped around the website. so i made a real native one, closer to canonical soundcloud than other unofficial clients but darker and quieter, and you can run it for hours without touching the trackpad
v0.5.0: installers and updates
a real installer on every platform and the app updates itself: sparkle on macos, winsparkle with a per-user installer on windows, an appimage on linux. it checks once a day, or from settings → about
also: a menu bar player on macos, windows and linux finally play tracks (media_kit) and get window buttons and
waveform://links, my wave forgets what you disliked and leans into what you replay, plus a pile of likes, artist, volume and seek fixesdaily-driver loop works on macos, windows and linux build too but i test them less. the api is unofficial so rough edges stay. everything else in
CHANGELOG.md
open discover in the top bar and press play my wave (you need to be signed in). each batch mixes three sources:
- related (half): tracks related to what you're playing, your newest likes and recent plays, ranked by a small local graph that learns from what you finish, skip and dislike
- your stream (a quarter): fresh uploads and reposts from people you follow
- co-likers (a quarter): people who liked the same tracks as you, and what else they liked. a background job, cached for a day, never stores their ids
tracks you can't play are dropped before they reach the queue, and the wave keeps going after the batch ends. thumbs down skips and teaches it, stop my wave hands the player back. details and the pilots behind it in docs/my-wave.md
- keyboard first. space plays, ⌘K finds anything, arrows seek, ⇧ + arrows skip. enter on a track page plays it
- gapless + crossfade 0-6 s. the next track preloads on a second engine and swaps in on the last sample
- media keys. control center and media keys on macos. windows and linux aren't wired yet, see limitations
- my wave. a nonstop queue of real soundcloud tracks picked on your device, see above
- audio output. pick a core audio device or airplay from the player, macos only. see audio output
- your account. you sign in on soundcloud's own page in a webview, the app never sees your password
- last.fm. off until you connect it
- local stats. top artists, genres and hours from your last 400 plays, counted on your machine
builds are attached to every github release. test builds and news go to telegram first: t.me/waveformsc
- macos (12+): grab the
.dmg, drag into applications. signed and notarized - windows: grab the
-setup.exe(per-user, no admin rights, start menu entry, uninstaller; updates itself). smartscreen asks once (no ev cert yet). a portable.zipis there too - linux: grab the
.AppImage,chmod +x, run it (or use the.tar.gzand./waveform_app)
then sign in via settings → account. details in docs/install.md
| keyboard | the daily loop and every shortcut |
| usage | how i use it |
| features | what works today |
| data and auth | api-v2, sign-in, token storage |
| limitations | drm, best-effort writes, platform gaps |
| roadmap | what's next |
| design | palette, type, logo |
| development | stack, layout, running from source |
| releasing | ci secrets and cutting a tag |
this is an unofficial client, not affiliated with, endorsed by or connected to soundcloud. it uses an undocumented internal api, and using that api may be against soundcloud's terms of service. it's for educational and personal use: use your own account, at your own risk. soundcloud, the soundcloud logo and related marks are trademarks of their owners
the vendored third_party/desktop_webview_window keeps its own apache-2.0 license. the license covers this code only and gives no rights to soundcloud's api, content or trademarks