1 ncmpcpp
Luca Matteo Spoljarevic edited this page 2026-02-27 21:44:07 +01:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

ncmpcpp

ncmpcpp is an MPD (Music Player Daemon) client for the terminal. This folder holds the config that defines connection, directories, and optional display/behaviour (most options are commented examples).

What the config does

  • Directories
    • ncmpcpp_directory = ~/.config/ncmpcpp Config and runtime data.
    • lyrics_directory = ~/.lyrics Downloaded lyrics.
  • MPD connection
    • Host 127.0.0.1, port 6600, timeout 5s.
    • mpd_music_dir = /mnt/storage/jellyfin/media/music Music root for tag editor and file operations.
  • Rest The file is mostly the upstream example with options commented out (visualizer, encoding, delays, song format, columns, colours, etc.). Uncomment and change as needed.

How to use it

  1. Install ncmpcpp and MPD. Configure MPD (e.g. ~/.config/mpd/mpd.conf or /etc/mpd.conf) with the same music directory and start MPD.
  2. Copy or symlink this config to ~/.config/ncmpcpp/config (or $XDG_CONFIG_HOME/ncmpcpp/config).
  3. Adjust mpd_music_dir to your actual music path (and mpd_host/mpd_port if MPD runs elsewhere).
  4. Run ncmpcpp. Use the browser to open your library, add tracks to the playlist, and control playback. Uncomment options in the config for visualizer, colours, and layout if you want them.

File reference

File Purpose
config MPD connection, directories, and (commented) display/format/colour options