𓅪 slskdquestrr

A self-hosted web UI for requesting music downloads through slskd (Soulseek).
Search by album or track, and slskdquestrr automatically picks the quality source (prefers FLAC) and queues the download. No need to touch the slskd interface.

demo

Features

| | | |---|---| | 🎵 Album & Track modes | Full-album folders or single best-quality files | | 🏆 "Smart" scoring | Ranks results by format, bitrate, relevance, queue length | | 🔒 No CORS headaches | Built-in nginx reverse-proxy to the slskd API | | 👤 Easy Auth | Easily log in with your slskd credentials, no keys needed | | 🔁 Timeout/Failed Handler | Internal process for retrying timed out/failed queries |

Prerequisites

| Requirement | Notes | |---|---| | Docker & Docker Compose | Version 2+ recommended | | slskd | Running instance with an API key configured | | gluetun (Optional) | VPN container |

Environment Variables

| Variable | Required | Default | Description | |---|---|---|---| | SLSKD_BASE_URL | ✅ | http://server_ip_address:5030 | Internal URL of your slskd instance |

Note: SLSKD_BASE_URL should be the Docker-internal URL (no trailing slash) OR the server's IP.
If slskd uses network_mode: service:gluetun, use http://gluetun:5030.

Deployment

Option A — Add to an existing Docker Compose stack

Add this service to your docker-compose.yml:

services:
  slskdquestrr:
    image: ghcr.io/rj45connector/slskdquestrr:latest
    container_name: slskdquestrr
    ports:
      - "8082:80"
    environment:
      - SLSKD_BASE_URL=http://server_ip_address:5030      # or server_ip_address, http://gluetun:5030 (If using a VPN)
    restart: unless-stopped

Then:

docker compose up -d slskdquestrr

Option B — Build from source

git clone https://github.com/rj45connector/slskdquestrr.git
cd slskdquestrr

# Edit docker-compose.yml with your server's IP

docker compose up -d --build

Access

Open http://YOUR_SERVER_IP:8082 in your browser.

This WebUI uses slskd web UI credentials to authenticate. Please ensure you have a strong username/password conmanation if exposing these services.

Customisation

Tuning the search algorithm

Edit public/index.html and adjust the CFG object:

Theming

All colours use CSS custom properties.
Edit the :root block in public/index.html to reskin.

Health Check

curl http://localhost:8082/health
# OK

License

MIT — do whatever you want.

Quick Start — Build & Run

# 1.) Clone & create the repo
mkdir slskdquestrr && cd slskdquestrr

# 2.) Create the folder structure
mkdir -p public nginx

# 3. Place the files:
#    public/index.html          
#    nginx/default.conf.template 
#    entrypoint.sh              
#    Dockerfile                 

# 4.) Make entrypoint executable
chmod +x entrypoint.sh

# 5.) Build the image
docker build -t slskdquestrr:latest .

# 6.) Test it standalone
docker run --rm -p 8082:80 \
  -e SLSKD_BASE_URL=http://host.docker.internal:5030 \
  slskdquestrr:latest

# 7.) Open http://localhost:8082

But like, how does it work?

| Piece | Purpose | |---|---| | Dockerfile | Builds a nginx:alpine image | | entrypoint.sh | generates /config.js from env vars, processes the nginx template, starts nginx | | config.js (generated) | Passes API_BASE to the browser JS at runtime | | default.conf.template | Nginx serves the HTML at / and proxies /api/v0/* -> slskd — eliminates CORS | | index.html | Reads connection info from window.SLSKD_CONFIG (loaded via config.js) |

Security note: Your Bearer Token is visible via HTTP. This is acceptable for a private, self-hosted tool behind your LAN/VPN. Do not expose port 8082 to the public internet without additional authentication (e.g., Authelia, Authentik, or HTTP basic auth in nginx).

Slskdquestrr

Install / Use

README