Overview
Nokkvi is a desktop music client for Navidrome. It’s keyboard-driven and built around a persistent playback queue.
Interface Layout
Section titled “Interface Layout”Every screen shares the same three-part layout:
- Nav bar — switches between views. The
nav_layoutsetting controls position:top(horizontal tabs, default),side(vertical sidebar), ornone(no nav chrome — only the active page and player bar render). - Main content area — the active view.
- Player bar — always visible at the bottom. Shows the current track, progress scrubber, playback controls, and volume.
Switch views with the number keys or by clicking the nav bar.
| Key | View | What it’s for |
|---|---|---|
1 | Queue | Active playback queue — what’s playing now and what’s up next |
2 | Albums | Browse your library by album |
3 | Artists | Browse by artist |
4 | Songs | Flat list of every track, searchable and sortable |
5 | Genres | Browse by genre |
6 | Playlists | Navidrome playlists |
7 | Radios | Radio stations |
` | Settings | App configuration |
Expanding Items
Section titled “Expanding Items”Albums, Artists, Genres, and Playlists are single scrollable lists. Press Shift + Enter on a focused item to expand it inline — its contents render indented directly below the row (an artist’s albums, an album’s or playlist’s tracks, a genre’s albums). Only one item is expanded at a time; press Shift + Enter again or Escape to collapse it.
While on the Queue view, press Ctrl + E to open the Library Browser — a side panel for browsing and dragging tracks directly into the queue. See the Queue guide for details.
Navigation
Section titled “Navigation”Nokkvi is fully keyboard-navigable. The core keys work the same in every view:
| Key | Action |
|---|---|
Tab / Backspace | Move down / up in the list |
Enter | Activate focused item |
Shift + Enter | Expand / collapse the focused item inline |
/ | Open search in the current view |
Escape | Close search, collapse the expanded item, or go back |
Shift + C | Scroll the list to the currently playing track |
See the Keyboard Shortcuts reference for the full list.
Search
Section titled “Search”Press / in any browsable view to open the inline search bar. Nokkvi filters the list as you type, requesting matching results from the server. Press Escape to unfocus the search bar — the filter stays active. Use the clear button inside the search bar to reset it. In the Settings view, Escape clears the search and restores the full list.