You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

3.3 KiB

PyPI version PyPI version PyPI version

Soundcloud Music Downloader


This script is able to download music from and set id3tag to the downloaded music. It should work with OS X, Linux, Windows.

System requirements

  • Python3



pip3 install scdl


git clone && cd scdl
python3 install

(Optional) Setup your path and your auth_token in $HOME/.config/scdl/scdl.cfg


Get your auth token here:

  • This allows scdl to access to your user profile data.
  • You need to have this set to be able to use the me option
  • Soon scdl will be able to download a user's stream



  scdl -l <track_url> [-a | -f | -t | -p][-c][-o <offset>][--hidewarnings][--debug | --error][--path <path>][--addtofile][--onlymp3][--hide-progress]
  scdl me (-s | -a | -f | -t | -p)[-c][-o <offset>][--hidewarnings][--debug | --error][--path <path>][--addtofile][--onlymp3][--hide-progress]
  scdl -h | --help
  scdl --version


# Download track & repost of the user QUANTA
scdl -l -a

# Download likes of the user Blastoyz
scdl -l -f

# Download one track
scdl -l

# Download one playlist
scdl -l


  -h --help          Show this screen
  --version          Show version
  me                 Use the user profile from the auth_token
  -l [url]           URL can be track/playlist/user
  -s                 Download the stream of an user (token needed)
  -a                 Download all track of an user (including repost)
  -t                 Download all upload of an user
  -f                 Download all favorite of an user
  -p                 Download all playlist of an user
  -c                 Continue if a music already exist
  -o [offset]        Begin with a custom offset
  --path [path]      Use a custom path for this time
  --hidewarnings     Hide Warnings. (use with precaution)
  --addtofile        Add the artist name to the filename if it isn't in the filename already
  --onlymp3          Download only the mp3 file even if the track is Downloadable
  --error            Only print debug information (Error/Warning)
  --debug            Print every information and
  --hide-progress    Hide the wget progress bar


  • Automatically detect the type of link provided
  • Download all songs from a user
  • Download all songs and reposts from a user
  • Download all songs from one playlist
  • Download all songs from all playlists from a user
  • Download all songs from a user's favorites
  • Set the tags with mutagen (Title / Artist / Album = Playlist / Artwork)
  • Create playlist files when downloading a playlist


GPL v2, original author Flyingrub