# The queue

The queue is your current listening session. It's the list of tracks Nuclear will play through, shown in the panel on the right side of the window.

<figure><img src="/files/jxiuYWBaBvqzlhuMdiiX" alt="The queue panel showing several tracks with one playing" width="300"><figcaption><p>The queue panel</p></figcaption></figure>

## Adding tracks

You can add tracks to the queue from search results, album pages, artist pages, and playlists:

* Click the **+** button on a track to append it to the end of the queue
* Use the **three-dot menu** (⋮) for more options: **Play now**, **Play next**, or **Add to queue**

Track tables also have **Play all** and **Add all to queue** buttons at the top, which add every track in the list at once.

## Reordering and removing

Drag tracks in the queue panel to reorder them. To remove a track, hover over it and click the remove button.

The queue header has a clear button (trash icon) that removes all tracks and stops playback. You can also save the current queue as a playlist from the queue header menu.

## Playback modes

The player bar has shuffle and repeat buttons that control how Nuclear moves through the queue:

* **Repeat off**: plays through the queue in order and stops after the last track
* **Repeat all**: loops back to the first track after the last one
* **Repeat one**: replays the current track indefinitely
* **Shuffle on**: picks a random track from the queue after each track ends

## Persistence

The queue saves to disk automatically. When you close and reopen Nuclear, your queue and position are restored. Tracks that were mid-stream get reset to an idle state so they can be re-fetched when you play them again.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nuclearplayer.com/nuclear/core-concepts/the-queue.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
