Discord-Music
Self-hosted Discord music bot for Unraid that plays and manages music in Discord voice channels, featuring an admin web interface, built-in FFmpeg audio…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
42/100 Fair
- Maintained
- 72last commit 12 days ago
- Popular
- 00 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today
- GitHub stars
- 0
- Open issues
- 0
- Last commit
- 2026-11-08
- License
- MIT
- Activity
- rising
Checked 12 days ago - source: GitHub (marcvandecoevering/Discord-Music)
Resources & Compatibility
Requirements not published yet.
Checked 12 days ago - source: Docker Hub image tags and published docs
First-install notes
- Enter your Discord Application Client ID Replace the sample YOUR_OAUTH2_CLIENT_ID with your app's Client ID from Discord. This ID (the public identity of your Discord app) lets Discord-Music open the permission screen and know which app is asking for access. source
- Approve the identify permission When Discord shows the authorization window, accept the identify permission. That lets the app recognize your Discord account basics; without it, sign-in can fail or the app may not know who you are. source
- Keep the token proxy endpoint working The app sends Discord's one-time code to a server endpoint called /.proxy/api/token and expects an access token back. If that endpoint is missing or misconfigured, the login flow gets stuck right after you approve Discord. source
- Set up in Unraid Use the app's Unraid template and set Repository to ghcr.io/marcvandecoevering/discord-music:latest (x86-64 only). Fill in the admin password, Discord bot token, server ID, and voice channel ID; the bot needs View Channel, Connect, and Speak. On first startup it pulls the official SinusBot image. Then open the web interface (default port 18087) and log in as admin. source
- Unraid setup Unraid requires an x86-64 host. Set Repository to ghcr.io/marcvandecoevering/discord-music:latest, enter the admin password, Discord bot token, server ID, and voice channel ID, and grant the bot View Channel, Connect, and Speak permissions. The Web UI defaults to port 18087. source
- Single Player per Music Directory Do not run two players pointing at the same music directory simultaneously to avoid audio and library conflicts. source
Fetched yesterday - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What port does the web interface use by default?
The WebUI runs on port 18087 by default.
Which Discord bot permissions are required?
The bot needs View Channel, Connect, and Speak.
What should I do before updating the app?
Keep the existing data directory when updating. Never open the same library in two players at the same time.
Does it include YouTube playback or text-to-speech?
No. It supports local music uploads and playlists, but TTS and a YouTube downloader are not included.
Does the container include SinusBot, and is there a licensing limitation?
It downloads the official SinusBot image on first startup and verifies it. SinusBot has its own license for personal use.
Answers sourced from github.com
Community
- Looking for a "standalone" music bot with user requests - Reddit (reddit)
- Discord Music Bot in Docker? : r/selfhosted - Reddit (reddit)
Collected 12 days ago - public community threads