Skip to content

SpotifyDl

Latest
Latest
Compare
Choose a tag to compare
@SpectreGame17 SpectreGame17 released this 24 Feb 18:22
· 5 commits to main since this release
v1.1.0
6dbe443

🎵 SpotifyDl - v1.1

SpotifyDl is a simple and efficient tool for downloading songs and playlists from Spotify by retrieving metadata and searching for tracks on YouTube. It is designed for both Windows and Mac, ensuring easy usability and high performance.

🔒 The RAR file is password-protected. The password is: 1234
⚠️ The .exe file may be detected as a virus. In that case, use the source code directly, just install the requirements and have Python installed!!!

🚀 Features

✅ Download songs and playlists from Spotify by extracting metadata.
✅ Multithreading support for fast downloads.
✅ Automatic duplicate check, avoiding unnecessary re-downloads.
✅ Custom output folder support, with automatic invalid path detection.
✅ Smart cleanup function, removing entries if the folder no longer exists or the Spotify link is invalid.
✅ Supports different quality settings, recommended at 192kbps.
✅ Command-line execution support for easy integration.

📌 Installation

🔧 1. Install FFmpeg

SpotifyDl requires FFmpeg. You can download it from:
https://ffmpeg.org/download.html

Recommended installation method (Windows):
Use Chocolatey to install it easily:
https://chocolatey.org/install

After installing, ensure FFmpeg is added to your system PATH.

🔑 2. Get Spotify API Keys

To use SpotifyDl, you need to obtain API credentials:

  1. Go to Spotify Developer Dashboard.
  2. Create a new application.
  3. Copy your Client ID and Client Secret and configure them in the program.

⚙️ Usage

🏁 First Run - Initial Setup

On the first run, SpotifyDl will guide you through an initial configuration:

  • Set download quality (recommended: 192kbps).
  • Define your output folder.
  • Configure the number of threads (recommended: CPU threads - 2 for optimal performance).
  • Avoid downloading directly to a USB drive, as it may cause database issues.

🎼 Downloading a Song or Playlist

To download a track or playlist, simply run:
download
The program will:

  • Extract metadata from Spotify.
  • Search for the song on YouTube.
  • Download and save the track with proper metadata.

🔍 How It Works

1️⃣ Fetching Data from Spotify

  • The program accesses Spotify's API to extract playlist information, including track names, artists, and album details.
  • If a Spotify link is invalid, it is removed from the database and logged in the console.

2️⃣ Downloading from YouTube

  • The script uses yt-dlp to find and download the correct song based on metadata from Spotify.
  • If a download fails, it retries or skips to the next song

3️⃣ Handling Files & Folders

  • If the specified folder doesn’t exist, the program will remove the entry from the database.
  • Duplicate downloads are automatically avoided by checking if the file already exists.

4️⃣ Multithreading for Speed

  • The script downloads multiple songs in parallel, using CPU threads.

5️⃣ Automatic Cleanup

  • Entries with missing folders.
  • Invalid Spotify links (notified in the console).

🛠 Support & Issues

If you find a bug or need help, open an issue on GitHub:
https://github.com/SpectreGame17/SpotifyDowloader/issues

Enjoy your music! 🎶🚀

Full Changelog: v1.0.0...v1.1.0

Assets 3
Loading