A tool to download tracks from soundcloud.com
Project description
soundcloud-dl
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 folderpip 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
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
andURL
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!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
soundcloud_dl-0.1.20.tar.gz
(6.3 kB
view hashes)
Built Distribution
Close
Hashes for soundcloud_dl-0.1.20-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 40a9a5b6f89f9a34f5b8d4d565c58cccfc686d7cb5075f6f297f48f3f1faae60 |
|
MD5 | 4999d8cfec97c3640e3ca56c78832521 |
|
BLAKE2b-256 | daa8d466ec340fac36996b20180bd22bb569e6ad26a81f98001cea37b38aa2d4 |