Ncmpcpp

A TUI mpd client.

Documentation

github	https://github.com/ncmpcpp/ncmpcpp
man ncmpcpp	https://man.archlinux.org/man/extra/ncmpcpp/ncmpcpp.1.en

Tutorials

cheat sheet

https://pkgbuild.com/~jelle/ncmpcpp/

Locations

~/.ncmpcpp/config	user config
~/.ncmpcpp/bindings	user keybindings
/usr/share/doc/ncmpcpp/bindings	global keybindings

Install

sudo pacman -S ncmpcpp mpd

Usage

Cli

ncmpcpp -s browser  # open to browser screen

Menus

1 - Current playlist
2 - Filesystem browser
3 - DB search
4 - Library
5 - Playlist editor
6 - Tag editor (very powerful!)
7 - Output selector
8 - Music visualizer
= - Clock
F1 - Help

1. Playlist

c  # clear playlist
~  # find song in library
`  # choose random item (ex. ` b 10 adds 10x random albums)

4. Library

4  # cycle views ($1,album,track), (album-by-$1,track), (album,track)

e  # edit tags (or if unavail, at least prints filepath)
`  # (on leftmost column) set $1 column tag-type
`  # (on mid/right column) add N random items to the playlist

6. Tag Editor

NOTE:

to use the tag editor, you must set mpd_music_dir in your ncmpcpp config

* navigate to an album/song
  # 'E' on a song locates in tag editor
  * switch to middle column, select a field to change, change
  * navigate to save

Configuration

Colours/Formatting

# %l - length
# %f - filename
# %D - directory
# %a - artist
# %A - album artist
# %t - title
# %b - album
# %y - date
# %n - track number (01/12 -> 01)
# %N - full track info (01/12 -> 01/12)
# %g - genre
# %c - composer
# %p - performer
# %d - disc
# %C - comment
# %P - priority
# $R - begin right alignment

{%a}       # Display Artist only if available
{%a}|{%A}  # Display Artist if available, else display AlbumArtist
{%30a}     # Display Artist, maximum char width of 30

# Numeric Colours (1-8) can be assigned
$2this is red text

Visualizations

Toggle the visualization with the space key while looking at visualizations.

# ~/.mpdconf

# create audio output for visualization
audio_output {
        type "fifo"
        name "visualization"
        path "/tmp/mpd.fifo"
        format "44100:16:2"
}

# ~/.config/ncmpcpp/config

visualizer_data_source = "/tmp/mpd.fifo"
visualizer_output_name = "visualization"
visualizer_in_stereo = "yes"
visualizer_type = "spectrum"
visualizer_look = "+|"