The queue
The queue is the list of tracks waiting to play. It holds 200 tracks on a free server and 100,000 with Premium. When a queue is full, extra tracks are dropped and the bot tells you how many did not fit.
Viewing it
/queue opens an interactive panel: the current track at the top, then the
queue five tracks per page, with the total count and the total listening time.
As a prefix command it also answers to q.
Each track has a more button. Opening it reveals five actions for that track:
| Button | Effect |
|---|---|
| Remove | drops it from the queue |
| +1 | moves it one slot earlier |
| Top | moves it to the front |
| -1 | moves it one slot later |
| Play | moves it to the front and skips to it right away |
Removing one track
/remove removes a single track. The query option autocompletes from the
actual queue, so you pick the track from a list rather than counting positions.
As a prefix command it also answers to rm.
Reordering
/move from: 4 to: 1 moves the fourth track to the first slot. Both numbers are
queue positions. The queue needs at least 3 tracks for this to work.
/shuffle randomises the whole queue. Also needs at least 3 tracks. Requires a
vote or Premium.
The dashboard has an Auto Shuffle switch (Premium): adding more than two tracks at once re-shuffles the whole queue, not just the tracks you added. It does not apply when you use insert-first.
Cleaning up
| Command | Removes |
|---|---|
/clearqueue | everything waiting, the current track keeps playing |
/removedupes | duplicates, keeping the first copy of each track |
/leavecleanup | tracks added by people who have left the voice channel |
/clearqueue answers to cq as a prefix command. The other two have no short
form.
/removedupes requires a vote or Premium and needs at least 3 tracks in the
queue.
Who is allowed to touch the queue
With DJ mode off, anyone in the voice channel can. With it on, these are the permissions that matter:
| Action | Permission |
|---|---|
/queue | View Queue |
/remove, /clearqueue | Remove Songs |
/move, /shuffle | Move Songs |
/play, /play-file, /tts | Add Songs (and Connect Bot) |
Saving a queue
/playlist add-queue playlist_name: <name> snapshots everything currently
queued into one of your saved playlists, so you can replay the same set later.
See playlists.
