The easiest way to run this is to fork and run via github actions.
This project provides a Python script for downloading entire playlists from SoundCloud. It uses 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 optionally 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.
- Python 3.10+
- yt-dlp
- FFmpeg
- Poetry
You have 2 options:
- The simplest and fastest way to get your own hosted version
- Simply fork this repo and run via Github action
- Clone this repository:
git clone https://github.com/cainky/soundclouddownloader.git- Install the required Python packages:
poetry install- 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 and add it to your PATH.
- Run the script:
cd soundclouddownloader
poetry run python main.py-
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, just use the Share button to get the private link. -
Enter Y/n if you want the script to create a zip file of all the tracks.
-
Enter the output directory where you want the files to be saved (or press Enter to use the
outputdirectory). -
The script will download all tracks in the playlist, convert them to MP3, and optionally create a zip file containing all the tracks.
poetry run python -m unittest discoverThis project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for details.
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.