SpotDL-WebGUI
spotDL finds songs from Spotify playlists on YouTube and downloads them with album art, lyrics, and metadata.
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
Variants
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
- Can you run SpotDL (web) in a Docker container? : r/selfhosted - Reddit (reddit)
- Does anyone have any detailed instructions on how to use ... - Reddit (reddit)
- r/selfhosted on Reddit: A way of scraping my Spotify playlists and ... (reddit)
- spotdl_help - Reddit (reddit)
Collected 53 days ago - public community threads