---

---

---

⚡ Quick Start: pip install spotdown && spotdown

📋 Table of Contents

• ✨ Features
• 🛠️ Installation
• ⚙️ Setup
• ⚙️ Configuration
• 💻 Usage

Features

• 🎵 Download individual songs from Spotify
• 📋 Download entire playlists with ease
• 🔍 No authentication required - uses web scraping
• 🎨 Automatic cover art embedding (JPEG format)
• ⚡ Simple command-line interface - just run spotdown!

Installation

Method 1: PyPI (Recommended)

pip install spotdown

That's it! You can now run spotdown from anywhere in your terminal.

Method 2: From Source

If you prefer to install from source:

git clone https://github.com/Arrowar/spotdown.git
cd spotdown
pip install -r "requirements.txt"
python run.py

Prerequisites

The following dependencies will be automatically installed:

• Python 3.8+

Setup

1. Go to the Spotify Developer Dashboard
2. Log in and create a new application
3. Copy your Client ID and Client Secret
4. Open the config.json file and add your credentials in the SPOTIFY section:

{
    "SPOTIFY": {
        "client_id": "your_spotify_client_id_here",
        "client_secret": "your_spotify_client_secret_here"
    }
}

5. Save the file. SpotDown will automatically load these credentials from the configuration file.

Configuration

SpotDown uses a JSON configuration file with the following structure:

{
    "DEFAULT": {
        "debug": false,
        "clean_console": true,
        "show_message": true
    },
    "SPOTIFY": {
        "client_id": "your_spotify_client_id_here",
        "client_secret": "your_spotify_client_secret_here"
    },
    "DOWNLOAD": {
        "allow_metadata": true,
        "auto_first": false,
        "quality": "320K",
        "thread": 5
    },
    "SEARCH": {
        "limit": 5,
        "exclude_emoji": false
    }
}

Configuration Options

DEFAULT Settings

• debug: Enable/disable debug mode (detailed logging)
• clean_console: Clear console output for a cleaner interface
• show_message: Display informational messages during execution

SPOTIFY Settings

• client_id: Your Spotify API Client ID from the Developer Dashboard
• client_secret: Your Spotify API Client Secret from the Developer Dashboard

DOWNLOAD Settings

• allow_metadata: Enable downloading of thumbnails and embedding metadata in the final file.
• auto_first: Automatically select the first search result.
• quality: Audio quality (320K recommended for best quality).
• thread: Number of concurrent downloads for batch operations.

SEARCH Settings

• limit: Maximum number of results shown for each search
• exclude_emoji: Exclude emojis from search results

Usage

Starting SpotDown

Simply run the following command in your terminal:

spotdown

The interactive interface will guide you through the download process.

Download Individual Songs

1. Run spotdown
2. Paste the Spotify song URL when prompted
3. The script will automatically:
   • Extract song information
   • Search for the best quality version
   • Download as MP3 with embedded cover art

Download Playlists

1. Run spotdown
2. Paste the Spotify playlist URL when prompted
3. All songs in the playlist will be downloaded automatically

Example Usage

$ spotdown
🎵 Welcome to SpotDown!
Please paste your Spotify URL: https://open.spotify.com/track/4iV5W9uYEdYUVa79Axb7Rh
🔍 Processing: Song Name - Artist Name
⬇️ Downloading...
✅ Download complete!

To Do

• Support for additional music platforms
• Album art quality selection
• Custom output directory configuration

Disclaimer

This 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.

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.

---

Made with ❤️ for music lovers

If you find this project useful, consider starring it! ⭐