Providers · chapters · 09 of 25
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://soundcloudset 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
- Go to
soundcloud.com/you/appsand make an app. This needs Artist Pro. - Set the app’s redirect URI to
yafmp://soundcloud. - 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).
- Paste the app’s Client ID and Client secret.
- Choose Sign In with SoundCloud. Your browser opens SoundCloud’s sign-in page.
- Sign in and allow access. The browser hands the answer back to Yafmp, and the SoundCloud rows appear in the library.
Settings
| Setting | Default | What it does |
|---|---|---|
| Enabled | off | Apple: 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
| Problem | Why | What to do |
|---|---|---|
| SoundCloud’s page shows a redirect URI error | The redirect URI in your SoundCloud app is not yafmp://soundcloud | Set it exactly, then sign in again. |
| “SoundCloud rejected the Client ID and secret” | The secret is wrong | Check 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 attempt | Choose 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 Yafmp | Install 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 apps | Open the track on SoundCloud with the link in the info panel. |
| A new like or playlist is missing | Yafmp keeps the lists it has loaded | Restart Yafmp. |