1
0
Fork
You've already forked nkso
0
  • Rust 100%
2025年03月30日 12:48:50 -03:00
.cargo Add manpage generation using xtask 2023年03月06日 21:55:19 +01:00
.vscode style(vscode): add EditorConfig extension recommendation 2024年05月21日 13:40:57 +02:00
doc rename ncspot => nkso 2025年03月13日 15:17:59 -03:00
images rename ncspot => nkso 2025年03月13日 15:17:59 -03:00
misc rename ncspot => nkso 2025年03月13日 15:17:59 -03:00
src update and remove notify feature 2025年03月30日 12:48:50 -03:00
xtask rename ncspot => nkso 2025年03月13日 15:17:59 -03:00
.editorconfig style(vscode): add EditorConfig extension recommendation 2024年05月21日 13:40:57 +02:00
.gitignore update and remove notify feature 2025年03月30日 12:48:50 -03:00
build.rs Add Git commit hash to version string 2023年12月16日 18:34:43 +01:00
Cargo.lock update and remove notify feature 2025年03月30日 12:48:50 -03:00
Cargo.toml update and remove notify feature 2025年03月30日 12:48:50 -03:00
LICENSE Create LICENSE 2019年03月13日 13:56:30 +01:00
README.md rename ncspot => nkso 2025年03月13日 15:17:59 -03:00
rust-toolchain.toml [create-pull-request] automated change 2025年02月26日 20:16:18 +01:00
rustfmt.toml Add rustfmt config 2021年12月27日 09:32:16 +01:00
todo.xit shorten spot ns 2025年03月13日 22:11:22 -03:00

nkso logo

An ncurses Spotify client written in Rust using librespot

Crates.io Gitter

nkso search tab

nkso 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.

nkso 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

nkso 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/nkso. Detailed configuration information can be found here.

Building

Building nkso requires a working Rust installation and a Python 3 installation. To compile nkso, run cargo build. For detailed instructions on building nkso, 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.