# Install ncspot with Homebrew, apk, Nix, pacman, scoop, winget, zypper

Cross-platform ncurses Spotify client written in Rust. Version 1.3.4 via Homebrew; verified 2026-05-23.

## Install

```sh
sudo av install brew:ncspot
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ncspot
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add ncspot
```

  Evidence: Alpine Linux edge package indexes: ncspot from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#ncspot
```

  Evidence: nixpkgs package indexes: pkgs/by-name/nc/ncspot/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S ncspot
```

  Evidence: Arch Linux sync databases: ncspot from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install ncspot
```

  Evidence: openSUSE Tumbleweed package metadata: ncspot from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/ncspot
```

  Evidence: Scoop official bucket manifest trees: bucket/ncspot.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id hrkfdn.ncspot -e
```

  Evidence: Windows Package Manager source index: hrkfdn.ncspot from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:ncspot
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ncspot>
- **Version:** 1.3.4
- **Source summary:** Cross-platform ncurses Spotify client written in Rust
- **Homepage:** <https://github.com/hrkfdn/ncspot>
- **Repository:** <https://github.com/hrkfdn/ncspot>
- **Upstream docs:** <https://github.com/hrkfdn/ncspot#readme>
- **License:** BSD-2-Clause
- **Source archive:** <https://github.com/hrkfdn/ncspot/archive/refs/tags/v1.3.4.tar.gz>
- **Last updated:** 2026-05-23T00:18:35Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- ncspot (cli)
- ncspot (alias)

## Build dependencies

- pkgconf
- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.3.4
- Package-manager updated: 2026-05-23
- Local data: ok
- Upstream repository: https://github.com/hrkfdn/ncspot
- Upstream latest detected: v1.3.4 (current)
## Project history and usage

ncspot is a Rust terminal Spotify client built with ncurses and librespot. Its upstream README frames it as a simple, resource-friendly alternative to the official Spotify client, inspired by ncurses MPD clients such as ncmpc, with a special appeal on platforms where Spotify does not ship a native client.

### Project history

The crate history shows ncspot 0.0.0 published on March 4, 2019, followed by 0.1.0 on November 6, 2019. The project reached 1.0.0 on December 16, 2023 and continued with regular 1.x releases through 2026.

### Adoption history

ncspot spread through the Rust and terminal-user ecosystem rather than through Spotify itself. The README documents packaging for macOS via Homebrew, Windows via Scoop and WinGet, Linux via native packages, Flathub and Snapcraft, and BSD systems. The GitHub project also shows thousands of stars, which fits its role as a polished terminal-native client for a mainstream music service.

### How it is used

Users install ncspot to search, browse, queue, and play Spotify tracks from a terminal, often with Vim-like keybindings and a small resource footprint. The practical gotcha is account support: upstream says ncspot requires Spotify Premium because it uses features unavailable to free accounts.

### Why package nerds care

ncspot is a neat modern example of a TUI app that combines old terminal UI conventions with Rust packaging and a reverse-engineered/open Spotify playback stack. For package managers it is a single binary, but one that depends on the moving Spotify/librespot ecosystem and platform audio backends.

### Timeline

- March 4, 2019: ncspot 0.0.0 appears in the Rust crate/docs release history.
- November 6, 2019: ncspot 0.1.0 released.
- December 16, 2023: ncspot 1.0.0 released.
- May 22, 2026: docs.rs lists ncspot 1.3.4.

### Related projects

- librespot, ncurses, ncmpc, MPD clients, Spotify, Rust

### Sources

- <https://docs.rs/crate/ncspot/0.0.0>
- <https://flathub.org/en/apps/io.github.hrkfdn.ncspot>
- <https://formulae.brew.sh/formula/ncspot>
- <https://github.com/hrkfdn/ncspot>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: <platform standard configuration directory>/ncspot/config.toml

## Credential files

- Unix: <user cache directory>/librespot/credentials.json
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ncspot
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - ncspot: normalized package name match | nixpkgs package indexes: pkgs/by-name/nc/ncspot/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - ncspot - 1.1.2-r0: normalized package name match | Alpine Linux edge package indexes: ncspot from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Cross-platform ncurses Spotify client inspired by ncmpc and the likes | https://github.com/hrkfdn/ncspot
- pacman - ncspot - 1.3.3-2: normalized package name match | Arch Linux sync databases: ncspot from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Cross-platform ncurses Spotify client written in Rust, inspired by ncmpc and the likes. | https://github.com/hrkfdn/ncspot
- zypper - ncspot - 1.3.4-1.1: normalized package name match | openSUSE Tumbleweed package metadata: ncspot from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Cross-platform ncurses Spotify client written in Rust | https://github.com/hrkfdn/ncspot
- Scoop - main/ncspot: normalized package name match | Scoop official bucket manifest trees: bucket/ncspot.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - hrkfdn.ncspot: normalized package name match | Windows Package Manager source index: hrkfdn.ncspot from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [pms](https://www.automicvault.com/pkg/brew/pms/) - Shares av.db curated category or tags: cli, media, music, ncurses.
- [shpotify](https://www.automicvault.com/pkg/brew/shpotify/) - Shares av.db curated category or tags: cli, media, music, spotify.
- [chordii](https://www.automicvault.com/pkg/brew/chordii/) - Shares av.db curated category or tags: cli, media, music.
- [dzr](https://www.automicvault.com/pkg/brew/dzr/) - Shares av.db curated category or tags: cli, media, music.
- [mufetch](https://www.automicvault.com/pkg/brew/mufetch/) - Shares av.db curated category or tags: cli, media, music.
- [nowplaying-cli](https://www.automicvault.com/pkg/brew/nowplaying-cli/) - Shares av.db curated category or tags: cli, media, music.
- [spicetify-cli](https://www.automicvault.com/pkg/brew/spicetify-cli/) - Shares av.db curated category or tags: cli, media, music, spotify.
- [abcmidi](https://www.automicvault.com/pkg/brew/abcmidi/) - Shares av.db curated category or tags: cli, media, music.
- [termusic](https://www.automicvault.com/pkg/brew/termusic/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, media, music, rust, terminal.
- [spotify_player](https://www.automicvault.com/pkg/brew/spotify-player/) - Local package facts share a topical domain. Shared terms: cli, media, music, spotify, terminal.
- [librespot](https://www.automicvault.com/pkg/brew/librespot/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, client, media, rust, spotify.

## Combined YAML source

View the package source record on GitHub. [combined/ncspot.yml](https://github.com/automic-vault/db/blob/main/combined/ncspot.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
