Spotitube

A simple way to download your music library from Spotify and YouTube

---

Table of Contents

• Features
• Prerequisites
• Installation
• Configuration
  • Spotify API Setup
  • YouTube Music Cookies
• Usage
• Sponsor
• License

Introduction

Spotitube is a simple CLI tool designed to synchronize and download your music across platforms. Whether you want to back up your Spotify Liked Songs or migrate a YouTube Music playlist to high-quality local MP3s, Spotitube handles the heavy lifting with multi-threaded efficiency.

Features

• Cross-Platform: Fetch tracks from Spotify (liked songs, playlists) and YouTube Music.
• High-Fidelity Downloads: Default 320kbps mp3 extraction using yt-dlp and ffmpeg.
• Multi Threaded Downloads: Multi-threaded architecture for rapid searching and downloading.
• Smart Deduplication: Automatically filters duplicate tracks when merging sources.
• Session Persistence: Securely handles YouTube Music cookies for private library access.

Prerequisites

• Python 3.9+
• FFmpeg: Essential for audio conversion.
  • Windows 10/11: winget install ffmpeg
  • macOS: brew install ffmpeg
  • Linux: Use your package manager. (e.g., sudo apt install ffmpeg for Debian-based systems)

Installation

1. Clone the repository:

   git clone https://github.com/4ngel2769/spotitube.git
   cd spotitube

2. Set up a virtual environment:

   # Windows
   python -m venv venv
   .\venv\Scripts\activate
   
   # macOS/Linux
   python3 -m venv venv
   source venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

Configuration

Spotify API Setup

1. Visit the Spotify Developer Dashboard.
2. Create a new application to obtain your Client ID and Client Secret.
3. Set the Redirect URI to http://127.0.0.1:8888/callback.
4. Create a .env file in the root directory:

   SPOTIFY_CLIENT_ID=your_id_here
   SPOTIFY_CLIENT_SECRET=your_secret_here
   SPOTIFY_REDIRECT_URI=http://127.0.0.1:8888/callback

YouTube Music Cookies

To access private playlists or "Liked Songs":

1. Open music.youtube.com in your browser and log in.
2. Open DevTools (F12) > Network tab.
3. Find any request to music.youtube.com and copy the cookie header value.
4. The script will prompt you to paste this on the first run, or you can manually create ytmusic_cookie.txt.

Usage

Launch the interactive CLI:

python script.py

Quick Start Guide

1. Select Source: Choose Spotify (1), YouTube Music (2), or Both (3).
2. Download Mode: Enter y to download files or n to just generate a JSON report.
3. Select Content: Choose between Liked Songs or specific playlists.
4. Process: The script will begin concurrent processing. Files are saved to i/downloaded_songs/.

Sponsor

If you find this tool useful, consider supporting the development:

License

Distributed under the MIT License. See LICENSE for more information.

---

Built with 💚 by angeldev0