https://github.com/daniel-191/spotify-downloader
Download your spotify playlists, albums and tracks! (completely for free)
https://github.com/daniel-191/spotify-downloader
downloader music-downloader playlist-downloader spotify spotify-api spotify-downloader spotify-playlist youtube youtube-downloader yt-dlp yt-downloader
Last synced: 23 days ago
JSON representation
Download your spotify playlists, albums and tracks! (completely for free)
- Host: GitHub
- URL: https://github.com/daniel-191/spotify-downloader
- Owner: Daniel-191
- License: mit
- Created: 2025-09-07T20:17:30.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-09-07T20:40:56.000Z (about 1 month ago)
- Last Synced: 2025-09-07T22:22:13.490Z (about 1 month ago)
- Topics: downloader, music-downloader, playlist-downloader, spotify, spotify-api, spotify-downloader, spotify-playlist, youtube, youtube-downloader, yt-dlp, yt-downloader
- Language: Python
- Homepage:
- Size: 14.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎵 Spotify Downloader
Download your **Spotify playlists, albums, and tracks** for free!
This script takes a **Spotify link** (album, playlist, or track) and downloads the corresponding audio directly from **YouTube**, converting it with `ffmpeg`.
---
## 🔄 How It Works
```mermaid
flowchart LR
A[Spotify Link: Playlist, Album, or Track] --> B[Find Match on YouTube]
B --> C[Download Audio]
C --> D[Convert with ffmpeg]
D --> E[Save as MP3 or Audio File]
```
---
## ✨ Features
- 🔗 Paste a **Spotify link** (playlist / album / track) and let the script do the rest
- 📂 Downloads full **playlists**, **albums**, or single tracks
- 🎶 Converts audio to common formats using `ffmpeg`
- âš¡ Simple setup with `install.bat` / `install.sh`
- 🖥 Cross-platform support: **Windows**, **macOS**, **Linux**
---
## 📦 Requirements
Make sure you have the following before starting:
- [Python 3.8+](https://www.python.org/downloads/)
- [ffmpeg](https://ffmpeg.org/download.html) (must be installed manually)
- Internet connection (to fetch from Spotify + YouTube)
---
## 🔧 Installation
### 1. Clone the repository
```bash
git clone https://github.com/yourusername/spotify-downloader.git
cd spotify-downloader
```
### 2. Install dependencies
- **Windows:** Double-click `install.bat`
- **macOS/Linux (Terminal):**
```bash
chmod +x install.sh
./install.sh
```
### 3. Install `ffmpeg`
You’ll need `ffmpeg` installed and accessible in your system PATH.
- **Windows:**
1. Download from [ffmpeg.org](https://ffmpeg.org/download.html).
2. Extract the folder (e.g., `ffmpeg-6.0-full_build`).
3. Add the `bin` folder to your PATH environment variable.
- **macOS (Homebrew):**
```bash
brew install ffmpeg
```
- **Linux (Debian/Ubuntu):**
```bash
sudo apt update
sudo apt install ffmpeg
```
---
## 🚀 Usage
- **Windows (easy way):**
Just double-click `main.py` to run the program.
- **macOS/Linux (Terminal):**
```bash
python3 main.py
```
When prompted, paste a Spotify link:
- 🎵 Track → downloads the song from YouTube
- 💿 Album → downloads all songs in the album
- 🎶 Playlist → downloads the entire playlist
The script will fetch the best match from YouTube and automatically convert it to an audio file.
---
## 🖥 Supported Operating Systems
- ✅ Windows
- ✅ macOS
- ✅ Linux
---
> [!WARNING]
> This project is for **educational purposes only**.
> Please support artists by streaming legally on [Spotify](https://spotify.com).
---