Ncspot Guide - hrkfdn/ncspot GitHub Wiki
ncspot
is a ncurses Spotify client written in Rust using librespot
. It is heavily inspired in ncurses MPD clients, such as ncmpc. The motivation for ncspot was to provide a simple and friendly alternative with the same features as the official client and that supported platforms that currently do not have a Spotify client, such as BSD distributions.
ncspot
offers features that are legally incompatible with the Spotify free tier. Check account plans and user guidelines. You should have an existing premium Spotify subscription to use ncspot
.
ps_mem
was used to analyze the performance when playing back the same song on Linux:
Client | Private Memory | Shared Memory | Total |
---|---|---|---|
ncspot | 22.1 MiB | 24.1 MiB | 46.2 MiB |
Spotify | 407.3 MiB | 592.7 MiB | 1000.0 MiB |
ncspot
is available on the Homebrew package manager.
brew install ncspot
ncspot
is available on the Scoop package manager.
scoop install ncspot
Install it with your distributions' package manager.
The key combinations listed below are configured by default. In addition,
if you compiled ncspot
with [MPRIS] support, you may be able to use media keys to control playback.
Key | Command |
---|---|
? | Show the help screen. |
F1 | ÇQeue. |
F2 | Search. |
F3 | Library. |
F8 | Album cover (if created with the “cover” function). |
/ | Open a search bar similar to Vim. |
: | Open a command prompt similar to Vim. |
Esc | Close the search bar similar to Vim or the command prompt. |
Q | Exit ncspot . |
+ |
volup 1 |
_ |
voldown 1 |
< |
playnext; move down 1 |
> |
previous |
? |
help |
Backspace |
back |
Ctrl+a |
move left 1 |
Ctrl+e |
move right 1 |
Ctrl+l |
redraw |
Ctrl+n |
move down 1 |
Ctrl+p |
move up 1 |
Ctrl+s |
save queue |
Ctrl+v |
insert |
Down |
move down 1 |
End |
move bottom |
Enter |
play |
F1 |
focus queue |
F2 |
focus search |
F3 |
focus library |
Home |
move top |
Left |
move left 1 |
PageDown |
move down 5 |
PageUp |
move up 5 |
Right |
move right 1 |
Shift+Down |
shift down 1 |
Shift+Up |
shift up 1 |
Shift+a |
goto artist |
Shift+b |
seek -10000 |
Shift+f |
seek +10000 |
Shift+m |
similar current |
Shift+n |
jumpprevious |
Shift+o |
open current |
Shift+p |
playpause |
Shift+s |
stop |
Shift+u |
update |
Shift+x |
share current |
Space |
queue; move down 1 |
Up |
move up 1 |
[ |
voldown 5 |
] |
volup 5 |
a |
goto album |
b |
seek -1000 |