The ultimate solution for DJs to download and organize music from YouTube with Spotify playlist integration, optimized for Pioneer Rekordbox.

Transform your Spotify playlists into a fully organized DJ library with automatic KEY detection (Camelot notation), BPM analysis, and quality filtering - perfect for harmonic mixing!

As a DJ, I faced a critical limitation: Rekordbox doesn't allow editing tracks from Spotify streaming. You can't analyze cue points, loops, or hot cues on Spotify tracks - you need local files.

The problem? Manually downloading hundreds of songs from Spotify playlists was tedious and time-consuming.

The Solution: I discovered two amazing open-source projects:

• spotify-backup by @caseychu - Extract Spotify playlists to JSON
• ytm-dlapi - YouTube Music download concept

I combined and enhanced these tools with:

• ✨ Automatic KEY detection using Essentia (Camelot notation for harmonic mixing)
• 🥁 BPM analysis for perfect beatmatching
• 🎯 Quality filtering (removes LIVE versions, UNRELEASED tracks, short clips)
• 📚 Smart organization (by genre, artist, or custom folders)
• 🔄 Batch processing for hundreds of songs at once

Now you can build a complete Rekordbox library from your Spotify playlists with full editing capabilities!

• Automatic KEY Detection in Camelot notation (1A-12A, 1B-12B) using Essentia
• BPM Detection for perfect beatmatching
• ID3 Metadata Tagging compatible with Rekordbox
• Lyrics Video Priority - Downloads lyrics videos for cleaner audio (no video SFX)
• Audio Quality Filtering (removes UNRELEASED, LIVE versions)
• Duration Filtering (configurable minimum length, default 1:30)

• Folder-based Organization (HOUSE, POP, Artist folders, etc.)
• Batch Processing of entire Spotify playlists
• Automatic MP3 Conversion from YouTube audio
• CSV to TXT Converter for Exportify playlists
• Windows/WSL Integration for seamless cross-platform usage

• Exportify Support - Export playlists to CSV, convert to song list
• Extract Playlists directly from your Spotify library
• Filter by Genre (HOUSE, POP, or custom categories)
• OAuth Authentication for secure access (optional)
• Backup Your Music Library to JSON format

# Clone the repository
git clone https://github.com/Dixter999/rekordbox-spotify-downloader.git
cd rekordbox-spotify-downloader

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install Python dependencies
pip install -r requirements.txt

# Install system dependencies (Ubuntu/Debian/WSL)
sudo apt update && sudo apt install -y ffmpeg

brew install ffmpeg python3

# Ubuntu/Debian/WSL - for Essentia KEY detection
sudo apt install build-essential libeigen3-dev libfftw3-dev \
    libavcodec-dev libavformat-dev libavutil-dev libswresample-dev \
    libsamplerate0-dev libtag1-dev libyaml-dev python3-dev

This is the easiest method - export your Spotify playlist and download all songs!

1. Open Exportify.net in your browser
2. Click "Get Started" and log in with your Spotify account
3. Find your playlist and click the green "Export" button
4. A CSV file will download (e.g., My_Playlist.csv)

📁 Downloads/
   └── My_Playlist.csv   ← Downloaded from Exportify

Move the CSV file to your project folder and convert it:

# Activate the virtual environment
source venv/bin/activate

# Convert the CSV to a text file
python3 convert_csv_to_txt.py My_Playlist.csv

Output:

✓ Converted 85 songs from My_Playlist.csv
✓ Created: My_Playlist.txt

The text file looks like this:

# Converted from My_Playlist.csv
# Total songs: 85

Martin Garrix - Animals
Lost Frequencies - Are You With Me
Avicii - Levels
David Guetta - Titanium
...

Now download all songs to a folder (e.g., HOUSE):

python3 youtube_to_rekordbox_enhanced.py My_Playlist.txt --output rekordbox_music/HOUSE --prefer-lyrics

Example Output:

═══════════════════════════════════════════════
  YouTube to Rekordbox MP3 Downloader Enhanced
═══════════════════════════════════════════════
Total songs: 85
Output directory: /home/user/rekordbox_music/HOUSE
Duration filter: 1:30 - 10:00
Prefer lyrics: Yes
═══════════════════════════════════════════════

