discodrome

discodrome

Docker app from 7eventy7's Repository

Overview

Discord bot that streams music from your personal subsonic server.

Readme

View on GitHub

Discodrome Icon Discodrome

Subsonic Compatible Discord Music Bot

GitHub issues Docker Pulls License

A Discord music bot that seamlessly streams music from your personal music server directly to your voice channels. Works great with Navidrome and other Subsonic-compatible music servers.

Commands

Slash Commands

Command Description
/play Place a specified track, album, or playlist at the end of the queue and start playing
/next Place a specified track next in the queue and start playing
/disco Play an artist's entire discography
/queue View the current queue
/clear Clear the current queue
/shuffle Shuffle the current queue
/skip Skip the current track
/stop Stop playing the current track
/autoplay Toggle autoplay
/playlists List available playlists
/playlist List songs in a playlist
/sync Sync application commnads (owner only)

Prefix Commands

Command Description
p Place a specified track at the end of the queue and start playing
n Place a specified track next in the queue and start playing
s Skip the current track
q View the current queue

Requirements

  • Docker running on an x64 or ARM device

For non-Docker deployment or development:

  • Python 3.10 or later
  • FFmpeg available in PATH

Quick Start

Step 1 — Create a Discord Bot

  1. Go to the Discord Developer Portal
  2. Click New Application and give it a name
  3. Navigate to the Bot tab and click Add Bot
  4. Under the TOKEN section, click Reset Token and copy your new token
  5. Enable the following Privileged Gateway Intents:
    • MESSAGE CONTENT INTENT
    • SERVER MEMBERS INTENT
    • PRESENCE INTENT
  6. Navigate to OAuth2 → URL Generator
  7. Select the following scopes: bot, applications.commands
  8. Select bot permissions: Send Messages, Connect, Speak, Use Voice Activity, Read Message History
  9. Copy the generated URL and paste it into your browser to invite the bot to your server

Step 2 — Gather Required Information

  • Discord Bot Token — from Step 1
  • Discord Server ID — right-click your server icon and select Copy ID (requires Developer Mode enabled in Discord settings)
  • Your Discord User ID — right-click your username and select Copy ID
  • Subsonic Server Details — URL, username, password and auth mode for your music server
    • Use token auth mode unless you have a good reason not to

Step 3 — Deploy with Docker

Pull the Docker image:

docker pull 7eventy7/discodrome:latest

Then run the container with the environment variables described in the Configuration section below.

Configuration

Environment Variables

Variable Description Required
SUBSONIC_SERVER URL of your Subsonic server (include http/https) Yes
SUBSONIC_USER Username for your Subsonic server Yes
SUBSONIC_PASSWORD Password or auth token for your Subsonic server Yes
SUBSONIC_AUTH_MODE Authentication mode: plaintext or token. Token auth is highly recommended for security. Yes
DISCORD_BOT_TOKEN Your Discord bot token Yes
DISCORD_OWNER_ID Your Discord user ID Yes
DISCORD_TEST_GUILD Guiold ID for testing during development. If set commands will be synced directly to this guild as well as globally. This means the commands will propagate immediately but will also be duplicated. No
BOT_STATUS Custom status message for the bot No
BOT_PREFIX Command prefix for the bot. If unset, prefix commands can still be used with an @mention. An empty string will cause all messages to be interpreted as commands. No
BOT_SEARCH_SUGGESTION_COUNT Number of items to display in the autocomplete menu. Defaults to 5. No

Supported Subsonic Servers

  • Navidrome
  • Airsonic
  • Subsonic
  • Gonic
  • Ampache (with Subsonic API enabled)
  • Jellyfin (with Subsonic plugin)

Contributing

Contributions are welcome. This includes:

  • Reporting bugs
  • Suggesting features
  • Improving documentation
  • Submitting fixes
  • Adding new features

Please check the GitHub Issues page before submitting new ones.

License

GPL-3.0 — free to use for most purposes.

Acknowledgments

This project is a fork of Submeister by Gimzie. Built upon their foundation with additional features and improvements while preserving the core functionality of the original.

Forked with care by 7eventy7

Install Discodrome on Unraid in a few clicks.

Find Discodrome in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Discodrome Review the template variables and paths Click Install
Explore Unraid OS

Categories

Media Server > Music

Download Statistics

8,043
Total Downloads

Related apps

Explore more like this

Explore all
Music apps

Links

Projectgithub.comSupportgithub.comDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
7eventy7/discodrome
Registry
https://hub.docker.com/r/7eventy7/discodrome
Last Updated2026-05-13
First Seen2025-03-03

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

DATAPathrw

persistent storage for discodrome

Target
/data
Default
/mnt/user/appdata/discodrome/
Value
/mnt/user/appdata/discodrome/
SUBSONIC_SERVERVariable

URL of your Subsonic server

Value
YOUR_SUBSONIC_SERVER_URL
SUBSONIC_USERVariable

Subsonic username

Value
YOUR_SUBSONIC_USERNAME
SUBSONIC_PASSWORDVariable

Subsonic password

Value
YOUR_SUBSONIC_PASSWORD
DISCORD_BOT_TOKENVariable

Your Discord bot token

Value
YOUR_DISCORD_BOT_TOKEN
DISCORD_TEST_GUILDVariable

Discord test guild ID

Value
YOUR_DISCORD_TEST_GUILD_ID
DISCORD_OWNER_IDVariable

Discord owner ID

Value
YOUR_DISCORD_OWNER_ID
BOT_STATUSVariable

Bot status message

BOT_PREFIXVariable

Bot command prefix

BOT_SEARCH_SUGGESTION_COUNTVariable

Autocomplete suggestion count

Default
5