# Install ncmpcpp with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper

Ncurses-based client for the Music Player Daemon. Version 0.10.1 via Homebrew; verified 2026-06-25.

## Install

```sh
sudo av install brew:ncmpcpp
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ncmpcpp
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install ncmpcpp
```

  Evidence: MacPorts ports tree: audio/ncmpcpp/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add ncmpcpp
```

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

- Debian apt (92%):

```sh
sudo apt install ncmpcpp
```

  Evidence: Debian stable package indexes: ncmpcpp from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install ncmpcpp
```

  Evidence: Fedora Rawhide package metadata: ncmpcpp from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#ncmpcpp
```

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

- pacman (92%):

```sh
sudo pacman -S ncmpcpp
```

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

- zypper (92%):

```sh
sudo zypper install ncmpcpp
```

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

## Package facts

- **Package key:** brew:ncmpcpp
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ncmpcpp>
- **Version:** 0.10.1
- **Source summary:** Ncurses-based client for the Music Player Daemon
- **Homepage:** <https://rybczak.net/ncmpcpp/>
- **Repository:** <https://github.com/ncmpcpp/ncmpcpp>
- **Upstream docs:** <https://rybczak.net/ncmpcpp>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://github.com/ncmpcpp/ncmpcpp/archive/refs/tags/0.10.1.tar.gz>
- **Last updated:** 2026-06-25T13:37:56+02:00
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- ncmpcpp (cli)
- ncmpcpp (alias)

## Dependencies

- boost
- fftw
- icu4c@78
- libmpdclient
- ncurses
- readline
- taglib

## Build dependencies

- autoconf
- automake
- libtool
- pkgconf

## Uses from macOS

- curl

## 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: 0.10.1
- Package-manager updated: 2026-06-25
- Local data: ok
- Upstream repository: https://github.com/ncmpcpp/ncmpcpp
- Upstream latest detected: 0.10.1 (current)
## Project history and usage

ncmpcpp, NCurses Music Player Client Plus Plus, is a featureful ncurses client for Music Player Daemon inspired by ncmpc. Its upstream README says the project is in maintenance mode, feature-complete for maintainer Andrzej Rybczak, with serious bugs and dependency breakage still in scope.

### Project history

The release notes on the upstream site show rapid 0.1-0.5 growth during 2008-2010: media library, lyrics, playlist editor, tag editor, local browser, Last.fm artist info, visualizer, alternative UI, libmpdclient2, idle support, and many configuration options. The 0.6 beta series in 2014 redesigned keybindings, added readline support, removed polling mode, and required MPD >= 0.16; the 0.7 line in 2015-2016 added richer visualizer modes, 256-color/background customization, multiple config files, action chains, and compatibility with newer MPD.

### Adoption history

ncmpcpp became one of the iconic MPD terminal clients because it adds the features many MPD users want beyond a minimal queue browser: library views, tag editing, lyrics, visualizer support, and deep theming. The GitHub page observed for this batch showed about 2.5k stars and 237 forks. The Homebrew formula API response consulted for this July 2026 batch reported 45 install-on-request events in 30 days and 1,602 in 365 days.

### How it is used

Package nerds use ncmpcpp as the full-screen MPD cockpit: keyboard-driven queue control, database browsing, media-library navigation, playlist editing, tag cleanup with TagLib, lyrics fetching, optional FFTW-backed visualizer output, and heavily customized config/bindings under `~/.ncmpcpp` or XDG config paths. It is especially associated with riced terminal desktops where MPD handles playback and ncmpcpp provides the visible music UI.

### Why package nerds care

ncmpcpp is significant because it became the expressive counterpart to ncmpc. In MPD setups, it is the client people screenshot, theme, and wire into terminal-based desktops, while still speaking the same MPD model: a persistent daemon with replaceable clients.

### Timeline

- 2008-08-07: 0.1.1 appeared in the release notes with example config and customization improvements.
- 2008-09-20: 0.2.3 added the complex tag editor and Last.fm artist info.
- 2009-09-09: 0.4 added visualizer modes and an alternative UI.
- 2014-09-03: 0.6_beta1 redesigned keybindings and required MPD >= 0.16.
- 2021-01-24: 0.9.2 fixed regressions around external commands and password prompts.
- 2024-10-24: 0.10.1 fixed libc++ compilation and an empty-playlist reverse crash.

### Related projects

- Music Player Daemon, ncmpc, libmpdclient, TagLib, FFTW, Last.fm

### Sources

- <https://formulae.brew.sh/api/formula/ncmpcpp.json>
- <https://github.com/ncmpcpp/ncmpcpp>
- <https://raw.githubusercontent.com/ncmpcpp/ncmpcpp/master/CHANGELOG.md>
- <https://rybczak.net/ncmpcpp/>
- <https://www.musicpd.org/clients/>


## 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: $XDG_CONFIG_HOME/ncmpcpp/config, ~/.ncmpcpp/config
## Source Database Details

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

## Other Package-Manager Records

- Debian apt - ncmpcpp - 0.9.2-2.2+b1: normalized package name match | Debian stable package indexes: ncmpcpp from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | ncurses-based client for the Music Player Daemon (MPD) | https://github.com/ncmpcpp/ncmpcpp
- Nix - ncmpcpp: normalized package name match | nixpkgs package indexes: pkgs/by-name/nc/ncmpcpp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - ncmpcpp - 0.9.2-2build9: normalized package name match | Ubuntu 24.04 LTS package indexes: ncmpcpp from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | ncurses-based client for the Music Player Daemon (MPD) | https://ncmpcpp.rybczak.net
- apk - ncmpcpp - 0.10.1-r4: normalized package name match | Alpine Linux edge package indexes: ncmpcpp from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Ncurses based MPD client inspired by ncmpc | http://rybczak.net/ncmpcpp
- apk - ncmpcpp-doc - 0.10.1-r4: normalized package name match | Alpine Linux edge package indexes: ncmpcpp-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Ncurses based MPD client inspired by ncmpc (documentation) | http://rybczak.net/ncmpcpp
- dnf - ncmpcpp - 0.10.1-10.fc45: normalized package name match | Fedora Rawhide package metadata: ncmpcpp from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Featureful ncurses based MPD client inspired by ncmpc | http://ncmpcpp.rybczak.net/
- pacman - ncmpcpp - 0.10.1-8: normalized package name match | Arch Linux sync databases: ncmpcpp from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Featureful ncurses based MPD client inspired by ncmpc | https://github.com/ncmpcpp/ncmpcpp
- zypper - ncmpcpp - 0.10.1-1.7: normalized package name match | openSUSE Tumbleweed package metadata: ncmpcpp from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Music Player Daemon Client | https://rybczak.net/ncmpcpp
- MacPorts - ncmpcpp: normalized package name match | MacPorts ports tree: audio/ncmpcpp/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata.
- [fftw](https://www.automicvault.com/pkg/brew/fftw/) - Runtime dependency declared by Homebrew.
- [ncurses](https://www.automicvault.com/pkg/brew/ncurses/) - Runtime dependency declared by Homebrew.
- [taglib](https://www.automicvault.com/pkg/brew/taglib/) - Runtime dependency declared by Homebrew.
- [autoconf](https://www.automicvault.com/pkg/brew/autoconf/) - Build dependency declared by Homebrew.
- [automake](https://www.automicvault.com/pkg/brew/automake/) - Build dependency declared by Homebrew.
- [libtool](https://www.automicvault.com/pkg/brew/libtool/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [ncmpc](https://www.automicvault.com/pkg/brew/ncmpc/) - Shares av.db curated category or tags: audio, cli, media, mpd, music-player-client.
- [rmpc](https://www.automicvault.com/pkg/brew/rmpc/) - Shares av.db curated category or tags: audio, cli, media, mpd, music-player-client.
- [mpc](https://www.automicvault.com/pkg/brew/mpc/) - Shares av.db curated category or tags: audio, cli, media, mpd, music-player-client.
- [cmus](https://www.automicvault.com/pkg/brew/cmus/) - Shares av.db curated category or tags: audio, cli, media, ncurses.
- [mp3blaster](https://www.automicvault.com/pkg/brew/mp3blaster/) - Shares av.db curated category or tags: audio, cli, media, ncurses.
- [mpd](https://www.automicvault.com/pkg/brew/mpd/) - Shares av.db curated category or tags: audio, cli, media, mpd.
- [mpdas](https://www.automicvault.com/pkg/brew/mpdas/) - Shares av.db curated category or tags: audio, cli, media, mpd.
- [mpdscribble](https://www.automicvault.com/pkg/brew/mpdscribble/) - Shares av.db curated category or tags: audio, cli, media, mpd.
- [vimpc](https://www.automicvault.com/pkg/brew/vimpc/) - Both packages work with overlapping file formats or content types. Shared terms: audio, based, cli, client, libmpdclient.

## Combined YAML source

View the package source record on GitHub. [combined/ncmpcpp.yml](https://github.com/automic-vault/db/blob/main/combined/ncmpcpp.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
