[http://unkart.ovh.org/ncmpcpp/ Ncmpcpp] or ncmpc++ 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.

[http://unkart.ovh.org/ncmpcpp/ Ncmpcpp] or ncmpc++ 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.

[[pacman|Install]] {{Pkg|ncmpcpp}} from the [[official repositories]].

+

+

== Basic configuration ==

+

+

After installation a sample configuration file can be found in {{ic|/usr/share/doc/ncmpcpp/config}}.

+

+

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_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 {{ic|mpd.conf}}

−

==(Very) Basic configuration==

+

== Enabling visualization ==

−

After installation a sample configuration file can be found in /usr/share/doc/ncmpcpp/config

−

If, after installation, ~/.ncmpcpp/config has not been created, you could copy the sample config and edit at the very least the following three configuration options:

+

For visualization, add a few lines to {{ic|/etc/mpd.conf}} to enable the generation of the [[Wikipedia:Fast Fourier transform|fast Fourier transform]] data for the visualization:

−

* 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)

−

==Enabling visualization==

+

audio_output {

−

For visualization, one needs the {{AUR|ncmpcpp-git}} package from the [[AUR]]. Once built, add a few lines to {{ic|/etc/mpd.conf}} to enable the generation of the [[Wikipedia:Fast Fourier transform|fast Fourier transform]] data for the visualization:

+

type "fifo"

+

name "my_fifo"

+

path "/tmp/mpd.fifo"

+

format "44100:16:2"

+

}

−

<pre>

−

audio_output {

−

type "fifo"

−

name "my_fifo"

−

path "/tmp/mpd.fifo"

−

}

−

</pre>

Additional lines need to be added to {{ic|~/.ncmpcpp/config}}

Additional lines need to be added to {{ic|~/.ncmpcpp/config}}

−

<pre>

+

visualizer_fifo_path = "/tmp/mpd.fifo"

−

visualizer_fifo_path = "/tmp/mpd.fifo"

+

visualizer_output_name = "my_fifo"

−

visualizer_output_name = "my_fifo"

+

visualizer_sync_interval = "1"

−

visualizer_sync_interval = "1"

+

#visualizer_type = "wave" (spectrum/wave)

−

#visualizer_type = "wave" (spectrum/wave)

+

visualizer_type = "spectrum" (spectrum/wave)

−

visualizer_type = "spectrum" (spectrum/wave)

+

−

</pre>

+

Users can choose between either a spectrum analyzer or wave form.

+

+

== Basic usage ==

−

Users can chose between either a spectrum analyzer or wave form.

+

=== Loading ncmpcpp ===

−

==Basic Usage==

−

===Loading ncmpc++===

Load ncmpc++ in a shell

Load ncmpc++ in a shell

$ ncmpcpp

$ ncmpcpp

−

===Remapping keys===

−

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

−

===Different views===

+

+

=== Different views ===

+

Partial list of views within ncmpc++

Partial list of views within ncmpc++

*{{Keypress|0}} - Clock

*{{Keypress|0}} - Clock

Line 70:

Line 74:

*{{Keypress|9}} - Music visualizer

*{{Keypress|9}} - Music visualizer

−

===Other UI keys===

+

=== Other UI keys ===

+

*{{Keypress|\}} - Switch between classic and alternative views

*{{Keypress|\}} - Switch between classic and alternative views

*{{Keypress|#}} - Display bitrate of file

*{{Keypress|#}} - Display bitrate of file

Line 78:

Line 83:

*{{Keypress|l}} - Retrieve song lyrics for current song Show/hide lyrics

*{{Keypress|l}} - Retrieve song lyrics for current song Show/hide lyrics

−

{{Note|As mentioned above, the visualizer is not enabled in the ncmpcpp package in the repo. Users will need to build the git version from the AUR.}}

+

=== Playback modes ===

−

−

===Playback modes===

Noticed the control panel in the upper right; shown in alternative mode:

Noticed the control panel in the upper right; shown in alternative mode:

Line 99:

Line 102:

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

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

+

+

== Remapping keys ==

+

+

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

Contents

Introduction

Ncmpcpp or ncmpc++ 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.

The shell "GUI" for ncmpcpp is highly customizable. Edit ~/.ncmpcpp/config to your liking. For inspiration, see the following resources:

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

Remapping keys

A listing of keys and their respective functions is available from within npmpcpp itself via hitting Template:Keypress. 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.