telegram-slskd-local-bot

Overview

Telegram bot for automated music discovery and downloading. Resolves track metadata from Spotify, searches Soulseek (via slskd) for FLAC files, and places them in your music library with proper naming. Includes a scoring algorithm for quality selection.

Requires: slskd instance, Spotify API credentials, and a Telegram bot token.

More info: https://github.com/GeiserX/telegram-slskd-local-bot

Requirements

slskd instance, Spotify Developer API credentials, Telegram bot token

Runtime arguments

Network: bridge
Privileged: false

Template configuration

DownloadsPathro

slskd completed downloads directory (read-only)

Target: /downloads
Default: /mnt/user/Multimedia/Music/Downloads

Music OutputPathrw

Output directory for renamed FLAC files

Target: /music
Default: /mnt/user/Multimedia/Music/FLAC

Bot TokenVariable

Telegram bot token from @BotFather

Target: TELEGRAM_BOT_TOKEN

Spotify Client IDVariable

Spotify Developer API client ID

Target: SPOTIFY_CLIENT_ID

Spotify Client SecretVariable

Spotify Developer API client secret

Target: SPOTIFY_CLIENT_SECRET

slskd HostVariable

URL of your slskd instance

Target: SLSKD_HOST
Default: http://slskd:5030

slskd API KeyVariable

slskd API key

Target: SLSKD_API_KEY

Allowed UsersVariable

Comma-separated Telegram user IDs (empty = open)

Target: TELEGRAM_ALLOWED_USERS

Auto ModeVariable

Automatically download best match without confirmation

Target: AUTO_MODE
Default: false

Max ResultsVariable

Number of search results to display

Target: MAX_RESULTS
Default: 5

Links

Template Support Docker Hub Project

Details

Repository

drumsergio/telegram-slskd-local-bot:latest

Registry

https://hub.docker.com/r/drumsergio/telegram-slskd-local-bot

Last Updated2026-04-10

First Seen2026-04-06

Run telegram-slskd-local-bot on Unraid.

telegram-slskd-local-bot is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS