Docs · Modules
Music
Play music in Discord with Based: /play songs and links, supported sources, queue, loop, seek, volume, the DJ role and the player buttons.
Based streams music into your voice channel. Join a voice channel and run /play with a song name or a link. If something is already playing, the track joins the queue.
Where songs come from
Song names are searched on JioSaavn first, then SoundCloud, then Audius. Links from JioSaavn, SoundCloud and Audius play directly. Spotify, Apple Music and YouTube links are read for the title and artist and then searched on the supported sources. Playlists and albums are added one track at a time, up to the server's queue limit. Nothing is downloaded or cached; music is streamed.
The player panel
Each server gets one player message showing the track, progress, volume and loop mode, with buttons to pause, skip, stop, seek 15 seconds back or forward, change volume, loop, shuffle and open the queue. /playing brings the panel into the current channel.
Who controls playback
By default members must be in Based's voice channel to control playback. Set a DJ role so that only that role and moderators can control playback, while everyone can still add songs.
When Based leaves
Playback pauses when no human is listening. Based leaves after two minutes alone in the channel or three idle minutes. See how music bots work on Discord.
Settings
Change these in the dashboard or with /setup in Discord. They apply to one server at a time.
| Setting | Default | What it does |
|---|---|---|
| Enabled | On | Turn this feature on for this server. |
| Allowed channels | Not set | Leave empty to let Based work in every channel it can see. |
| Default volume | 0.7 | Starting volume, from 0 (silent) to 1 (full). |
| Queue limit | 100 | The most tracks the queue can hold. |
| DJ role | Not set | Optional. When set, only this role and moderators can control playback. Everyone can still add songs. |
| Require the same voice channel | On | Members must be in Based's voice channel to control playback. |
Permissions Based needs
For this module Based's role needs: View Channel, Connect, Speak. See permissions for how to grant them only where they are needed.
Commands
Every command works as a slash command and with the text prefix (default .), so /play and .play do the same thing.
/play
Play a song or link, or add it to the queue.
- Usage:
/play <query> query(required): Song name, or a JioSaavn, SoundCloud, Audius, Spotify, Apple Music or YouTube link- Who can use it: Anyone who can use the command, in servers only
/pause
Pause music.
- Usage:
/pause - Who can use it: Anyone who can use the command, in servers only
/resume
Resume music.
- Usage:
/resume - Who can use it: Anyone who can use the command, in servers only
/skip
Skip the current track.
- Usage:
/skip - Who can use it: Anyone who can use the command, in servers only
/stop
Stop music, clear the queue and leave voice.
- Usage:
/stop - Who can use it: Anyone who can use the command, in servers only
/queue
Show the music queue.
- Usage:
/queue - Who can use it: Anyone who can use the command, in servers only
/playing
Show the music player in this channel.
- Usage:
/playing - Who can use it: Anyone who can use the command, in servers only
/volume
Set music volume.
- Usage:
/volume <value> value(required): Volume from 0 to 100- Who can use it: Anyone who can use the command, in servers only
/seek
Jump to a time in the current track.
- Usage:
/seek <position> position(required): Time like 1:23 or 83, or +15 / -15 to move- Who can use it: Anyone who can use the command, in servers only
/remove
Remove a track from the queue.
- Usage:
/remove <position> position(required): Queue position- Who can use it: Anyone who can use the command, in servers only
/shuffle
Shuffle the queue.
- Usage:
/shuffle - Who can use it: Anyone who can use the command, in servers only
/loop
Set loop mode, or cycle it.
- Usage:
/loop [mode] mode: Loop mode (off, track, queue)- Who can use it: Anyone who can use the command, in servers only
/clearqueue
Clear upcoming tracks.
- Usage:
/clearqueue - Who can use it: Anyone who can use the command, in servers only
Frequently asked questions
Can Based play Spotify or YouTube links?
It reads the title and artist from Spotify, Apple Music and YouTube links and plays a match from JioSaavn, SoundCloud or Audius.
How many songs can the queue hold?
100 by default. Server staff can change the queue limit in the dashboard.
Try it in your server
Based is an AI Discord bot in 300+ servers. Every slash command also works with the "." prefix.