soundcloud-dl

A small command-line program to download tracks from soundcloud.com

================================================================== ##Installation

• Requires Python 2

####Using Pip

• Run pip install soundcloud_dl

####From Source

• Clone the repo or download the zip
• Make sure you have pip installed
• cd to the folder
• pip install -r "requirements.txt"

##Usage

• usage: soundcloud-dl.py [-h] [--url URL] [--dir DIR] [--all] [--likes] [--include] [--exclude] [--limit]
• sc-dl can be used instead of soundcloud-dl
• The url can be a link to a user, a track or a user's playlists. Downloads a user's uploads unless --all or --likes options are given
• Adding the --include option overrides the --exclude option.
• Example : python soundcloud-dl.py --url https://soundcloud.com/stringofasymptotes --dir D:\Music
• Example : python soundcloud-dl.py --url https://soundcloud.com/stringofasymptotes --dir D:\Music --exclude 1 2 3
• Example : python soundcloud-dl.py --url https://soundcloud.com/stringofasymptotes/surrender-and-reality/recommended. Downloads 5 related tracks unless --limit is specified.

##Options -h, --help show this help message and exit --url URL URL to download tracks from. --dir DIR Directory to save tracks in. Default value is the current working directory. --all Download all tracks. (Uploads and likes) --likes Download only liked tracks. --exclude Exclude a list of tracks. (List of space separeted integers) --include Specifically download a list of tracks. (List of space separated integers) --limit Limits the number of tracks to be downloaded. (Single integer) --range Range of track numbers to download. (Two space separated integers)

###Dependencies

• soundcloud - To work with the soundcloud API
• requests - To retrieve HTML
• mutagen - To tag audio files and add album art

###Contributions If you want to add features, improve them, or report issues, feel free to send a pull request!

###Contributors

• Suyash458
• [sam09] (https://github.com/sam09) (Sam Radhakrishnan)