Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cainky/soundclouddownloader
Download SoundCloud songs and playlists
https://github.com/cainky/soundclouddownloader
soundcloud soundcloud-downloader
Last synced: 2 months ago
JSON representation
Download SoundCloud songs and playlists
- Host: GitHub
- URL: https://github.com/cainky/soundclouddownloader
- Owner: cainky
- License: gpl-3.0
- Created: 2024-07-14T06:01:59.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-09-30T04:19:55.000Z (3 months ago)
- Last Synced: 2024-10-10T00:42:04.449Z (2 months ago)
- Topics: soundcloud, soundcloud-downloader
- Language: Python
- Homepage:
- Size: 10.6 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# SoundCloud Downloader
## Description
This project provides a Python script for downloading entire playlists from SoundCloud. It uses [yt-dlp](https://github.com/yt-dlp/yt-dlp) to handle the downloading process, making it robust against changes in SoundCloud's website structure. The script downloads each track in the playlist, converts them to MP3 format, and packages them into a zip file.
This project uses Poetry for dependency management and packaging. If you haven't installed Poetry yet, you can do so by following the [official installation guide](https://python-poetry.org/docs/#installation).
## Requirements
- Python 3.10+
- yt-dlp
- FFmpeg
- Poetry
## Installation
1. Clone this repository:
```python
git clone https://github.com/cainky/soundclouddownloader.git
cd soundclouddownloader
```
2. Install the required Python packages:
```python
poetry install
```
3. Install FFmpeg:
- On Ubuntu or Debian: `sudo apt-get install ffmpeg`
- On macOS with Homebrew: `brew install ffmpeg`
- On Windows, download from the [official FFmpeg website](https://www.ffmpeg.org/download.html) and add it to your PATH.
## Usage
1. Run the script:
```python
poetry run python main.py
```
2. When prompted, enter the URL of the SoundCloud playlist you want to download. Paste the entire url including the `?si=` part. Playlist can be private.
3. Enter the output directory where you want the files to be saved (or press Enter to use the `output` directory).
4. The script will download all tracks in the playlist, convert them to MP3, and create a zip file containing all the tracks.
## Running tests
```bash
poetry run python -m unittest discover
```
## License
This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the [LICENSE](./LICENSE) file for details.
## Disclaimer
This tool is for educational purposes only. Please respect copyright laws and SoundCloud's terms of service when using this script. The authors are not responsible for any misuse of this software.