Track Info Display
The now-playing metadata strip — title, artist, album, and the track’s format — can sit in a few different places, set by track_info_display. Default is player_bar_above, a strip on top of the bottom player bar’s controls; the others move the strip under the controls or into the top chrome, fold it into a mini player with the cover, or hide it to give the list and artwork the whole window.
The metadata sits as a strip in the bottom player bar, on top of the transport row, between the list and the controls. Beside the artwork column it’s as wide as the player bar: the list’s width.
Artwork, metadata, and transport merge into one bar topped by a full-width progress scrub that shows elapsed and total time alongside the track’s format and bitrate. On a wide window it spreads into three sections — metadata on the left, transport centered, modes and volume on the right. As the window narrows it folds into a single compact cluster with the mode toggles tucked behind a kebab (⋮) menu.
The scrub has its own seek bar style (mini_player_seekbar_style), separate from the main player bar’s. The default, Capsule, puts the times, format and bitrate inside the bar; every other style puts them beside the track.
Hide the cover, the volume slider or the mode toggles independently under Settings → Interface → Player Bar → Visible Controls (shown while the mini player is the active layout), or with mini_player_show_artwork, mini_player_show_volume and mini_player_show_modes.
The mini player suits a layout without the artwork panel (artwork_column_mode = "never"): its thumbnail keeps the playing album’s cover in sight on every view. With the artwork panel and the list thumbnails already showing the cover, turn the thumbnail off: the title, artist and album then start at the left edge, lined up with the elapsed time above them.
The metadata sits as a strip in the bottom player bar, just below the transport row.
The metadata rides inline in the top navigation row, to the right of the view tabs. In side-nav or no-nav layouts it sits as its own row above the slot list instead.
The metadata gets its own row directly beneath the top navigation bar, as wide as the nav bar: beside the artwork column, that’s the list’s width.
No metadata strip — the list and artwork get the full window.
Which fields the strip shows, and whether they carry title: / artist: / album: labels, is controlled by the strip_show_* keys in the configuration reference.
Bit-Perfect Status Badge
Section titled “Bit-Perfect Status Badge”When bit-perfect output is engaged, the now-playing strip carries a small badge reporting the real state of your sound card’s clock — read from /proc/asound, not the rate nokkvi requested. It shows only while bit-perfect output is in Strict or Relaxed mode and a local track is playing; radio is excluded, since a network stream can’t be bit-perfect.
| Badge | Meaning |
|---|---|
BIT-PERFECT | The device is clocked at the track’s sample rate. Audio is reaching the DAC untouched — no resampling, no DSP. |
RESAMPLED→96k | The device is locked at a different rate (shown in kHz — e.g. →96k), so PipeWire is resampling. When it can, the badge appends the app holding the device at that rate (RESAMPLED→96k · Zen), so you know what to close. |
UNVERIFIED | Nokkvi can’t read the device clock. Usually a Bluetooth sink (which re-encodes the audio, so bit-perfect isn’t possible) or an idle / suspended device. |
A brief blank moment right as a track starts is normal — nokkvi waits for the device to settle before committing to a state, so it won’t flash a false UNVERIFIED. In Relaxed mode the badge also drops for the duration of a same-rate crossfade — the overlapping blend isn’t bit-perfect — and returns once the next track settles.