[1/85] Processing: Martin Garrix - Animals
    Folder: rekordbox_music/HOUSE
    🔍 Searching for video...
    🎤 Found lyrics version
    ✓ Title: Martin Garrix - Animals (Lyrics)
    ⏱ Duration: 5:04
    ⬇ Downloading...
    🎵 Detecting musical KEY...
    🎹 KEY detected: 4A
    ✓ Downloaded successfully

[2/85] Processing: Lost Frequencies - Are You With Me
    Folder: rekordbox_music/HOUSE
    🔍 Searching for video...
    🎤 Found lyrics version
    ✓ Title: Lost Frequencies - Are You With Me (Lyrics)
    ⏱ Duration: 2:22
    ⬇ Downloading...
    🎵 Detecting musical KEY...
    🎹 KEY detected: 4B
    ✓ Downloaded successfully

[3/85] Processing: Avicii - Levels
    ⏭ SKIPPED: Already exists as 'Levels (Lyrics).mp3'

...

══════════════════════════════════════════════════
  DOWNLOAD SUMMARY
══════════════════════════════════════════════════
Total processed: 85
✓ Downloaded: 72
⏭ Already existed: 10
⊘ Skipped (quality): 2
✗ Failed: 1

⊘ Songs skipped (low quality):
   - DJ Snake - Turn Down for What (too long: 12:34)
   - Random Artist - Live at Festival (contains: live)

📁 Songs saved to: /home/user/rekordbox_music/HOUSE

💡 Next step: Import the folder into Rekordbox

1. Open Rekordbox
2. Go to File → Import → Import Folder
3. Select rekordbox_music/HOUSE
4. Your songs are now ready with KEY (Camelot notation) already tagged! 🎹

# 1. Setup (only once)
git clone https://github.com/Dixter999/rekordbox-spotify-downloader.git
cd rekordbox-spotify-downloader
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# 2. Download your playlist from Exportify.net and move it here
mv ~/Downloads/Summer_Hits_2025.csv .

# 3. Convert to song list
python3 convert_csv_to_txt.py Summer_Hits_2025.csv

# 4. Download all songs
python3 youtube_to_rekordbox_enhanced.py Summer_Hits_2025.txt --output rekordbox_music/SUMMER --prefer-lyrics

# 5. Done! Your music is in rekordbox_music/SUMMER/
ls rekordbox_music/SUMMER/

Don't have Spotify? Just create a text file manually:

1. Create my_songs.txt:

Martin Garrix - Animals
Avicii - Levels
Calvin Harris - Summer
David Guetta - Titanium

2. Download:

source venv/bin/activate
python3 youtube_to_rekordbox_enhanced.py my_songs.txt --output rekordbox_music/EDM --prefer-lyrics

Examples:

# Download to HOUSE folder with lyrics preference
python3 youtube_to_rekordbox_enhanced.py playlist.txt --output rekordbox_music/HOUSE --prefer-lyrics

# Download with custom duration limits (2-8 minutes)
python3 youtube_to_rekordbox_enhanced.py playlist.txt --output rekordbox_music/POP --min-duration 120 --max-duration 480

# Download without lyrics preference
python3 youtube_to_rekordbox_enhanced.py playlist.txt --output rekordbox_music/EDM --no-lyrics

Already have MP3 files? Add KEY detection to them:

# Update all folders
./update_all_metadata.sh

# Update specific folder
python3 update_metadata.py rekordbox_music/HOUSE

rekordbox-spotify-downloader/
├── youtube_to_rekordbox_enhanced.py    # Main download script with filters
├── convert_csv_to_txt.py               # Convert Exportify CSV to song list
├── update_metadata.py                   # Update KEY/BPM for existing files
├── update_all_metadata.sh              # Batch metadata updater
├── extract_spotify_playlists.py        # Extract playlists from JSON
├── spotify-backup/                     # Spotify OAuth integration (optional)
│   └── spotify-backup.py               # Backup Spotify library
├── requirements.txt                    # Python dependencies
├── README.md                           # This file
├── LICENSE                             # MIT License
└── examples/                           # Example song lists
    ├── example_house.txt
    ├── example_pop.txt
    └── martin_garrix_set.txt

