thrash.dev

docs / providers / soundcloud

Providers · chapters · 09 of 25

← Yafmp manual

  1. Local Files
  2. Plex
  3. Navidrome
  4. Jellyfin
  5. Bandcamp
  6. Lidarr
  7. Apple Music
  8. Spotify
  9. SoundCloud
  10. YouTube Music
  11. SiriusXM
  12. Radio
  13. Podcasts
  14. AirPlay
  15. Chromecast
  16. MusicBrainz
  17. Discogs
  18. Labels
  19. Releases
  20. Last.fm
  21. ListenBrainz
  22. Connect
  23. Home Assistant
  24. MCP server
  25. DJ

SoundCloud

Your SoundCloud likes, playlists, feed and follows, and search. Needs your own SoundCloud app (Artist Pro).

facts

status
beta
kind
source
on by default
no
needs
SoundCloud account, Your own SoundCloud API app (Client ID and secret)
platforms
iPhone, iPad, Mac, Vision Pro, Android, Android TV, Linux, FreeBSD, Windows

Description

SoundCloud puts your SoundCloud account in Yafmp’s library panel and plays its streams. It uses SoundCloud’s official API with an API app that you register yourself.

The library shows Liked Tracks, Playlists (yours and the ones you liked), Feed, Following, Recently Played and My Tracks (your uploads). Search covers users, playlists and tracks.

The info panel credits the uploader and links to the track’s page on SoundCloud, as SoundCloud’s terms ask.

SoundCloud is off by default. It is not on Apple TV.

Requirements

  • A SoundCloud account.
  • Your own SoundCloud API app, with its Client ID and client secret. SoundCloud only issues these to Artist Pro accounts.
  • The redirect URI yafmp://soundcloud set in that app.
  • A web browser on the device you sign in on. The sign-in happens in your default browser and comes back to Yafmp through a yafmp:// link.
  • Desktop: Yafmp installed from a package or installer, so that yafmp:// links open it. On Linux and FreeBSD the package’s menu entry handles the links. On Windows the installed app registers them each time it starts.

Setup

  1. Go to soundcloud.com/you/apps and make an app. This needs Artist Pro.
  2. Set the app’s redirect URI to yafmp://soundcloud.
  3. In Yafmp, open Preferences → Plugins → SoundCloud and switch on Enabled (Apple), or open Settings → SoundCloud and turn on the switch at the top (Android and desktop).
  4. Paste the app’s Client ID and Client secret.
  5. Choose Sign In with SoundCloud. Your browser opens SoundCloud’s sign-in page.
  6. Sign in and allow access. The browser hands the answer back to Yafmp, and the SoundCloud rows appear in the library.

Settings

SettingDefaultWhat it does
EnabledoffApple: switches the plugin on. On Android and desktop this is the switch at the top of the SoundCloud pane.
Client ID—The Client ID of your SoundCloud app. Shown while signed out.
Client secret—The secret of your SoundCloud app. Shown while signed out.
Sign In with SoundCloud—Opens SoundCloud’s sign-in page in your browser.
Signed in—The SoundCloud user name. Read-only.
Disconnect—Tells SoundCloud to forget the sign-in, and removes the token and every loaded list from Yafmp.

On Apple the Client ID and secret are shared between your devices through iCloud Keychain. The sign-in itself is per device, so choose Sign In with SoundCloud once on each one.

Limits

  • Streams are HLS, AAC at 160 kbit/s where SoundCloud offers it, otherwise MP3 at 128 kbit/s. Nothing is lossless.
  • Tracks are streamed and never saved to disk. SoundCloud’s terms do not allow caching.
  • Some tracks are marked “preview only”: SoundCloud gives only a preview of them. Tracks marked “not streamable” cannot be played at all.
  • Playing a whole folder skips the preview-only and blocked tracks.
  • Feed and a followed user’s tracks load the newest 400. Following shows up to 200 users.
  • The lists are loaded once and kept until you restart Yafmp. Something you liked a moment ago shows after a restart.
  • On Apple, SoundCloud plays outside the audio engine that the equalizer, compressor and visualizers use, so they do not apply.

Troubleshooting

ProblemWhyWhat to do
SoundCloud’s page shows a redirect URI errorThe redirect URI in your SoundCloud app is not yafmp://soundcloudSet it exactly, then sign in again.
“SoundCloud rejected the Client ID and secret”The secret is wrongCheck the secret at soundcloud.com/you/apps and paste it again.
“SoundCloud’s answer didn’t match this sign-in”The link came from an older sign-in attemptChoose Sign In with SoundCloud again and finish in the page that opens.
The browser finishes, but Yafmp stays signed out (desktop)yafmp:// links do not open YafmpInstall Yafmp from a package or installer, start it once, then sign in again.
“can’t be streamed (SoundCloud blocks it)”The uploader or SoundCloud does not allow the track in other appsOpen the track on SoundCloud with the link in the info panel.
A new like or playlist is missingYafmp keeps the lists it has loadedRestart Yafmp.