#spotify #terminal #ncurses #librespot #mpd-client #remote-control #track

bin+lib ncspot

ncurses Spotify client written in Rust using librespot, inspired by ncmpc and the likes

50 releases (6 stable)

new 1.2.1 Oct 31, 2024
1.1.2 Jul 16, 2024
1.1.0 Mar 5, 2024
1.0.0 Dec 16, 2023
0.0.0 Mar 4, 2019

#45 in Audio

Download history 146/week @ 2024-07-17 129/week @ 2024-07-24 73/week @ 2024-07-31 47/week @ 2024-08-07 45/week @ 2024-08-14 43/week @ 2024-08-21 68/week @ 2024-08-28 61/week @ 2024-09-04 96/week @ 2024-09-11 155/week @ 2024-09-18 82/week @ 2024-09-25 80/week @ 2024-10-02 104/week @ 2024-10-09 251/week @ 2024-10-16 95/week @ 2024-10-23 231/week @ 2024-10-30

691 downloads per month

BSD-2-Clause

440KB
11K SLoC

ncspot logo

An ncurses Spotify client written in Rust using librespot

Crates.io Gitter

ncspot search tab

ncspot is an ncurses Spotify client written in Rust using librespot. It is heavily inspired by ncurses MPD clients, such as ncmpc. My motivation was to provide a simple and resource friendly alternative to the official client as well as to support platforms that currently don't have a Spotify client, such as the *BSDs.

ncspot only works with a Spotify premium account as it offers features that are not available for free accounts.

Features

  • Support for tracks, albums, playlists, genres, searching...
  • Small resource footprint
  • Support for a lot of platforms
  • Vim keybindings out of the box
  • IPC socket for remote control
  • Automatic authentication using a password manager

Installation

ncspot is available on macOS (Homebrew), Windows (Scoop, WinGet), Linux (native package, Flathub and Snapcraft) and the BSD's. Detailed installation instructions for each platform can be found here.

Configuration

A configuration file can be provided. The default location is ~/.config/ncspot. Detailed configuration information can be found here.

Building

Building ncspot requires a working Rust installation and a Python 3 installation. To compile ncspot, run cargo build. For detailed instructions on building ncspot, there is more information here.

Packaging

Information about provided files, how to generate some of them and current package status accross platforms can be found here.

Dependencies

~53–93MB
~1.5M SLoC