Quick install

Discord server setup

  1. Use the Add to Discord link from the website.
  2. Choose the server where you want to install the bot.
  3. Make sure the installer has Manage Server permission.
  4. Run /help to see the starting instructions.
  5. Join a Discord voice channel and run /musicbot.
  6. Run /menu or /play song name to start using it.

Permissions needed

The bot needs enough text and voice permissions to see commands, post the control panel, and join voice.

  • View Channels
  • Send Messages
  • Embed Links
  • Attach Files
  • Read Message History
  • Connect
  • Speak
  • Use Voice Activity

First test

After the bot is installed, test it in this order:

  1. Join a voice channel.
  2. Type /help if you need the command list.
  3. Type /musicbot in a text channel the bot can see.
  4. Type /play test song.
  5. If it joins but does not play, check the voice channel permissions.

FAQ

Common questions

The bot is installed, but slash commands do not show.

Wait a few minutes and try again. If commands still do not show, remove the bot and add it again from the Add to Discord link.

The bot will not join my voice channel.

Check that the bot role has Connect, Speak, and Use Voice Activity permissions in that exact voice channel. Channel overrides can block the bot even when the server role looks correct.

How do I play music?

Join voice, run /musicbot, then use /help for the command list, then use /play song name or open the control panel with /menu.

How do playlists work?

Use /load with a playlist name, CSV file, attachment, public Spotify link, or YouTube playlist link. The bot checks local music first, then searches online for missing songs.

Who do I contact for help?

Email [email protected] with what command you tried and what happened.