spotDL GUI

Simple GUI wrapper over spotDL, a Spotify downloader.

Installation

Note
Download the executable from the GitHub release page or install using pipx.

1. Install pipx.

   python -m pip install --user pipx
   python -m pipx ensurepath

2. Open a new terminal or re-login.
3. Install spotdl_gui

   pipx install git+https://github.com/nozwock/spotdl_gui.git

• Run with spotdl-gui

Prerequisites

FFmpeg is required for the GUI and spotDL to work.

On Windows, Install with:

winget install -e --id Gyan.FFmpeg

Usage

Searches

You can search for multiple items at a time by separating them with a comma ','.
For example: Aurora, Coolio, Full Confession.

To use a comma as part of your search term without it acting as a separator, you can escape it with the backslash character '\'.
For example: This here\, will be escaped will be treated as a literal string This here, will be escaped.

Reserved search terms

Term	Description
user:saved-tracks	Spotify user's favourite tracks
user:all-playlists	Spotify user's all playlists

Search prefixes

Prefix	Description
album:	Search by album
playlist:	Search by playlist
artist:	Search by artist

Downloads

Upon pressing the Download button, the selected tracks will be downloaded. You can choose all tracks at once with Ctrl+A, or individually by holding Ctrl and clicking on the desired tracks.

Building

git clone https://github.com/nozwock/spotdl_gui.git
cd spotdl_gui
poetry install
poetry run spotdl-gui

Building frozen app

poetry run python release/build.py

Credits

Assets

• https://boxicons.com
• https://www.svgrepo.com