GitHub - Ssenseii/harmoni: 🎧 Download music from Spotify exports

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.

Features

• 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

Installation Options

Option 1: Standalone Executable (Easiest)

Download HARMONI.exe from the Releases page. No Python installation required.

See Standalone Guide for details.

Option 2: Python Installation

# 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.py

Option 3: Docker

docker compose build
docker compose run --rm --service-ports spotify-yt-dlp-downloader

Quick Start

GUI (Recommended)

The easiest way to download your Spotify music:

1. Launch HARMONI.exe or run python gui_main.py
2. Go to exportify.net and log in with Spotify
3. Export your playlists as CSV files
4. Drag and drop the CSV into HARMONI

No Spotify API setup required!

Command Line

python main.py
# or
./start.sh

See CLI Guide for all available commands.

Screenshots

Home	Downloads

YouTube Search	Settings

Requirements

• Standalone EXE: None (ffmpeg bundled)
• Python version: Python 3.9+ and ffmpeg

Documentation

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

License

MIT License - see LICENSE for details.

Disclaimer

This tool is for personal use only. Respect copyright laws and YouTube's terms of service.