> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeonbot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Queue & History

> Manage your music queue, skip tracks, and view playback history.

When playing multiple songs, ZEON organizes them into a **Queue**. You can view upcoming songs, rearrange them, or look back at what you've already listened to using the History system.

***

## Viewing Tracks

| Command    | Description                                                   |
| :--------- | :------------------------------------------------------------ |
| `.queue`   | Displays a paginated list of all upcoming songs in the queue. |
| `.history` | Displays a list of all recently played songs.                 |

<Tip>
  When using `.queue` or `.history`, an interactive dropdown menu will appear below the list. You can use this dropdown to instantly select a track from the queue to **Play Next**, or select a track from history to **Re-add to the Queue**.
</Tip>

***

## Modifying the Queue

You have full control over the order of upcoming tracks.

| Command              | Description                                                                                    |
| :------------------- | :--------------------------------------------------------------------------------------------- |
| `.skip`              | Skips the current track and plays the next one.                                                |
| `.skipinto <number>` | Skips directly to a specific track number in the queue, discarding everything before it.       |
| `.remove <number>`   | Removes a specific track from the queue without skipping the current song.                     |
| `.move <from> <to>`  | Moves a track from one position to another (e.g., `.move 5 1` brings the 5th song to the top). |
| `.shuffle`           | Randomizes the order of all upcoming tracks in the queue.                                      |
| `.clearqueue`        | Deletes every upcoming track in the queue, leaving only the currently playing song.            |

***

## Looping

You can set ZEON to loop the current song endlessly, or loop the entire queue.

| Command       | Description                                                                                      |
| :------------ | :----------------------------------------------------------------------------------------------- |
| `.loop track` | Repeats the currently playing song forever.                                                      |
| `.loop queue` | Repeats the entire queue. When the last song finishes, the queue starts over from the beginning. |
| `.loop off`   | Disables looping entirely.                                                                       |

*(If you run `.loop` without arguments, it will toggle between Track Loop -> Queue Loop -> Off).*
