Skip to content
mollykittenPublic

About

a keyboard-first soundcloud client for desktop. flutter, macos / windows / linux

Topics

Resources

Contributing

Stars

6 stars

Watchers

0 watching

Forks

Repository files navigation

waveform app icon: five bars, three orange, two grey

waveform

a keyboard-first soundcloud client for desktop
flutter, macos / windows / linux

CI Flutter Platforms Version Telegram

waveform track page with ambient cover backdrop, waveform and timecoded comments

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 fixes

daily-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

my wave screen: a pause button over an orange ribbon ring, with the upcoming wave queue below

how my wave works

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

what you get

  • 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

⌘K palette over the blurred app with live soundcloud results

install

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 .zip is there too
  • linux: grab the .AppImage, chmod +x, run it (or use the .tar.gz and ./waveform_app)

then sign in via settings → account. details in docs/install.md

docs

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

disclaimer

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

license

MIT

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

About

a keyboard-first soundcloud client for desktop. flutter, macos / windows / linux

Topics

Resources

Contributing

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

⌂