Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/suyashb95/soundcloud-dl
A Python project that downloads tracks from soundcloud.com, complete with metadata and album art
https://github.com/suyashb95/soundcloud-dl
cli downloader music soundcloud soundcloud-dl
Last synced: 9 days ago
JSON representation
A Python project that downloads tracks from soundcloud.com, complete with metadata and album art
- Host: GitHub
- URL: https://github.com/suyashb95/soundcloud-dl
- Owner: suyashb95
- Created: 2015-05-22T20:08:09.000Z (over 9 years ago)
- Default Branch: dev
- Last Pushed: 2023-05-23T00:51:22.000Z (over 1 year ago)
- Last Synced: 2024-10-29T22:30:36.443Z (11 days ago)
- Topics: cli, downloader, music, soundcloud, soundcloud-dl
- Language: Python
- Homepage:
- Size: 149 KB
- Stars: 125
- Watchers: 8
- Forks: 19
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- jimsghstars - suyashb95/soundcloud-dl - A Python project that downloads tracks from soundcloud.com, complete with metadata and album art (Python)
README
# soundcloud-dl
[](https://pepy.tech/project/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 folder
* `pip install -r "requirements.txt"`
### Getting an API key
* SoundCloud has stopped registering apps so the only way to get an API key is from the dev console
Navigate to soundcloud.com and check for any XHR request params to find a `client_id` that can be used
* Use `sc-dl --set-api-key ` to set the API key
## Usage
#### Options
usage: sc-dl [-h] [-t | -n | -u [URL]] [--set-api-key SET_API_KEY] [-s]
[-d DIR] [-a] [-l] [-e EXCLUDE [EXCLUDE ...]]
[-i INCLUDE [INCLUDE ...]] [--limit LIMIT] [-r RANGE RANGE]
[-g [GENRE]]
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
-u [URL], --url [URL]
URL to download tracks from. If this is a user's
profile, all uploads are fetched unless -a/--all or
-l/--likes are specified
--set-api-key SET_API_KEY
sets the soundcloud API key
-s, --similar Downloads 10 tracks similar to the track in the URL
-d DIR, --dir DIR Directory to save tracks in. Defaults to current
working directory
-a, --all Download all tracks (Uploads and likes). Should be
used along with -u/--url with a user's profile URL
-l, --likes Download only liked tracks. Should be used along with
-u/--url with a user's profile URL
-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
* The -u/--url option can be a link to a user, a track or a user's playlists.
If it's a user profile, all uploads are fetched unless --all or --likes options are specified
* `--top`, `--new` and `--url` arguments are mutually exclusive
* 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!