Complete ncmpcpp guide: the most powerful MPD client for your terminal

Introduction

ncmpcpp is a ncurses-based music client designed to work with the Daemon Music Reproduction (MPD). It offers a rich and highly configurable interface that allows you to control reproduction, create playlists and explore your audio library directly from the terminal.

Installation

In most Linux distributions, ncmpcpp is available in official repositories. For example, in Ubuntu or Debian you can install it with:

  • sudo apt update
  • sudo apt install ncmpcpp

In Arch Linux and derivatives:

  • sudo pacman -S ncmpcpp

If you prefer to compile from the source code, visit the official repository in GitHub and follow the instructions of the README file.

Basic configuration

The configuration file is found in~/.ncmpcpp/config. When you run ncmpcpp for the first time, you create an example file that you can copy and edit.

  • cp /usr/share/doc/ncmpcpp/config.example ~/.ncmpcpp/config
  • Edit the file with your favorite editor to adjust options such as the display, column format and colors.

A minimum configuration could include:

  • mpd_host = 'localhost'
  • mpd_port = '6600'
  • visualizer_in_stereo = yes
  • header_visibility = yes

Main characteristics

  • Navigation by artist, album and genre with tree view.
  • Support for dynamic and static playlists.
  • Integrated spectrum display (e.g. spectrum, scope).
  • ID3 label editing from the interface.
  • Support for song letters and albums coverage.
  • Access to streaming services through plugins (e.g. Spotify, Tidal) through MPD and external supplements.

Keyboard shortcuts

ncmpcpp is designed to be used completely with the keyboard. Some of the most useful shortcuts are:

  • Enter: play the selected song or enter a directory.
  • Space: pause or resume reproduction.
  • s: stop reproduction.
  • +and-: increase or decrease volume.
  • ]and[: look forward and back on the current track.
  • l: load the current playlist.
  • L: save the current playlist.
  • F1: show the help.

Personalization and themes

The appearance of ncmpcpp is controlled by color and format variables in the configuration file. You can define custom color pallets, change the column format and activate different visualizers.

  • Colors: use ANSI codes or names likewhite, red, green.
  • Track format:song_format = '{%a - }{%t}|{%f}'
  • Viewer:visualizer_type = 'spectrum'orvisualizer_type = 'wave'

There are communities that share predefined themes on sites like GitHub or Reddit; it is enough to copy the configuration block and restart ncmpcpp.

Advantages and disadvantages

  • Advantages:very low resource consumption, great flexibility, works without graphic environment, ideal for minimalist servers or workstations.
  • Disadvantages:requires MPD to be running and configured; the initial learning curve can be pronounced for users used to graphic players.

Conclusion

ncmpcpp combines MPD power with an elegant and fully customizable terminal interface. If you are looking for a light, fast and able to adapt to any workflow, it is worth spending time on its installation and configuration. With the right shortcuts and a theme that suits your taste, you will transform your terminal into a professional audio control center.

This work is under aCreative Commons License Attribution 4.0 International for Francesc Roig francesc @ vivaldi.net.

EnglishenEnglishEnglish