Installation

Dependencies

Do not forget to install ffmpeg and to add it to your PATH.

SCDL

There are various methods for installing scdl. It is recommended to use pipx:

Install with pipx

brew install ffmpeg pipx
pipx install scdl

Update:

pipx upgrade scdl

Install with PIP

pip3 install scdl

Update:

pip3 install scdl --upgrade

Install from the github repo

pip3 install git+https://github.com/flyingrub/scdl

Update:

pip3 install git+https://github.com/flyingrub/scdl --upgrade

Using OS Specific package manager

Arch Linux

yay -S soundcloud-dl-git

Gentoo

layman -fa glicOne
sudo emerge -av net-misc/scdl

Authentication

• Find your OAuth token by visiting SoundCloud after logging in and opening developer console (press F12) and going to the Storage tab. Then under cookies > soundcloud.com you can find the entry called oauth_token
• Place OAuth token in the config file (see below)
• You need to have this set to be able to use the me option
• You need to have this set to download original files (which may be lossless) if they are available
• If you have a GO+ account it will allow you to download some songs in 256 kbps AAC quality, and songs which are only available with GO+

Config file locations

• Windows: C:\Users\username\.config\scdl\scdl.cfg
• Mac/Linux: ~/.config/scdl/scdl.cfg
• If XDG_CONFIG_HOME is set: $XDG_CONFIG_HOME/scdl/scdl.cfg

Your scdl.cfg should look at least like this:

[DEFAULT]
oauth_token=XXXXXXXXXXX