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 updatesudo 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 = yesheader_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 like
white,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.


