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.
flyingrub 527292b38e somefix 7 years ago
config Default Download path is now current folder 7 years ago
scdl somefix 7 years ago
.gitignore somefix 7 years ago
LICENSE Initial commit 8 years ago Introduce 7 years ago somefix 7 years ago fix: configparser is built in with python3 7 years ago


# Soundcloud Music Downloader ## Description

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



  1. Install scdl pip3 install scdl
  2. (Optional) Setup your path and your auth_token in $HOME/.config/scdl/scdl.cfg


Get your auth token here: Token

  • 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][--addtofile]
  scdl me (-s | -a | -f | -t | -p)[-c][-o <offset>][--hidewarnings][--addtofile]
  scdl -h | --help
  scdl --version


  -h --help          Show this screen.
  --version          Show version.
  me                 Uses the auth_token specified in the config to get access to the user's profile
  -l [url]           URL can be a track, playlist or a user.
  -s                 Download the stream of a user (token needed)
  -a                 Download all of a user's tracks, including reposts
  -t                 Download all of a user's uploads
  -f                 Download all of a user's favorites
  -p                 Download all of a user's playlists
  -c                 Continue if a music already exist
  -o [offset]        Start on a custom offset.
  --hidewarnings     Hide Warnings. Use with precaution
  --addtofile        Add the artist name to the filename if it isn't in the filename already
  --path             Path to download directory, can be set in the config. If none of this is set, it uses the current working directory
  --silent           Disables output, useful for scripters


  • 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 = 'Soundcloud' / Artwork)


GPL v2, orignal author Flyingrub