Skip to main content

Overview

The r!queue command displays all songs currently in the queue, including the now playing song and upcoming tracks.

Usage

r!queue

Display Format

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

1

Index 0: Now Playing

The first song (index 0) is the currently playing track, marked with ”🎶 Ahora”
2

Index 1+: Upcoming Songs

All subsequent songs are numbered 1, 2, 3, etc. and will play in that order
3

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

Queue Information

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

Build docs developers (and LLMs) love