Installation Instruction

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