scdl 0,1 python

Python Soundcloud Music Downloader

PyPI version PyPI version PyPI version

Soundcloud Music Downloader


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

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

Authentication (WIP)

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

Related Repositories



Python Soundcloud Music Downloader ...



Soundcloud Music Downloader ...

Top Contributors

flyingrub davidfischer-ch zunayed nutztherookie e2del mauricebasement bradenbest walshie4 dwb Glitch-is jatenate madssj nablaa Spotlight0xff invalid-email-address


-   v1.3.3b1 zip tar
-   v1.3 zip tar
-   v1.0.3 zip tar
-   v1.0.2 zip tar
-   v1.0.1 zip tar
-   v1.0 zip tar