The downloader automatically filters out:

• UNRELEASED tracks
• LIVE versions (concert recordings)
• Songs shorter than 90 seconds (configurable)

Edit youtube_to_rekordbox_enhanced.py to customize:

skip_keywords = [
    'unreleased',
    'live',
    'live at',
    'concert',
    'tour'
]

Default: rekordbox_music/

To use a Windows path with WSL:

ln -s /mnt/c/Users/YOUR_USERNAME/Music/RekordboxDownloads rekordbox_music

The system uses Camelot Wheel notation for harmonic mixing:

Harmonic Mixing Rules:

• Mix tracks with the same number (e.g., 8A → 8B)
• Mix tracks ±1 on the wheel (e.g., 8A → 9A or 7A)

This project integrates several powerful tools:

• yt-dlp - YouTube downloader (replaces youtube-dl)
• Essentia - Music information retrieval for KEY and BPM detection
• Mutagen - Python library for audio metadata
• FFmpeg - Audio/video processing

• spotify-backup - Backup Spotify playlists to JSON
• Spotify Web API - Access Spotify data

═══════════════════════════════════════════════
  YouTube to Rekordbox MP3 Downloader Enhanced
═══════════════════════════════════════════════

[1/267] Processing: Martin Garrix - Animals
    Folder: rekordbox_music/HOUSE
    🔍 Searching video...
    ✓ Title: Martin Garrix - Animals (Official Video)
    ⏱ Duration: 5:20
    ⬇ Downloading...
    🎵 Detecting musical KEY...
    🎹 KEY detected: 4A
    💾 BPM detected: 128
    ✓ Downloaded successfully

Solution:

pip install essentia-tensorflow

Solution:

# Ubuntu/WSL
sudo apt install ffmpeg

# macOS
brew install ffmpeg

Solution: Use WSL and symlink:

ln -s /mnt/c/Users/YOUR_USERNAME/Music rekordbox_music

Solution: Ensure FFmpeg is installed and in PATH

Contributions are welcome! Please feel free to submit a Pull Request.

git clone https://github.com/Dixter999/rekordbox-spotify-downloader.git
cd rekordbox-spotify-downloader
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

• Add support for other music platforms (SoundCloud, Beatport)
• GUI interface
• Docker container
• Advanced playlist management
• Duplicate detection ✅ Implemented!
• Waveform generation
• BPM detection integration

This project is licensed under the MIT License - see the LICENSE file for details.

This tool is for personal use only. Please respect copyright laws and only download music you have the rights to access. Consider supporting artists by:

• Purchasing music on Beatport
• Subscribing to Spotify
• Buying tracks on Bandcamp
• Supporting artists on SoundCloud

YouTube Terms of Service: Review YouTube's Terms of Service before using this tool.

• Build your Rekordbox library from Spotify playlists
• Harmonic mixing with automatic Camelot key detection
• Organize by genre (HOUSE, Techno, Pop, etc.)
• Filter low-quality live recordings and unreleased tracks

• Sample collection organized by key and BPM
• Reference tracks for your productions
• Analyze song structure with precise BPM data

• Offline music library from your Spotify favorites
• High-quality MP3s with proper metadata
• Organized collection by artist or genre

This project stands on the shoulders of amazing open-source work:

• spotify-backup by @caseychu - The foundation for Spotify playlist extraction
• ytm-dlapi by @Thanatoslayer6 - Initial concept for YouTube Music downloads

• yt-dlp team - Powerful YouTube downloader that makes this possible
• Music Technology Group (MTG) - Creators of Essentia for music analysis
• Mutagen contributors - Python audio metadata library
• FFmpeg team - Universal audio/video processing

• Pioneer DJ for creating Rekordbox, the best DJ software for professional mixing
• The DJ community for inspiring this project and providing feedback

If you encounter any issues or have questions:

1. Check the Issues page
2. Open a new issue with:
   • Your OS and Python version
   • Error message/log
   • Steps to reproduce

If this project helped you, please ⭐ star it on GitHub!

Made with ❤️ for the DJ community