https://github.com/squat/streamdl

A Streamlit frontend for spotDL
https://github.com/squat/streamdl

spotdl streamlit

Last synced: 5 months ago
JSON representation

A Streamlit frontend for spotDL

• Host: GitHub
• URL: https://github.com/squat/streamdl
• Owner: squat
• Created: 2025-09-19T20:50:14.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2026-01-18T00:34:15.000Z (5 months ago)
• Last Synced: 2026-01-18T12:51:17.409Z (5 months ago)
• Topics: spotdl, streamlit
• Language: Python
• Homepage:
• Size: 141 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 9
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
[![Build Status](https://github.com/squat/streamdl/workflows/CI/badge.svg)](https://github.com/squat/streamdl/actions?query=workflow%3ACI)

[![Built with Nix](https://img.shields.io/static/v1?logo=nixos&logoColor=white&label=&message=Built%20with%20Nix&color=41439a)](https://builtwithnix.org)

# streamdl

A Streamlit frontend for [spotDL](https://github.com/spotDL/spotify-downloader).

## Getting Started

The quickest way to run streamdl is by using the pre-built Docker container:

```shell

docker run --rm -p 8501:8501 -v /mnt/music:/data ghcr.io/squat/streamdl

```

Now, streamdl can be used pointing a browser to [http://localhost:8501](http://localhost:8501) and searching for music in the search bar.

Files will be downloaded to the directory mounted at `/data`.

## Usage

streamdl can be started simply by running:

```shell

streamdl

```

All valid Streamlit CLI flags that can be supplied to `streamlet run` can also be supplied to streamdl, e.g.:

```shell

streamdl --server.address=
 --server.port=

```


A spotDL configuration file can be supplied with the `--config` flag, e.g.:

```shell

streamdl -- --config=

```

Note: that `--` must be given before the `--config` flag in order to separate it from the flags passed to Streamlit.