Awesome

Spotify Downloader

Spotify Downloader is an application that allows you to easily download songs from spotify without the need of Spotify Premium through an easy to use GUI and many customisable settings to get the output that you desire.

Contents

• Installation
• Usage
• Features
• License
• FAQ
• Credits

Installation

Only currently supports windows. Other platforms may be coming soon

The latest release can be found Here. Installer Recommended

Follow the instructions below depending on your chosen install type.

Note: Installer requires administrator privileges otherwise install will fail

IF A WINDOW COMES UP SHOWING "Windows protected your PC" click:

• More Info
• Run Anyway

This popup generally comes up when windows defender does not know much about a program being installed without a publisher. Since my program is not verified by microsoft, this will show up on first launch for almost everyone. There is not really anything that I can do about this.

Choose your install location. Default is "C:/Program Files/Spotify Downloader" but you can change this to anywhere you like.

Note: If the program is already installed in the chosen location, it will overwrite and update the old install

<img src="https://github.com/WilliamSchack/Spotify-Downloader/assets/54973797/ed720dd2-1862-4247-8714-b1ba9f8b3c4c" width="50%" height="50%">

Select the Spotify Downloader component (selected by default)

<img src="https://github.com/WilliamSchack/Spotify-Downloader/assets/54973797/8d64c8a9-1453-4b2d-b2ee-cf40742f31d3" width="50%" height="50%">

The program will add a shortcut to the start menu and the name can be changed here

<img src="https://github.com/WilliamSchack/Spotify-Downloader/assets/54973797/0a8b4ec7-8fd1-41ea-a522-0182c0f0ebca" width="50%" height="50%">

Click install and wait for the installer to finish

<img src="https://github.com/WilliamSchack/Spotify-Downloader/assets/54973797/d4e1628a-031a-4735-b454-ecb5b2cea886" width="50%" height="50%">

Now click Finish and the program is ready to be ran

<img src="https://github.com/WilliamSchack/Spotify-Downloader/assets/54973797/563d6a7a-2c8c-47ab-b45e-00d4c8939ab9" width="50%" height="50%">

You can open the program through the start menu or from the installed location through "Spotify Downloader.exe"

Unzip the file to any location through your chosen unzipping software.

<img src="https://github.com/WilliamSchack/Spotify-Downloader/assets/54973797/acdfb267-7f91-49be-8c93-aca623b8749f" width="50%" height="50%">

The program can now be ran through "Spotify Downloader.exe"

<img src="https://github.com/WilliamSchack/Spotify-Downloader/assets/54973797/2e7771fe-1ab3-4e7f-a040-befb0fc6f8da" width="50%" height="50%">

Usage

Download Screen Button

• Takes you to the setup or processing screen depending on if a download is started or not

Error Screen Button

• Takes you to the previous download's song errors
• Note: Button is non-interactable and faded if no previous download has errors

Settings Screen Button

• Takes you to the settings screen

Donate Button

• Click to donate and support the development of this program
• Note: Opens in browser

Submit Bug Button

• Click to submit an issue to the github repo
• Note: Opens in browser

Help Button

• Click to access the help documentation (What you are reading now)
• Note: Opens in browser

Download Status

• Shows the result of the last download

Enter Song/Playlist URL

• The URL to your songs you would like to download
• You can click the paste button directly to the right to input the copied text from your clipboard into the input
• Accepts:
  • Singlular Songs
  • Playlists
  • Albums

Note: Your playlist or album must be public or else it will not work

In App

• Right click Your chosen song or playlist
• Share
• Copy link to playlist

<img src="https://github.com/WilliamSchack/Spotify-Downloader/assets/54973797/7114f20e-9176-4e5b-990b-421f59ff8343" width="50%" height="50%">

In Browser

• Click on your playlist or song
• Copy the URL

<img src="https://github.com/WilliamSchack/Spotify-Downloader/assets/54973797/409a2b15-1c9a-48d7-a9a1-3b505b699b5a" width="50%" height="50%">

Select A Save Location

• The path to your download location
• You can click the browse button directly to the right to browse to a location
• Note: Saved between sessions

Note: All settings are saved between sessions

Output

Overwrite Existing Files - Recommended: OFF

• If enabled, downloading will overwrite previously downloaded files or not

