Skip to content
/ ncspot Public

Cross-platform ncurses Spotify client written in Rust, inspired by ncmpc and the likes.

License

Notifications You must be signed in to change notification settings

hrkfdn/ncspot

Folders and files

NameName
Last commit message
Last commit date
Mar 6, 2023
Jan 23, 2025
May 21, 2024
Dec 30, 2024
Mar 20, 2023
Jun 5, 2022
Mar 16, 2025
Mar 11, 2025
May 21, 2024
May 21, 2024
Mar 16, 2025
Mar 17, 2025
Mar 17, 2025
Mar 13, 2019
Dec 30, 2024
Dec 16, 2023
Feb 26, 2025
Dec 27, 2021
Mar 15, 2025

Repository files navigation

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

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.