Overview
The r!queue command displays all songs currently in the queue, including the now playing song and upcoming tracks.
Usage
The queue displays in the following format:
🎵 Canciones en la cola:
🎶 Ahora: Currently Playing Song
1. Next Song
2. Third Song
3. Fourth Song
...
Example Output
r!queue
🎵 Canciones en la cola:
🎶 Ahora: The Scientist - Coldplay
1. Bohemian Rhapsody - Queen
2. Stairway to Heaven - Led Zeppelin
3. Hotel California - Eagles
Implementation
From commands/music/queue.js:4-15:
async execute ( message , args , client ) {
const queue = client . distube . getQueue ( message );
if ( ! queue ) {
return message . reply ( '❌ No hay ninguna canción reproduciéndose.' );
}
const songList = queue . songs . map (( song , index ) =>
` ${ index === 0 ? '🎶 Ahora' : ` ${ index } .` } ${ song . name } `
). join ( ' \n ' );
message . channel . send ( `🎵 **Canciones en la cola:** \n ${ songList } ` );
}
Queue Structure
Index 0: Now Playing
The first song (index 0) is the currently playing track, marked with ”🎶 Ahora”
Index 1+: Upcoming Songs
All subsequent songs are numbered 1, 2, 3, etc. and will play in that order
Song Names
Each entry shows the song name as returned by DisTube
Requirements
Music must be currently playing or queued
Error Messages
No Queue Active
r!queue
# ❌ No hay ninguna canción reproduciéndose.
This error appears when:
No music is playing
The queue is empty
No songs have been added yet
The queue command shows:
Now Playing Currently playing song marked with 🎶 Ahora
Upcoming Songs All songs waiting to be played, in order
Song Count Implicit count from numbered list
Play Order Exact order songs will play
Use Cases
Check What’s Playing
r!queue
# See the current song and upcoming tracks
Before Skipping
# View queue to choose skip position
r!queue
r!skip 3 # Skip to third song
After Adding Songs
r!play bohemian rhapsody
r!play hotel california
r!queue # See both songs added
Monitor Queue Length
r!queue
# Count how many songs are waiting
Queue Management
While this command only displays the queue, you can manage it with:
r!play <song> - Add songs to queue
r!skip - Skip to next song
r!skip [position] - Jump to specific song
r!stop - Clear entire queue
DisTube Queue Object
The command uses DisTube’s queue structure:
queue . songs // Array of all songs
[ 0 ] // Currently playing (🎶 Ahora)
[ 1. . n ] // Upcoming songs (numbered 1, 2, 3...)
Each song object contains:
song.name - Song title
song.url - Source URL
song.duration - Length in seconds
song.user - User who added the song
Example Scenarios
Single Song
r!play despacito
r!queue
🎵 Canciones en la cola:
🎶 Ahora: Despacito - Luis Fonsi
Multiple Songs
r!play the scientist
r!play fix you
r!play yellow
r!queue
🎵 Canciones en la cola:
🎶 Ahora: The Scientist - Coldplay
1. Fix You - Coldplay
2. Yellow - Coldplay
After Skip
# Before skip
r!queue
🎶 Ahora: Song A
1. Song B
2. Song C
r!skip
# After skip
r!queue
🎶 Ahora: Song B
1. Song C
r!play - Add songs to the queue
r!skip - Move to next song in queue
r!skip [position] - Jump to specific queue position
r!stop - Clear entire queue
r!status - See queue count in bot status
Tips
Use r!queue before r!skip [position] to see exact song positions
The queue shows songs in the exact order they will play
Song names come directly from YouTube/Spotify metadata