error - javascript disabled
javascript is required for this site to function properly.

make sure javascript is enabled in your browser settings
use a web browser that supports javascript
make sure your content blocker isn't blocking https://fridg3.org/main.js

once you've fixed the issue, refresh the page and things should work properly.

YouTube Music Playlist Downloader

A tool I've made to download YT Music playlists with full song metadata from Spotify!

2025-01-23

YouTube Music Playlist Downloader is a command-line Python utility for downloading YouTube Music Playlists with ID3 tagging (title, artist, album, cover, track number and release date), using Spotify as a resource for metadata.

Download it from the GitHub repository.

Requirements

You are required to provide your own Spotify Client ID and Secret. To obtain these, go to .

Log in, go to the dashboard and click "Create App"
Fill in mandatory fields, ensure Redirect URIs has one URL
Tick "Web API", then click "I understand..." and Save
Go to your new app and click on "Settings"

This page will contain your Client ID and Secret.

Python setup

(Don't worry about this unless you're running this from source code)

FFmpeg comes with the Windows version of the software. Nothing to worry about! But if you're using Linux or running from source, you'll need to download it yourself.

sudo apt install ffmpeg
sudo dnf install ffmpeg
sudo pacman -S ffmpeg

For Python, download FFmpeg from the official website . You'll be prompted to specify the path for the executable.

Installation

For Windows and Linux

On Windows, go to Releases, then download and run the install.exe file.

On Linux, go to Releases and download the .tar.gz file. Extract it, then run the install.sh script as sudo.

sudo sh ./install.sh

This will copy the executable to /usr/bin, and copy a shortcut to /usr/share/applications.

Usage

On first run, the program will ask you for your Spotify Client ID and Client Secret. Provide these as prompted. You can also specify a custom directory for playlists to be placed.

You can then paste the URL for a YouTube or YouTube Music playlist. Specify a target bitrate in Kbps (e.g. 192, 320, etc.) and the program will do the rest.

For best quality (but larger file size), choose 320Kbps.

In the event that the program cannot find the song on Spotify, you'll be notified and only the title and artist metadata will be saved.

The program will generate a .m3u file as it downloads songs, this can be imported into most music players to create the playlist automatically.

Downloaded gallery

Configuration

Your settings (preferred download directory, API token, etc.) are saved in a location depending on your OS.

Windows: C:\Users\YourName\AppData\Local\YTMusic-Playlist-Downloader
Linux: /home/YourName/.config/YTMusic-Playlist-Downloader

If you run the program without going through first-time setup, you'll be unable to run the program again. Delete the YTMusic-Playlist-Downloader directory in these locations, and try again.

Uninstall

Linux users can uninstall the program by running uninstall.sh as root.

Windows users can uninstall by navigating to the install location (typically C:\Program Files\fridg3.org\YTMusic-Playlist-Downloader\uninstall.exe).

WARNING: Your configuration file will not be deleted on uninstall! For security, you should navigate to your configuration folder and delete it manually.
end of page