[http://unkart.ovh.org/ncmpcpp/ Ncmpcpp] or ncmpcpp is an [[mpd]] client with a UI very similar to ncmpc, but it provides new useful features such as support for regular expressions in search engine, extended song format, items filtering, last.fm support, ability to sort playlist, local filesystem browser and other minor functions.

+

[http://unkart.ovh.org/ncmpcpp/ Ncmpcpp] or ncmpcpp is an [[mpd]] client with a UI very similar to ncmpc, but it provides new useful features such as support for regular expressions in search engine, extended song format, items filtering, last.fm support, ability to sort playlist, local filesystem browser and other minor functions.

To use it, a functional [[mpd]] must be present on the system since ncmpcpp/mpd work together in a client/server relationship.

To use it, a functional [[mpd]] must be present on the system since ncmpcpp/mpd work together in a client/server relationship.

Line 16:

Line 16:

== Basic configuration ==

== Basic configuration ==

−

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

+

The shell "GUI" for ncmpcpp is highly customizable. Edit {{ic|~/.ncmpcpp/config}} to your liking. If, after installation, {{ic|~/.ncmpcpp/config}} has not been created, you could copy the sample config, [[chmod#chown|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_host''' - Should point to the host on which mpd resides, can be "localhost" or "127.0.0.1" if on the same machine

Line 99:

Line 99:

== Remapping keys ==

== Remapping keys ==

−

A listing of keys and their respective functions is available from within npmpcpp itself via hitting {{ic|1}}. Users may remap any of the default keys simply by copying {{ic|/usr/share/doc/ncmpcpp/keys}} to {{ic|~/.ncmpcpp/}} and editing it.

+

A listing of keys and their respective functions is available from within npmpcpp itself via hitting {{ic|1}}. Users may remap any of the default keys simply by copying {{ic|/usr/share/doc/ncmpcpp/keys}} to {{ic|~/.ncmpcpp/}} and editing it.

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.