Installation

Basic configuration

The shell "GUI" for ncmpcpp is highly customizable. Edit ~/.ncmpcpp/config to your liking. If, after installation, ~/.ncmpcpp/config has not been created, you could copy the sample config, change owner and edit at the very least the following three configuration options:

mpd_host - Should point to the host on which mpd resides, can be "localhost" or "127.0.0.1" if on the same machine

mpd_port - Unless you've changed the defaults of mpd, this should be "6600"

mpd_music_dir - The same directory value as specified in "music_directory" in mpd.conf

This corresponds to the playback modes; ordered from left to right, they are:

r - repeat mode [r-----]

z - random mode [-z----]

y - single mode [--s---]

R - consume mode [---c--]

x - crossfade mode [----x-]

The final "-" is only active when the user forces an update to the datebase via u.

Remapping keys

A listing of keys and their respective functions is available from within npmpcpp itself via hitting 1. Users may remap any of the default keys simply by copying /usr/share/doc/ncmpcpp/keys to ~/.ncmpcpp/ and editing it.
ncmpcpp-git users have to copy /usr/share/doc/ncmpcpp/bindings instead.