README.md

# Multi-Platform Audio Downloader

[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org/)
[![yt-dlp](https://img.shields.io/badge/yt--dlp-Downloader-orange.svg)](https://github.com/yt-dlp/yt-dlp)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/algorembrant/Spotify-2-MP3.svg?style=social)](https://github.com/algorembrant/Spotify-2-MP3/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/algorembrant/Spotify-2-MP3.svg?style=social)](https://github.com/algorembrant/Spotify-2-MP3/network/members)

A high-speed, multi-threaded script to convert Spotify, YouTube, and YouTube Music links into high-quality MP3 files using `yt-dlp`.

## Features
- **Fast**: Concurrent downloads using multiple threads.
- **Versatile**: Supports Spotify, YouTube, and YouTube Music links.
- **Easy**: No API keys or developer accounts required.
- **Convenient**: Handles multiple links at once.

## Prerequisites
- **Python 3.8+**
- **FFmpeg**: Required for MP3 conversion.
  - **Windows**: [Download here](https://ffbinaries.com/downloads), extract `ffmpeg.exe` and `ffprobe.exe`, and add their folder to your system **PATH**.
  - **macOS**: `brew install ffmpeg`
  - **Linux**: `sudo apt install ffmpeg`

## Installation
1. Clone the repository or download the script.
2. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

## Usage
Run the script followed by one or more track links:
```bash
# Spotify
python spotify_to_mp3.py "https://open.spotify.com/track/..."

# YouTube
python spotify_to_mp3.py "https://www.youtube.com/watch?v=..."

# YouTube Music
python spotify_to_mp3.py "https://music.youtube.com/watch?v=..."

# Multiple links
python spotify_to_mp3.py "LINK_1" "LINK_2" "LINK_3"
```

### Options
- `-o`, `--output`: Specify output directory (Default: current directory).
- `-w`, `--workers`: Number of concurrent downloads (Default: 4).

```bash
python spotify_to_mp3.py "link1" "link2" -o ./downloads -w 8
```

## Disclaimer
This tool is for educational purposes only. Please respect the artists and terms of service of the platforms involved.