mirror of
https://github.com/Ssenseii/harmoni.git
synced 2026-04-25 23:45:57 +03:00
🎧 Download music from Spotify exports
|
|
||
|---|---|---|
| .github/workflows | ||
| data | ||
| docs | ||
| downloader | ||
| export | ||
| gui | ||
| history | ||
| images | ||
| managers | ||
| menus | ||
| spotify_api | ||
| tests | ||
| tools | ||
| utils | ||
| .dockerignore | ||
| .gitignore | ||
| build-macos.sh | ||
| changelog.md | ||
| config.json.example | ||
| config.py | ||
| constants.py | ||
| docker-compose.yml | ||
| Dockerfile | ||
| gui_main.py | ||
| HARMONI.spec | ||
| LICENSE | ||
| main.py | ||
| readme.md | ||
| requirements.txt | ||
| start.sh | ||
HARMONI
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 from the Releases page:
- Windows:
HARMONI.exe— double-click to run - macOS:
HARMONI-macos-arm64.dmg(Apple Silicon) — open the DMG and drag HARMONI to Applications
No Python installation required. FFmpeg is bundled.
See Standalone Guide for details.
Option 2: Python Installation
# Clone and install
git clone https://github.com/Ssenseii/harmoni.git
cd harmoni
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 harmoni
Option 4: Build macOS from Source
On any Mac with Python 3.12+ and Homebrew:
chmod +x build-macos.sh
./build-macos.sh
This produces a HARMONI-macos-<arch>.dmg with ffmpeg bundled.
Quick Start
GUI (Recommended)
The easiest way to download your Spotify music:
- Launch HARMONI (exe, app, or
python 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!
Command Line
python main.py
# or
./start.sh
See CLI Guide for all available commands.
Screenshots
| Home | Downloads |
|---|---|
|
 |
| YouTube Search | Settings |
|---|---|
 |
 |
Requirements
- Standalone EXE/DMG: 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.