---
description: How the queue works, playback modes, and managing your listening session
---

# 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="../.gitbook/assets/queue-panel.png" 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** (&#8942;) 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.
