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. Can be positioned at the top (horizontal tabs) or left side (vertical), controlled by the
nav_layoutsetting. - 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 |
Dual-Pane Layout
Section titled “Dual-Pane Layout”Albums, Artists, Genres, and Playlists use a two-pane layout. The left pane is the scrollable list; the right pane shows the focused item’s detail — artwork, track listing, or sub-items. Press Shift + Enter on a focused item to expand it, or Escape to close 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 into browsing panel |
/ | Open search in the current view |
Escape | Close search, collapse panel, 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.