ytdlp.org

Practical yt-dlp docs: install, commands, fixes, cookies, and workflows.

Current section

Platform guide

How to download SoundCloud tracks with yt-dlp

For a public SoundCloud track, the page URL is all yt-dlp needs. The questions people actually hit are about what comes out: why there's a warning about registered users, why some tracks stop after 30 seconds, and what "This video is DRM protected" means on an audio site.

Quick answer

# the track as m4a (AAC), no conversion
yt-dlp "https://soundcloud.com/<artist>/<track>"

# as MP3 with the title, artist and cover art embedded (needs ffmpeg)
yt-dlp -x --audio-format mp3 --embed-metadata --embed-thumbnail \
  -o "%(uploader)s - %(title)s.%(ext)s" "https://soundcloud.com/<artist>/<track>"

We ran the MP3 command on a public track (November 2026, yt-dlp 2026.10.26): it produced Forss - Flickermood.mp3 with the title and artist tags set and the 600×600 cover attached. If ffmpeg is missing, the conversion step fails; see the ffmpeg fix.

What formats you get

yt-dlp -F on a public track, without logging in, lists two AAC streams (columns trimmed):

ID           EXT RESOLUTION |  TBR PROTO | ACODEC     ABR
hls_aac_96k  m4a audio only |  96k m3u8  | mp4a.40.2  96k
hls_aac_160k m4a audio only | 160k m3u8  | mp4a.40.2 160k

yt-dlp picks the 160k one by default. Converting it to MP3 doesn't add quality, it only changes the container and codec, so keep the m4a unless a player or tool needs MP3. Go+ accounts can see a higher-quality stream marked "Premium" in that list.

"Original download format is only available for registered users"

You'll see this on many tracks:

WARNING: [soundcloud] Original download format is only available for registered users.

It's a warning, and the download still works. It means the artist turned on downloads of the file they uploaded (often a WAV or a higher-bitrate MP3), and SoundCloud only gives that file to signed-in users. If you want it, pass your session from a browser that is logged in to SoundCloud:

yt-dlp --cookies-from-browser firefox -f download "https://soundcloud.com/<artist>/<track>"

The original shows up as format download("Original") and yt-dlp prefers it automatically once it's available. More on browser cookies in using cookies with yt-dlp.

Sets, whole profiles and likes

yt-dlp treats sets (playlists and albums), a profile's tracks and a profile's likes as playlists. Number the files so they keep their order:

# a set, in order
yt-dlp -x --audio-format mp3 \
  -o "%(playlist_title)s/%(playlist_index)02d - %(title)s.%(ext)s" \
  "https://soundcloud.com/<artist>/sets/<set>"

# everything an artist uploaded
yt-dlp -o "%(uploader)s/%(title)s.%(ext)s" "https://soundcloud.com/<artist>/tracks"

# a profile's public likes (may include sets, not just tracks)
yt-dlp "https://soundcloud.com/<user>/likes"

# preview what a URL contains without downloading
yt-dlp --flat-playlist --print "%(url)s" "https://soundcloud.com/<user>/likes"

The other profile tabs work the same way: /albums, /sets and /reposts. Add --download-archive done.txtif you'll rerun it later, so tracks you already have are skipped (more in the playlist guide).

Only 30 seconds downloaded: Go+ tracks

Some tracks are Go+ only. Without a subscription SoundCloud serves a 30-second clip, and yt-dlp marks those streams with preview in the format ID (for example hls_aac_160k_preview) and ranks them last. If the only formats in yt-dlp -F end in _preview, a short file is all an anonymous request can get. Cookies from an account with an active Go+ subscription are the only fix.

"This video is DRM protected"

ERROR: [soundcloud] 2234543525: This video is DRM protected

The wording says "video" because the message is shared across sites, but it applies to audio too. Some SoundCloud tracks are only offered as encrypted streams, and yt-dlp skips those. If no unencrypted stream is left, you get this error. In a November 2026 report (yt-dlp#18040), the track only played in a browser with DRM content enabled, and the issue was closed as wontfix: yt-dlp doesn't download DRM-protected media. Updating yt-dlp, adding cookies or changing -fwon't change the result, so don't spend time on it.

Other errors

  • Geo-restricted: some labels block tracks by country. yt-dlp reports a geo restriction instead of downloading; the track has to be fetched from a country where it plays.
  • Private tracks: use the full secret link the artist shared (it has an extra token after the track name). yt-dlp passes that token on.
  • HTTP Error 429: too many requests, usually from grabbing a large profile in one go. Slow down with --sleep-requests 1 --sleep-interval 3 and resume with a download archive. See avoiding rate limits.

The mistake to avoid

Don't assume a short or failed download is a yt-dlp bug and start updating or swapping flags. Run yt-dlp -F first: _preview formats mean Go+, no formats plus a DRM error means the track is encrypted, and a warning about registered users means the normal download already worked.

If your app takes SoundCloud links that users paste and needs the audio file or a transcript on a server, this SoundCloud download API guide shows the hosted version: one call returns the joined audio file and, if you ask, a transcript.

Recurring sources

Pulling from the same sources on repeat?

Paste a link to preview what a maintained import API returns for it — across 1,000+ sites.

Building this into an app? See the API your backend calls instead

Frequently asked questions

How do I download a SoundCloud track as MP3 with yt-dlp?

Run yt-dlp -x --audio-format mp3 "https://soundcloud.com/<artist>/<track>". It needs ffmpeg. SoundCloud serves AAC in an m4a container, so MP3 is a re-encode; if you don't need MP3 specifically, plain yt-dlp "<track URL>" gives you the m4a without converting.

What does "Original download format is only available for registered users" mean?

It's a warning, not an error. The artist allowed downloads of the original upload, and SoundCloud only hands that file to logged-in users. yt-dlp carries on with the normal stream (AAC, up to 160 kbps without Go+). Pass --cookies-from-browser with a browser that is logged in to SoundCloud if you want the original file.

Why is my SoundCloud download only 30 seconds long?

The track is Go+ only. Without a Go+ subscription SoundCloud serves a 30-second preview, and yt-dlp marks those formats with "preview" in the format ID. Cookies from an account with an active Go+ subscription are the only way to get the full track.

Can yt-dlp download a SoundCloud track that says "This video is DRM protected"?

No. Some SoundCloud tracks are only served as encrypted (DRM) streams, and yt-dlp doesn't download DRM-protected media. A November 2026 report of exactly this error (yt-dlp#18040) was closed as wontfix. Updating, cookies or format flags won't change it.

Straightforward yt-dlp help for installs, commands, fixes, cookies, and repeatable workflows.

ytdlp.org is an independent, community-maintained documentation site. It is not affiliated with the yt-dlp project — the official source code lives at github.com/yt-dlp/yt-dlp.