https://github.com/dhopcs/soundcloud-dl
An easy, fast and efficient tool written in Rust for downloading songs from SoundCloud.
https://github.com/dhopcs/soundcloud-dl
rust rust-lang soundcloud soundcloud-api soundcloud-dl soundcloud-downloader
Last synced: about 1 month ago
JSON representation
An easy, fast and efficient tool written in Rust for downloading songs from SoundCloud.
- Host: GitHub
- URL: https://github.com/dhopcs/soundcloud-dl
- Owner: dhopcs
- License: lgpl-3.0
- Created: 2024-11-03T03:48:40.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-11-06T22:57:09.000Z (over 1 year ago)
- Last Synced: 2025-08-24T02:10:02.462Z (10 months ago)
- Topics: rust, rust-lang, soundcloud, soundcloud-api, soundcloud-dl, soundcloud-downloader
- Language: Rust
- Homepage:
- Size: 175 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# soundcloud-dl
An easy, fast and efficient tool written in Rust for downloading songs from SoundCloud.
## Getting Started
### Getting Your OAuth Token
1. Log into SoundCloud in your browser
2. Open Developer Tools (F12)
3. Go to the Network tab
4. Reload the page
5. Filter for a request to `https://api-v2.soundcloud.com` in the list
6. Copy the `Authorization` header value from the request headers
7. Use the copied value as the OAuth token
## Installation
### Pre-built Binaries
Head over to the [releases page](http://github.com/damaredayo/soundcloud-dl/releases) and download the latest binary for your platform.
### Cargo
```bash
cargo install --git https://github.com/damaredayo/soundcloud-dl
```
### Building from Source
```bash
git clone https://github.com/damaredayo/soundcloud-dl
cd soundcloud-dl
cargo build --release
```
## Example Usage
```bash
# Download track without saving token
soundcloud-dl -a YOUR_TOKEN track https://soundcloud.com/user/track
# Save token
soundcloud-dl --auth "OAuth 2-123456-133742069-xDxDxDxDxDxDxD" --save-token
# Download a single track
soundcloud-dl track https://soundcloud.com/user/track
# Download a playlist
soundcloud-dl playlist https://soundcloud.com/user/playlist
# Download liked tracks
soundcloud-dl likes --limit 50 --skip 10
```
### Help
```text
An easy, fast and efficient tool written in Rust for downloading songs from SoundCloud.
Usage: soundcloud-dl [OPTIONS] [COMMAND]
Options:
-a, --auth Your Soundcloud OAuth token (if not provided, will use stored token)
-t, --save-token Save the provided OAuth token for future use
--clear-token Clear the stored OAuth token
--ffmpeg-path FFmpeg binary path (if not provided, will use `ffmpeg` from PATH or download it)
-o, --output Output directory for downloaded files [default: .]
-h, --help Print help
-V, --version Print version
Commands:
track
URL of the track to download
likes
-s, --skip Number of likes to skip [default: 0]
-l, --limit Maximum number of likes to download [default: 10]
--chunk-size Number of likes to download in each chunk [default: 25]
-h, --help
playlist
URL of the playlist to download
help Print this message or the help of the given subcommand
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.