SpotDL-WebGUI

spotDL finds songs from Spotify playlists on YouTube and downloads them with album art, lyrics, and metadata.

  • Downloaders
  • Tools & Utilities
spotDL finds songs from Spotify playlists on YouTube and downloads them with album art, lyrics, and metadata. This container adds a web interface for easily adding media links to process.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

81/100 Excellent

Maintained
100last commit 26 days ago
Popular
8826,551 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 48 days ago

GitHub stars
26,551
Open issues
91
Last commit
2026-10-26
Latest release
v4.6.0
License
MIT
Activity
rising

Checked 20 days ago - source: GitHub (spotDL/spotify-downloader)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install spotDL with pip Run "pip install spotdl" (or "pip3 install spotdl" on most Mac/Linux systems) so the main program is installed. Without this, commands like "spotdl web" won't work. source
  • Get FFmpeg with one command After installing, run "spotdl --download-ffmpeg" so SpotDL can process downloaded music. Missing FFmpeg can cause downloads or audio file creation to fail. source
  • Open the web interface Run "spotdl web" to launch the browser-based control panel. This is the screen you'll use to start downloading music after setup. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What must be installed for the spotdl web command to work?

Install spotDL with pip or pip3 so the main program is installed. Without this, commands like spotdl web won't work.

What should I install if downloads or audio file creation fail?

Missing FFmpeg can cause downloads or audio file creation to fail. You can install FFmpeg to your spotDL directory by running spotdl --download-ffmpeg.

What additional runtime can help with videos that fail to download?

Deno is strongly recommended because some YouTube videos require it to download successfully. Without Deno, spotDL may fail on some songs, including videos marked as made for kids.

How can I access downloaded songs when using Docker?

Create a mapped volume to access song files. The Docker example mounts the current directory into /music.

Has anyone run the WebUI behind a reverse proxy in Docker?

A user reports running spotdl in Docker Compose behind a Traefik v2 reverse proxy while trying to keep access to the WebUI.

Answers sourced from github.com, github.com, github.com

Community

Collected 53 days ago - public community threads