A Python tool for downloading music from Spotify and YouTube using yt-dlp. Available as a standalone executable, desktop GUI application, or command-line interface.
- Desktop GUI - Modern graphical interface with drag-and-drop Exportify support
- Spotify Integration - Download from your playlists and liked songs via OAuth
- YouTube Downloads - Download from links or search by artist/song
- Batch Downloads - Download entire playlists with concurrent processing
- Exportify Support - Import playlists from CSV exports (easiest method!)
- Metadata Embedding - Automatic ID3 tagging for MP3 files
- Library Management - Duplicate detection, cleanup, and organization
Download HARMONI.exe from the Releases page. No Python installation required.
See Standalone Guide for details.
# Clone and install
git clone https://github.com/Ssenseii/spotify-yt-dlp-downloader.git
cd spotify-yt-dlp-downloader
pip install -r requirements.txt
# Run the GUI
python gui_main.py
# Or run the CLI
python main.pydocker compose build
docker compose run --rm --service-ports spotify-yt-dlp-downloaderThe easiest way to download your Spotify music:
- Launch
HARMONI.exeor runpython gui_main.py - Go to exportify.net and log in with Spotify
- Export your playlists as CSV files
- Drag and drop the CSV into HARMONI
No Spotify API setup required!
python main.py
# or
./start.shSee CLI Guide for all available commands.
| Home | Downloads |
|---|---|
|
 |
| YouTube Search | Settings |
|---|---|
 |
 |
- Standalone EXE: None (ffmpeg bundled)
- Python version: Python 3.9+ and ffmpeg
See the docs/ folder for detailed guides:
- Installation Guide - Full setup instructions
- GUI Guide - Using the desktop application
- CLI Guide - Command-line interface reference
- Standalone Guide - Using the executable
- Spotify Setup - Connect your Spotify account
- Configuration - Settings reference
- Docker - Container deployment
MIT License - see LICENSE for details.
This tool is for personal use only. Respect copyright laws and YouTube's terms of service.