otty / dotfiles

All tools/ncmpcpp

ncmpcpp

An ncurses Music Player Daemon (MPD) client.

Detected by ncmpcpp | macOS, Linux |rybczak.net

Sync it ncmpcpp.toml

Sync rules

What travels, what stays, what never leaves

ncmpcpp in your home directory Every rule on this page, by file

mpd_music_dirncmpcpp_directorylyrics_directorympd_host

Each machine keeps its own copy of these.

· bindings Sync

· lyrics/ Exclude

· error.log Exclude

## ncmpcpp configuration

mpd_host = "/tmp/mpd.socket"machine-local

mpd_port = "6600"

mpd_music_dir = "/Users/octocat/Music"machine-local

ncmpcpp_directory = "/Users/octocat/.config/ncmpcpp"machine-local

lyrics_directory = "/Users/octocat/.local/share/lyrics"machine-local

playlist_display_mode = "columns"

user_interface = "alternative"

…

Each machine keeps its own copy of these.

· bindings Sync

· lyrics/ Exclude

· error.log Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/ncmpcpp.tomlThe file this page is generated from

id = "ncmpcpp"

name = "ncmpcpp"

homepage = "https://rybczak.net/ncmpcpp/"

description = "An ncurses Music Player Daemon (MPD) client."

detect = ["ncmpcpp"]

# ncmpcpp is an ncurses program built against MPD's client library; it has no

# Windows build, so only the two Unix platforms are claimed.

platforms = ["macos", "linux"]

# ncmpcpp(1), the CONFIGURATION section: the configuration file is read from

# "$XDG_CONFIG_HOME/ncmpcpp/config" or "$HOME/.ncmpcpp/config", and the key

# bindings from "$XDG_CONFIG_HOME/ncmpcpp/bindings" or "~/.ncmpcpp/bindings".

# The XDG spelling is [configHome], which on macOS is ~/.config — ncmpcpp

# follows the spec there too, having no platform-native branch. The legacy

# dotdir is listed beside it, and a consumer skips whichever is absent.

paths = [

"[configHome]/ncmpcpp/config",

"[configHome]/ncmpcpp/bindings",

"~/.ncmpcpp/config",

"~/.ncmpcpp/bindings",

]

# The lyrics ncmpcpp fetches and the error log it writes sit in the same

# directory. Neither is named above, so there is nothing to carve out of what

# is; they are listed so a consumer syncing the whole directory skips them.

exclude = [

"[configHome]/ncmpcpp/lyrics/",

"~/.ncmpcpp/lyrics/",

"[configHome]/ncmpcpp/error.log",

"~/.ncmpcpp/error.log",

]

# ncmpcpp connects to MPD, which on a per-user setup has no password; nothing

# in these files is a credential.

secret = []

# Read at startup by a process that then runs from memory.

# Every spelling of the config file, because ncmpcpp reads whichever it finds

# first and the two share a last segment, so the sibling check requires both.

# All four options are absolute paths into this machine's disk, and all four

# are in ncmpcpp(1)'s own option list: mpd_music_dir (the music directory MPD

# serves, which ncmpcpp needs locally for tag editing), ncmpcpp_directory

# (where ncmpcpp keeps its own files), lyrics_directory, and mpd_host, which is

# a socket path when it names one rather than a host name.

# All four are locations the user wrote out — their music, their lyrics, the

# socket their daemon listens on — so they are kept for rebuilding this machine

# and applied to no other.

[[machine_lines]]

file = ["[configHome]/ncmpcpp/config", "~/.ncmpcpp/config"]

match = { prefix = [

"mpd_music_dir",

"ncmpcpp_directory",

"lyrics_directory",

"mpd_host",

] }

scope = "backup"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/ncmpcpp. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits mpd_music_dir and ncmpcpp_directory for you — that part is Otty’s own sync, or a template you write by hand.