Setup

Add DJMusicBot to Your Server

Four steps. Under two minutes. No account needed — just a Discord server where you have Manage Server permission.

Installation Steps

Follow these steps to get DJMusicBot playing music in your server.

  1. 1

    Click "Add to Discord"

    Click the button below to open the Discord OAuth2 authorization page. You must be logged in to Discord in your browser.

    + Add to Discord
  2. 2

    Select Your Server

    In the authorization dialog, open the Add to Server dropdown and select the Discord server where you want to add DJMusicBot.

    Note: Only servers where you have the Manage Server permission will appear in the dropdown.
  3. 3

    Review & Confirm Permissions

    Discord will show a list of permissions the bot is requesting. Review them and click Authorize to grant access. The required permissions are explained in the table below.

    • Administrator (full server access — simplifies permission setup)
    • Connect (join voice channels)
    • Speak (stream audio to voice channel)
    • Send Messages (reply to commands)
    • Embed Links (display rich track embeds)
    • Read Message History (process commands)
    • Add Reactions (interactive search results)
  4. 4

    Done — Start Playing!

    DJMusicBot will join your server immediately. Go to any text channel and type the command below to start playing:

    @DJMusicBot play lofi hip hop beats
    Tip: Make sure you are in a voice channel before running the play command so the bot knows where to join.

Required Permissions Explained

Why DJMusicBot needs each permission and what it is used for.

Permission Required Purpose
Administrator ✓ Required Grants full server access. Prevents permission conflicts across channels without manual overrides.
Connect ✓ Required Allows the bot to join voice channels to stream audio.
Speak ✓ Required Allows the bot to transmit audio inside a voice channel.
Send Messages ✓ Required Allows the bot to respond to commands in text channels.
Embed Links ✓ Required Enables rich embed cards showing track title, thumbnail, and duration.
Read Message History ✓ Required Required to read command messages in the channel.
Add Reactions ✓ Required Used by the interactive search feature so users can pick from numbered results.

Troubleshooting

Common issues after adding the bot and how to fix them.

Bot is not responding to commands

Make sure you are mentioning the bot correctly: @DJMusicBot play .... Check that the bot has Send Messages and Read Message History permissions in that specific channel. Channel-level permission overrides can block the bot even if server-level permissions are granted.

No audio is playing in the voice channel

Ensure the bot has both Connect and Speak permissions on the voice channel. Some servers configure voice channels with restricted speak access — check the channel's permission overrides. Also verify you are in the voice channel when issuing the play command.

Bot joins but immediately leaves

This usually happens when no one is in the voice channel. DJMusicBot will automatically leave if it is alone for more than 3 minutes. Re-join the voice channel and run @DJMusicBot play again.

Spotify links are not working

Spotify does not provide direct audio streams. DJMusicBot uses your Spotify link to identify the track name and searches YouTube to play the audio. This requires the self-hosted instance to have valid Spotify API credentials configured. The public bot instance has Spotify support enabled by default.

My server does not appear in the dropdown

You need the Manage Server permission on a server for it to appear in the bot authorization dropdown. If you are a member but not an admin or moderator with that permission, ask your server owner to add the bot instead.