{"id":31013904,"url":"https://github.com/arrowar/spotdown","last_synced_at":"2025-09-14T07:42:51.665Z","repository":{"id":314053258,"uuid":"1052125493","full_name":"Arrowar/SpotDown","owner":"Arrowar","description":"A lightweight command-line tool to download songs and playlists from Spotify URLs via YouTube, automatically embedding cover art.","archived":false,"fork":false,"pushed_at":"2025-09-09T09:28:09.000Z","size":72,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-10T10:20:23.883Z","etag":null,"topics":["download-music","downloader","mp3","playwright","python","python36","scraping","spotify","spotify-api","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":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Arrowar.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-09-07T13:08:30.000Z","updated_at":"2025-09-09T09:28:12.000Z","dependencies_parsed_at":"2025-09-10T10:20:26.908Z","dependency_job_id":"17fc7ee4-6252-4c2d-8be6-a49bad8e5263","html_url":"https://github.com/Arrowar/SpotDown","commit_stats":null,"previous_names":["arrowar/spotdown"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/Arrowar/SpotDown","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arrowar%2FSpotDown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arrowar%2FSpotDown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arrowar%2FSpotDown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arrowar%2FSpotDown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Arrowar","download_url":"https://codeload.github.com/Arrowar/SpotDown/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arrowar%2FSpotDown/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274930355,"owners_count":25375717,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["download-music","downloader","mp3","playwright","python","python36","scraping","spotify","spotify-api","yt-dlp"],"created_at":"2025-09-13T06:51:09.431Z","updated_at":"2025-09-13T06:51:12.250Z","avatar_url":"https://github.com/Arrowar.png","language":"Python","funding_links":["https://www.paypal.com/donate/?hosted_button_id=UXTWMT8P6HE2C"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n## 📊 Project Status \u0026 Info\n[![PyPI Version](https://img.shields.io/pypi/v/spotdown?logo=pypi\u0026logoColor=white\u0026labelColor=2d3748\u0026color=3182ce\u0026style=for-the-badge)](https://pypi.org/project/spotdown)\n[![Last Commit](https://img.shields.io/github/last-commit/Arrowar/spotdown?logo=git\u0026logoColor=white\u0026labelColor=2d3748\u0026color=805ad5\u0026style=for-the-badge)](https://github.com/Arrowar/spotdown/commits)\n[![Issues](https://img.shields.io/github/issues/Arrowar/spotdown?logo=github\u0026logoColor=white\u0026labelColor=2d3748\u0026color=ed8936\u0026style=for-the-badge)](https://github.com/Arrowar/spotdown/issues)\n[![License](https://img.shields.io/github/license/Arrowar/spotdown?logo=gnu\u0026logoColor=white\u0026labelColor=2d3748\u0026color=e53e3e\u0026style=for-the-badge)](https://github.com/Arrowar/spotdown/blob/main/LICENSE)\n\n## 💝 Support the Project\n\n[![Donate PayPal](https://img.shields.io/badge/💳_Donate-PayPal-00457C?style=for-the-badge\u0026logo=paypal\u0026logoColor=white\u0026labelColor=2d3748)](https://www.paypal.com/donate/?hosted_button_id=UXTWMT8P6HE2C)\n\n## 🚀 Download \u0026 Install\n\n[![Windows](https://img.shields.io/badge/🪟_Windows-0078D4?style=for-the-badge\u0026logo=windows\u0026logoColor=white\u0026labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_win.exe)\n[![macOS](https://img.shields.io/badge/🍎_macOS-000000?style=for-the-badge\u0026logo=apple\u0026logoColor=white\u0026labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_mac)\n[![Linux latest](https://img.shields.io/badge/🐧_Linux_latest-FCC624?style=for-the-badge\u0026logo=linux\u0026logoColor=black\u0026labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_linux_latest)\n[![Linux 22.04](https://img.shields.io/badge/🐧_Linux_22.04-FCC624?style=for-the-badge\u0026logo=linux\u0026logoColor=black\u0026labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_linux_previous)\n\n---\n\n*⚡ **Quick Start:** `pip install spotdown \u0026\u0026 spotdown`*\n\n\u003c/div\u003e\n\n## 📋 Table of Contents\n\n- [✨ Features](#features)\n- [🛠️ Installation](#️installation)\n- [⚙️ Setup](#setup)\n- [⚙️ Configuration](#configuration)\n- [💻 Usage](#usage)\n\n## Features\n\n- 🎵 **Download individual songs** from Spotify\n- 📋 **Download entire playlists** with ease\n- 🔍 **No authentication required** - uses web scraping\n- 🎨 **Automatic cover art embedding** (JPEG format)\n- ⚡ **Simple command-line interface** - just run `spotdown`!\n\n## Installation\n\n### Method 1: PyPI (Recommended)\n\n```bash\npip install spotdown\n```\n\nThat's it! You can now run `spotdown` from anywhere in your terminal.\n\n### Method 2: From Source\n\nIf you prefer to install from source:\n\n```bash\ngit clone https://github.com/Arrowar/spotdown.git\ncd spotdown\npip install -r \"requirements.txt\"\npython run.py\n```\n\n### Prerequisites\n\nThe following dependencies will be automatically installed:\n\n- **Python 3.8+**\n\n## Setup\n\n1. Go to the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard/)\n2. Log in and create a new application\n3. Copy your **Client ID** and **Client Secret**\n4. Create a file named `.env` in the SpotDown directory with the following content:\n\n```\nSPOTIPY_CLIENT_ID=your_client_id_here\nSPOTIPY_CLIENT_SECRET=your_client_secret_here\n```\n\n5. Save the file. SpotDown will automatically load these credentials.\n\n## Configuration\n\nSpotDown uses a JSON configuration file with the following structure:\n\n```json\n{\n    \"DEFAULT\": {\n        \"debug\": false,\n        \"clean_console\": true,\n        \"show_message\": true\n    },\n    \"DOWNLOAD\": {\n        \"allow_metadata\": true,\n        \"auto_first\": false,\n        \"quality\": \"320K\",\n        \"thread\": 5\n    },\n    \"SEARCH\": {\n        \"limit\": 5,\n        \"exclude_emoji\": false\n    }\n}\n```\n\n### Configuration Options\n\n#### DEFAULT Settings\n- **`debug`**: Enable/disable debug mode (detailed logging)\n- **`clean_console`**: Clear console output for a cleaner interface\n- **`show_message`**: Display informational messages during execution\n\n#### DOWNLOAD Settings\n- **`allow_metadata`**: Enable downloading of thumbnails and embedding metadata in the final file.\n- **`auto_first`**: Automatically select the first search result.\n- **`quality`**: Audio quality (320K recommended for best quality).\n- **`thread`**: Number of concurrent downloads for batch operations.\n\n#### SEARCH Settings\n- **`limit`**: Maximum number of results shown for each search\n- **`exclude_emoji`**: Exclude emojis from search results\n\n## Usage\n\n### Starting SpotDown\n\nSimply run the following command in your terminal:\n\n```bash\nspotdown\n```\n\nThe interactive interface will guide you through the download process.\n\n### Download Individual Songs\n\n1. Run `spotdown`\n2. Paste the Spotify song URL when prompted\n3. The script will automatically:\n   - Extract song information\n   - Search for the best quality version\n   - Download as MP3 with embedded cover art\n\n### Download Playlists\n\n1. Run `spotdown`\n2. Paste the Spotify playlist URL when prompted\n3. All songs in the playlist will be downloaded automatically\n\n### Example Usage\n\n```bash\n$ spotdown\n🎵 Welcome to SpotDown!\nPlease paste your Spotify URL: https://open.spotify.com/track/4iV5W9uYEdYUVa79Axb7Rh\n🔍 Processing: Song Name - Artist Name\n⬇️ Downloading...\n✅ Download complete!\n```\n\n## To Do\n\n- [ ] Support for additional music platforms\n- [ ] Album art quality selection\n- [ ] Custom output directory configuration\n\n## Disclaimer\n\nThis software is provided \"as is\", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. \n\n**Important**: This tool is intended for educational purposes and personal use only. Users are responsible for ensuring they comply with applicable laws and platform terms of service. The developers do not encourage or condone piracy or copyright infringement.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ for music lovers**\n\n*If you find this project useful, consider starring it! ⭐*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farrowar%2Fspotdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farrowar%2Fspotdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farrowar%2Fspotdown/lists"}