Normalize Volume - Recommended: ON, -14dB

• If enabled, changes the value of all songs to the same depending on its average volume.
  • Quite: -17dB
  • Normal: -14dB
  • Loud: -11dB

Audio Bitrate - Recommended: 192kb/s

• Sets the output quality of each song downloaded
  • High Quality: 256kb/s
  • Good Quality: 192kb/s
  • Low Quality 128kb/s

Average File Size

• Displays a estimated file size based on the chosen bitrate
• File Size (MB) = (bitrate(kbs) * duration(seconds)) / 8) / 1024
• Does not take into account metadata, an extra ~0.9MB is added

Naming Format

• Enclosing tag input sets the characters to open and close a tag
  • Left character sets the opening input
  • Right character sets the closing input
• Format Input sets the output name of each song.
  • Each tag must be enclosed with the characters set in the left input field
• Naming format can only include these currently implemented tags:
  • Song Name - Name of the song
  • Album Name - Name of the album
  • Song Artist - Name of the first artist of a song
  • Song Artists - Names of each artist of a song "Artist1, Artist2, Artist3, ..."
  • Album Artist - Name of the first artist of the songs album
  • Album Artists - Names of each artist of a songs album "Artist1, Artist2, Artist3, ..."
  • Song Time Seconds - Time of the song in seconds
  • Song Time Minutes - Time of the song in minutes "01.23"
  • Song Time Hours - Time of the song in hours "00.01.23"

Folder Sorting

• Creates folders within your chosen download path with the title set here

Downloading

Show Status Notifications - Recommended: ON

• If enabled, notifications will show when notable events happen during downloading to notify you incase it is in the background

Downloader Threads - Recommended: 6

• The amount of threads used while downloading songs. This will control how many songs download simultaneously but large values can negatively effect CPU usage. Cannot be changed during download.

Download Speed Limit - Recommended: 0MB/s

• The speed limit to downloading songs in MB/s. A value of 0 is uncapped

Each track downloading will show its:

• Cover image
• Downloading index on that thread
• Title
• Artist(s)
• Progress Percent
• Downloading Status

You can see your total download progress on the counter at the bottom left.

Download Progress

• Shows your total download progress
  • Located in the bottom left corner

Pause Button

• Pauses all current downloads

Cancel Button

• Cancels the current download and returns to the setup screen

Settings Button

• Opens the settings menu, download continues in the background while open

Shows all of the songs that failed to download due to various reasons that can include:

• Song not available on youtube
• Song on youtube not close enough to spotify version

Return To Setup Screen Button

• Returns to the setup screen

Features

• GUI
  • Makes it easy to navigate the program
  • Clear communication of current downloads
  • Multiple screens seperating the setup, downloads, errors, and settings
• Easy Downloading
  • Downloading starts with only two inputs and a button click
• Multithreading
  • Can download multiple songs at once using multiple threads
  • Splits playlist into multiple smaller lists that download seperately to speed up the download time significantly
  • Automatically distributes songs after each thread is finished downloading
• Automatic Metadata
  • Downloads automatically include metadata into each file containing:
  • Song Title
  • Artists
  • Album Name & Cover
  • Spotify & Youtube ID used to download the song
• Customisable
  • Allows you to have control over the downloading with settings saving between sessions, including:
  • Overwriting
  • Volume Normalization
  • Audio Bitrate
  • Thread Count
  • Download Speed
  • Output Naming Format
  • Output Folder Sorting
• Automatic Cleanup
  • When quitting the application it will automatically quit and cleanup any currently downloading and temp files that will not be needed later
  • If cleanup fails due to any reason, unused files are kept in the temp directory and will be cleaned on later use of the program or by windows automatically

License

Spotify Downloader is distributed under the GNU General Public License v3.0 from 17/04/2024 and Release v1.1.3

Spotify Downloader is a program that downloads songs from Spotify. Copyright (C) 2024 William Schack

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

FAQ

Credits

Packages Used

• Qt5 - LGPL v3 License
• Python YT Music API - MIT License (Translated to C++)
• ffmpeg - LGPL v2.1 License
• yt-dlp - Unlicense
• Taglib - LGPL v2.1 License, Mozilla Public License

Thanks to you for using my program :)