Queue

The queue is Nokkvi’s active play queue — everything you hear flows through it. You can build it on the fly while browsing, or replace it entirely when you want to listen to something specific.

Adding to the Queue

Enter behavior

Pressing Enter on a focused album or track is the most common way to start playing. What it does depends on the enter_behavior setting:

Value	Behavior
play_all (default)	Replaces the queue with the full album (or all songs in the current view) and starts playing
play_single	In song-level views (Songs, the queue), replaces the queue with just the focused track. On a focused album or artist, it behaves like play_all and replaces the queue with the whole album/artist
append_and_play	Adds the item to the end of the queue and starts playing it

Shuffle play

By default Enter plays a collection in list order. Turn on enter_shuffle (Settings → General → Shuffle Play on Enter) and every Enter or click that starts a collection instead plays it in a fresh random order — a new shuffle each time, not a saved one. It applies the same way in every library view: an album, an artist’s tracks, a genre, a playlist, or the current Songs list.

To shuffle just once without changing the setting, press Ctrl + Enter (the Shuffle Play hotkey) on the focused item or selection, or right-click and choose Shuffle Play. That forces a one-shot shuffle of the whole batch regardless of how enter_shuffle is set.

The two interact in one place: with enter_shuffle on, activating a specific track inside an expanded album or playlist pins that track first and shuffles the rest behind it, so you still start where you clicked. Ctrl + Enter ignores that and shuffles everything.

Add without replacing

Shift + A adds the focused item to the end of the queue without clearing what’s already there. Works on individual tracks and on albums (which queues all their tracks).

Library Browser and drag and drop

While on the Queue view, press Ctrl + E to open the Library Browser — a side panel with tabs for Songs, Albums, Artists, Genres, and Similar. You can drag tracks from the Library Browser and drop them into the queue at a specific position; a drop indicator shows where they’ll land.

Similar Songs and Top Songs

Nokkvi can ask your Navidrome server for recommendations powered by Last.fm. Triggering either feature automatically switches to the Queue view and opens the Library Browser on the Similar tab.

Key	Action
Shift + S	Find songs similar to the currently playing track
Shift + T	Find the most-played songs by the currently playing track’s artist

Both hotkeys operate on the currently playing track. Find Similar warns with a toast if nothing’s playing. Top Songs also needs the playing track to carry artist metadata — if it has none, a toast tells you there’s no artist metadata for the currently playing track. To run either action against a different track, album, or artist, right-click it and pick Find Similar or Top Songs from the context menu; those entries act on the focused / right-clicked item.

Results are limited to songs already in your library — Navidrome matches Last.fm’s recommendations against your local collection, so tracks you don’t own won’t appear. The Similar tab header shows which result set is loaded (e.g. “Similar to: Paranoid Android” or “Top Songs: Radiohead”).

Both features require Last.fm or ListenBrainz to be configured on the server. See Scrobbling for setup.

Managing the Queue

Key	Action
Shift + Up / Shift + Down	Move the focused track up or down
Ctrl + D	Remove the focused track
Shift + D	Clear the entire queue

Queue sync

Nokkvi can save your whole queue to the Navidrome server and pull it back later — on another machine, or in a fresh session after you restart. The playing track and its exact position travel with it, so a pull drops you back mid-song rather than at the top of the list.

A single sync button — a two-way (up-and-down) arrows icon — appears in the queue header once your server supports it. Clicking it opens a small menu with two rows; each spells out what it replaces, so the direction is unmistakable before you commit:

• Push to server — Replaces the queue saved on the server. Saves the current queue as a full replace: the server holds one saved queue per user, and each push overwrites the previous one. Pushing an empty queue is refused rather than wiping the saved copy, so you can’t clear it by accident. A toast confirms Pushed N tracks to server.
• Pull from server — Replaces your local queue. Swaps your local queue for the server’s saved one. It doesn’t change whether you’re playing or paused: if you were listening, playback continues from the saved track and position; if you were paused, you stay paused and pressing Play picks up from that spot. A toast confirms Pulled N tracks from server, or reports No saved queue on server when nothing was ever pushed.

Choosing a row runs it and closes the menu; click elsewhere or press Escape to dismiss the menu without doing anything.

The round trip is faithful in the ways that usually break:

• Duplicates survive. The same track can sit in the queue more than once and the playhead still lands on the right copy — the sync keys the current track by its position, not by its id.
• Large queues are fine. Saves go up as POST request bodies, so a multi-thousand-track queue won’t hit a URL-length limit at a reverse proxy.
• Missing tracks are dropped. If a saved track has since left your library, the server omits it and Nokkvi clamps the playhead to what’s left.

Requirements

Queue sync rides the OpenSubsonic indexBasedQueue extension, which Navidrome added in 0.58.5. The sync button stays hidden until Nokkvi confirms the server advertises the extension at login, and it also hides during radio playback — where the position is a stream offset, not a track. On an older server the button simply doesn’t appear.

From the command line

nokkvi queue-push and nokkvi queue-pull do the same thing headless, for a window-manager keybind or a script. They enforce the same rules as the sync menu — queue-push refuses an empty queue, and both report unsupported when the server lacks the extension or unavailable during radio. The network round trip is asynchronous, so the command returns as soon as the request is dispatched; a later failure surfaces as an in-window toast. See the CLI reference for the full verb table.

Sort modes

Each pick from the sort dropdown physically reorders the queue. Manual reorder (drag, Shift + ↑/↓) keeps working from any mode.

• Album, Artist, Title, Duration, Genre, Rating, Most Played
• Random — one-shot shuffle. Re-select it (or toggle the order arrow while Random is active) to reshuffle. The mode itself isn’t persisted to config.toml, so a relaunch restores whichever deterministic sort was active before.

The dropdown also ends with a Roulette entry — same press-Enter-to-stop slot-machine pick as every other slot-list view. Ctrl + R triggers it from the keyboard.

The X playback mode is a different concept: it shuffles play order on the fly without rearranging the queue. Use Random sort when you want the visible queue order itself to be shuffled.

Columns

The gear icon in the queue header toggles optional columns. Toggles persist per-view.

Column	Notes
Multi-select	Adds a leading checkbox column and a tri-state header. See Library Basics → Multi-select.
Index	Row number.
Thumbnail	Per-track album cover.
Stars	0–5 star rating.
Album	Album name (clickable — see Click-through expansion).
Genre	Stacks under Album when both are visible; takes over the Album slot at album-size font when Album is hidden; auto-shows when the queue is sorted by Genre.
Duration	Track length.
Love	Heart icon for the favorited flag.
Plays	Server-tracked play count.

Playback Modes

Random, Repeat, and Consume follow long-standing MPD conventions — the same names and behaviors that have been used across MPD clients for years. Toggle them from the player bar or with keyboard shortcuts.

Key	Mode	Behavior
X	Random	Plays tracks in random order
Z	Repeat	Press once to repeat the current track; press again to repeat the whole queue; press a third time to turn off
C	Consume	Tracks are removed from the queue as they finish playing — useful for a one-time listening session

Artwork panel

The right-hand artwork panel shows the cover for the now-playing track. Right-click it for Refresh Artwork when a cover changes server-side. For sizing and visibility controls, see Artwork & Performance.

This cover is also where synced lyrics display when the Lyrics toggle is on, following the playing track line by line — and where the over-cover visualizer draws. All three coexist: the visualizer keeps playing beneath the words.