nncmpp/nncmpp.adoc

2.9 KiB
Raw Blame History

nncmpp(1)

Name

nncmpp - terminal-based MPD client

Synopsis

nncmpp [OPTION]…​

Description

nncmpp is a terminal-based GUI-like MPD client. On start up it will welcome you with an overview of all key bindings and the actions theyre assigned to. Individual tabs can be switched to either using the mouse or by pressing M-1 through M-9, corresponding to the order they appear in.

Options

-d, --debug

Adds a "Debug" tab showing all MPD communication and other information that help debug various issues.

-h, --help

Display a help message and exit.

-V, --version

Output version information and exit.

Configuration

Unless you run MPD on a remote machine, on an unusual port, or protected by a password, the client doesnt need a configuration file to work. It is, however, likely that youll want to customize the looks or add some streams. You can start off with the following snippet:

settings = {
	address    = "localhost:6600"
	password   = "<your password>"
	root       = "~/Music"
}
colors = {
	normal      = ""
	highlight   = "bold"
	elapsed     = "reverse"
	remains     = "ul"
	tab_bar     = "reverse"
	tab_active  = "ul"
	even        = ""
	odd         = ""
	selection   = "reverse"
	multiselect = "-1 6"
	defocused   = "ul"
	scrollbar   = ""
}
streams = {
	"dnbradio.com" = "http://www.dnbradio.com/hi.m3u"
	"BassDrive.com" = "http://bassdrive.com/v2/streams/BassDrive.pls"
}

Terminal attributes are accepted in a format similar to that of git-config(1), only named colours arent supported. The distribution contains example colour schemes in the contrib directory.

Spectrum visualiser

When built against the FFTW library, nncmpp can make use of MPDs "fifo" output plugin to show the audio spectrum. This has some caveats, namely that it may not be properly synchronized, only one instance of a client can read from a given named pipe at a time, it will cost you some CPU time, and finally youll need to set it up manually to match your MPD configuration, e.g.:

settings = {
	...
	spectrum_path = "~/.mpd/mpd.fifo"  # "path"
	spectrum_format = "44100:16:2"     # "format" (samplerate:bits:channels)
	spectrum_bars = 8                  # beware of exponential complexity
	...
}

The sample rate should be greater than 40 kHz, the number of bits 8 or 16, and the number of channels doesnt matter, as theyre simply averaged together.

Files

nncmpp follows the XDG Base Directory Specification.

~/.config/nncmpp/nncmpp.conf

The configuration file.

Reporting bugs

Use https://git.janouch.name/p/nncmpp to report bugs, request features, or submit pull requests.

See also

mpd(1)