# SpotDL-WebGUI

SpotDL-WebGUI is a self-hosted downloaders app. spotDL finds songs from Spotify playlists on YouTube and downloads them with album art, lyrics, and metadata. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1060/spotdl-webgui

## Description

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.

## Health score

81/100 (Excellent), based on 3 of 4 factors.
- Maintained: 100 (last commit 26 days ago)
- Popular: 88 (26,551 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/spotdl/spotify-downloader
- GitHub: https://github.com/spotDL/spotify-downloader
- Documentation: https://spotdl.readthedocs.io/en/latest/
- Unraid: https://ca.unraid.net/apps/spotdl-webgui-1egg4vc1jhdzzo?q=SpotDL-WebGUI
- Official website: https://spotdl.readthedocs.io/en/latest/

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1060/spotdl-webgui), the self-hosted and open-source app directory.
