Ncspot Guide - hrkfdn/ncspot GitHub Wiki

Introduction

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.

Keep in mind

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.

Pantalla de búsqueda

Comparison with official Spotify client

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

Installation

On macOS

ncspot is available on the Homebrew package manager.

brew install ncspot

On Windows

ncspot is available on the Scoop package manager.

scoop install ncspot

On Linux

Install it with your distributions' package manager.

Keyboard shorcuts

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.

Download installer

Navigation

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
⚠️ **GitHub.com Fallback** ⚠️