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…

  • Media Applications
  • Media Servers
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 player, and local library management.

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

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

Collected 12 days ago - public community threads