Skip to content

Terminal

Applies to nori 0.6 on Linux and macOS terminals.

The terminal client is a whole music player in a terminal, drawn with ratatui. Start it with Download the nori-cli archive for your system and processor, or build it with cargo run --release -p nori-cli (see Install).

Covers are drawn in whichever picture protocol the terminal answers to: kitty graphics, sixel or iTerm2’s, and in half blocks anywhere else. I turns them off.

Under tmux, a tmux that draws sixel keeps the picture in the pane. Otherwise pictures pass through to the outer terminal, and nori draws them again when the pane has focus back; it turns tmux’s focus-events on for that.

? shows every key. The main ones:

KeyDoes
spaceplay or pause
n / pnext song, previous (or the start of this one)
← → or , .back or forward 5 seconds; with shift, 30 seconds
+ / -volume
s / rshuffle on or off; repeat off, all, one
/search
1 … 7Home, Albums, Artists, Songs, Downloads, Equalizer, Settings
tabsidebar, page, panel
N / Q / L / Cthe right panel: now playing, queue, lyrics, devices
Fthe player over the whole window
enter / lopen, or play from here
a / Aadd to the queue, or play next
x / Xplay the whole page, or shuffle it
D / fdownload; favorite
i / ostart a jam with the selected item; join one from its link
mmouse on or off (off: the terminal selects text)
qquit

Idle or paused, the client does not wake at all. Playing, its screen wakes about once a second for the clock, and a few times a second with word-by-word lyrics on screen.