melodix

Melodix — Self-hosted Discord music bot

Melodix is a Discord bot that plays music in voice channels. You can add it to your own server and run it yourself, or try it on the official server. It is written in Go and supports YouTube, SoundCloud, and internet radio streams.

What Melodix does

Plays audio in voice channels — Join a voice channel, use the music commands, and the bot streams audio from the given link or search.
Multiple sources — YouTube (by link or search), SoundCloud, and direct radio/stream URLs.
Queue and controls — Play, skip to the next track, or stop and clear the queue.
Multiple servers — One bot instance can serve many Discord servers.
Slash commands — All features are available via Discord slash commands (e.g. /music play, /help).

Limitations: The bot cannot play YouTube live streams or region-locked videos. Not every radio stream format is supported. Playback may occasionally pause or vary slightly when the bot retries with a different stream method.

Try Melodix without installing

Official Discord server — Join the Melodix Discord server, go to a voice channel and the #bot-spam (or similar) text channel, and use the slash commands there.
Pre-built binaries — Download a release (Windows), then follow the setup steps below to create a bot in the Developer Portal and run the binary.

Commands

🕯️ Information

/about — Discover the origin of this bot
/help — Get a list of available commands

🎵 Music

/music — Control music playback

⚙️ Settings

/commands — Manage or inspect commands
/maintenance — Bot maintenance commands

Music examples: Play by search query or by link. You must be in a voice channel to use /music play.

/music play Never Gonna Give You Up
/music play https://www.youtube.com/watch?v=dQw4w9WgXcQ
/music play http://stream-uk1.radioparadise.com/aac-320

Running Melodix yourself

This section is for anyone who wants to host the bot on their own machine or server.

What you need

A Discord bot token (from the Discord Developer Portal).
FFmpeg installed and on your system PATH (used for some audio streams).
yt-dlp (optional but recommended) on your PATH for better YouTube support. Without it, the bot falls back to other methods.

Step 1 — Create the bot in Discord

Open the Discord Developer Portal and create a new application. Note the Application ID (in the “General Information” section).
Go to the Bot section and create a bot. Copy the token (you will use it as DISCORD_TOKEN).
Under Privileged Gateway Intents, enable:
- Presence Intent
- Server Members Intent
- Message Content Intent
Invite the bot to your server using this URL (replace YOUR_APPLICATION_ID with your Application ID from step 1):

https://discord.com/oauth2/authorize?client_id=YOUR_APPLICATION_ID&scope=bot&permissions=3238912

This link only requests the permissions the bot needs: View Channel, Send Messages, Embed Links, Read Message History, Manage Messages, Connect to Voice Channel, Speak.
Open the URL in your browser, choose your server, and authorize. Grant the requested permissions when asked.

Step 2 — Configure and run

Create a .env file in the folder where you run the bot (or set the same variables in your environment):

# Required: your bot token from the Developer Portal
DISCORD_TOKEN=your-discord-bot-token

Optional variables (you can add these to .env if needed):

Variable	Description	Default
`STORAGE_PATH`	Path for bot data (e.g. command state).	`./data/datastore.json`
`INIT_SLASH_COMMANDS`	Set to `true` to register slash commands on every startup.	`false`
`DEVELOPER_ID`	Your Discord user ID for developer-only commands.	(none)
`DISCORD_GUILD_BLACKLIST`	Comma-separated guild IDs the bot will leave.	(none)

Run the bot:

From source (Go): Clone the repo, run go build ./cmd/discord, then run the produced binary. Ensure DISCORD_TOKEN is set (e.g. in .env).
From a release: Download the Windows binary from releases, put it in a folder with your .env (or set DISCORD_TOKEN), and run it.
With Docker: See docker/README.md for Docker and Docker Compose instructions.

After the bot is running and invited to your server, use slash commands in any channel where the bot can read and send messages. For music, be in a voice channel and use /music play with a link or search term.

Support

For help or questions, use the Melodix Discord server.

License

Melodix is licensed under the MIT License.

This site is open source. Improve this page.