{"id":31067248,"url":"https://github.com/daniel-191/spotify-downloader","last_synced_at":"2026-05-18T02:05:09.258Z","repository":{"id":325480875,"uuid":"1101351647","full_name":"Daniel-191/Spotify-Downloader","owner":"Daniel-191","description":"Download your music! (GUI, Webpage, CLI - Cross Platform)","archived":false,"fork":false,"pushed_at":"2026-01-09T21:01:47.000Z","size":73,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-01T23:46:03.699Z","etag":null,"topics":["application","cli","desktop-app","desktop-application","downloader","downloadermp3","downloaders","gradio","music","music-downloader","pyqt5","python","spotify","spotify-api","spotify-downloader","spotify-downloader-gui","webapp","webpage","website","yt-dlp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Daniel-191.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-21T14:53:43.000Z","updated_at":"2026-01-09T21:01:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Daniel-191/Spotify-Downloader","commit_stats":null,"previous_names":["daniel-191/collaborative","daniel-191/spotify-downloader"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/Daniel-191/Spotify-Downloader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daniel-191%2FSpotify-Downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daniel-191%2FSpotify-Downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daniel-191%2FSpotify-Downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daniel-191%2FSpotify-Downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Daniel-191","download_url":"https://codeload.github.com/Daniel-191/Spotify-Downloader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daniel-191%2FSpotify-Downloader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30077065,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T08:01:56.766Z","status":"ssl_error","status_checked_at":"2026-03-04T08:00:42.919Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["application","cli","desktop-app","desktop-application","downloader","downloadermp3","downloaders","gradio","music","music-downloader","pyqt5","python","spotify","spotify-api","spotify-downloader","spotify-downloader-gui","webapp","webpage","website","yt-dlp"],"created_at":"2025-09-15T19:52:09.906Z","updated_at":"2026-05-18T02:05:09.252Z","avatar_url":"https://github.com/Daniel-191.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎵 Spotify Downloader \n\nDownload your **Spotify playlists, albums, and tracks** for free!\nThis script takes a **Spotify link** (album, playlist, or track) and downloads the corresponding audio directly from **YouTube**, converting it with `ffmpeg`.\n\n--- \n\n## ✨ Features\n- Paste a **Spotify link** (playlist / album / track) and let the script do the rest\n- Downloads full **playlists**, **albums**, or single tracks\n- Converts audio to **MP3** format using `ffmpeg`\n- Beautiful **colored console output** with progress bars\n- **Modern PyQt6 GUI** - Clean, modern desktop interface\n- **Web Interface** - Gradio-based web UI for browser access\n- Simple setup with **automated installation scripts**\n- Cross-platform support: **Windows**, **macOS**, **Linux**\n- **Multiple extraction methods** - Tries different approaches to fetch track lists\n- **Error handling** - Automatically retries failed downloads\n\n---\n\n## Preview\n\u003cimg width=\"653\" height=\"613\" alt=\"image\" src=\"https://github.com/user-attachments/assets/3f2bc8c7-4af3-48d6-a8dc-fbeac84957bc\" /\u003e\n\n\n---\n\n## 📦 Requirements\nMake sure you have the following before starting:\n- [Python 3.10+](https://www.python.org/downloads/)\n- [ffmpeg](https://ffmpeg.org/download.html) (required for MP3 conversion)\n- Internet connection (to fetch from Spotify + YouTube)\n\n---\n\n## 🔧 Installation\n\n### 1. Clone the repository\n```bash\ngit clone https://github.com/Daniel-191/Spotify_Downloader\ncd Spotify_Downloader\n```\n\n### 2. Install dependencies\n- **Windows:** Double-click `install.bat` or run:\n  ```bash\n  install.bat\n  ```\n\n- **macOS/Linux (Terminal):**\n  ```bash\n  chmod +x install.sh\n  ./install.sh\n  ```\n\n- **Manual Installation:**\n  ```bash\n  pip install -r requirements.txt\n  ```\n\n### 3. Install `ffmpeg`\nYou'll need `ffmpeg` installed and accessible in your system PATH.\n\n- **Windows:**\n  1. Download ffmpeg from [ffmpeg.org/download.html](https://ffmpeg.org/download.html)\n  2. Extract the downloaded ZIP file to a folder\n  3. Add ffmpeg to your system PATH:\n     - Open **System Properties** → **Environment Variables**\n     - Under **System Variables**, find and edit **Path**\n     - Add the path to ffmpeg's `bin` folder\n     - Click **OK** to save\n  4. Restart your command prompt and verify with: `ffmpeg -version`\n\n  **Need help?** Watch this tutorial for guidance: https://www.youtube.com/watch?v=jZLqNocSQDM\u0026t=33s\n\n- **macOS (Homebrew):**\n  ```bash\n  brew install ffmpeg\n  ```\n\n- **Linux (Debian/Ubuntu):**\n  ```bash\n  sudo apt update\n  sudo apt install ffmpeg\n  ```\n\n- **Linux (Fedora):**\n  ```bash\n  sudo dnf install ffmpeg\n  ```\n\n- **Linux (Arch):**\n  ```bash\n  sudo pacman -S ffmpeg\n  ```\n\n---\n\n## 🚀 Usage\n\n### Choose Your Interface\n\nThis application offers three different interfaces:\n\n#### 1️⃣ Desktop GUI (PyQt6) - **Recommended**\n\nLaunch the modern desktop application:\n- **Double-click** `run_gui.pyw`\n- **Or run:** `python run_gui.pyw`\n\n#### 2️⃣ Web Interface (Gradio)\n\nLaunch the web-based interface:\n\n```bash\npython main.py\n# or\npython3 main.py\n```\n\nAccess through your browser at `http://localhost:7860`\n\n#### 3️⃣ Command Line Interface (CLI)\n\nFor terminal users:\n\n```bash\npython cli.py \"https://open.spotify.com/playlist/...\"\n```\n\n### Using the Downloader\n\nWhen prompted, paste a Spotify link:\n- **Track** → `https://open.spotify.com/track/...` → downloads the song\n- **Album** → `https://open.spotify.com/album/...` → downloads all songs in the album\n- **Playlist** → `https://open.spotify.com/playlist/...` → downloads the entire playlist\n\nThe script will:\n1. Extract track information from Spotify\n2. Search for each track on YouTube\n3. Download the best audio match\n4. Convert to MP3 format\n5. Save to the `downloaded/` folder\n\n---\n\n## 🖥 Supported Operating Systems\n- ✅ Windows\n- ✅ macOS\n- ✅ Linux\n\n---\n\n## 📝 Dependencies\nThis project uses the following Python packages:\n\n| Package | Purpose |\n|---------|---------|\n| [yt-dlp](https://github.com/yt-dlp/yt-dlp) | YouTube downloading |\n| [requests](https://requests.readthedocs.io/) | HTTP requests to Spotify |\n| [colorama](https://github.com/tartley/colorama) | Colored terminal output |\n| [urllib3](https://urllib3.readthedocs.io/) | HTTP client utilities |\n| [gradio](https://www.gradio.app) | Web interface |\n| [PyQt6](https://www.riverbankcomputing.com/software/pyqt/) | Desktop GUI framework |\n\n**External Dependencies:**\n- [FFmpeg](https://ffmpeg.org/) - Audio conversion (must be installed separately)\n\n---\n\n\u003e [!WARNING]\n\u003e This project is for **educational purposes only**.\n\u003e Downloading copyrighted content without permission may violate copyright laws.\n\u003e Please support artists by streaming legally on [Spotify](https://spotify.com) or purchasing their music.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniel-191%2Fspotify-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaniel-191%2Fspotify-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniel-191%2Fspotify-downloader/lists"}