Skip to content
A soundcloud downloader made in Python
Python
Branch: dev
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
downloader moving back from f strings Nov 2, 2018
.gitignore Change module structure. Add setup.py Oct 11, 2018
README.md update setup.py and readme Nov 24, 2018
__init__.py Added requirements.txt. Added setup.py Sep 8, 2015
config-example.py Change module structure. Add setup.py Oct 11, 2018
requirements.txt update requests to v2.20 Nov 2, 2018
setup.py update setup.py and readme Nov 24, 2018
soundcloud_dl.py

README.md

soundcloud-dl

Downloads

A small command-line program to download tracks from soundcloud.com You'll need to get an API key since there are rate limits on streams

Installation

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"

Getting an API key

  • Log in to Soundcloud and register a new app here. That should give you an API key
  • Navigate to the folder where the package is installed Python36\Lib\site-packages\soundcloud-dl\downloader
  • Create a file called config.py and add your API key there as shown in the file config-example.py

Usage

usage

Options

 soundcloud_dl.py [-h] [-t] [-n] [-s] [-d DIR] [-a] [-l]
                       [-e EXCLUDE [EXCLUDE ...]] [-i INCLUDE [INCLUDE ...]]
                       [--limit LIMIT] [-r RANGE RANGE] [-g [GENRE]]
                       [url]

 positional arguments:
   url                   URL to download tracks from

 optional arguments:
   -h, --help            show this help message and exit
   -t, --top             Downloads the top 10 tracks across all genres
   -n, --new             Downloads 10 new tracks across all genres
   -s, --similar         Downloads 10 tracks similar to the track in the URL
   -d DIR, --dir DIR     Directory to save tracks in. Default value is the
                         current working directory
   -a, --all             Download all tracks (Uploads and likes)
   -l, --likes           Download only liked tracks.
   -e EXCLUDE [EXCLUDE ...], --exclude EXCLUDE [EXCLUDE ...]
                         Enter track numbers to exclude.
   -i INCLUDE [INCLUDE ...], --include INCLUDE [INCLUDE ...]
                         Enter track numbers to include
   --limit LIMIT         Maximum number of tracks to download
   -r RANGE RANGE, --range RANGE RANGE
                         Enter range of tracks to download
   -g [GENRE], --genre [GENRE]
                         use with --top to get top tracks from a specific genre
  • sc-dl can be used instead of soundcloud-dl
  • --top, --new and URL arguments are mutually exclusive
  • 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 : sc-dl https://soundcloud.com/aaasrith --dir D:\Music
  • Example : sc-dl https://soundcloud.com/aaasrith --dir D:\Music --exclude 1 2 3
  • Example : sc-dl https://soundcloud.com/aaasrith/closurewithaclause -s

Contributions

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

You can’t perform that action at this time.