Skip to content

Latest commit

 

History

History
71 lines (57 loc) · 2.1 KB

README.md

File metadata and controls

71 lines (57 loc) · 2.1 KB
Raw

spotDL GUI

Simple GUI wrapper over spotDL, a Spotify downloader.

preview

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