otty / dotfiles

All tools/Music Player Daemon

Music Player Daemon

mpd

Music Player Daemon (MPD) is a flexible, powerful, server-side application for playing music.

Detected by mpd | macOS, Linux, Windows |www.musicpd.org

Sync it mpd.toml

Sync rules

What travels, what stays, what never leaves

Synced3 paths, copied whole to your other machines

[configHome]/mpd/mpd.confpattern

~/.mpdconf

~/.mpd/mpd.conf

Stays on this machineInside a file that otherwise syncs

[configHome]/mpd/mpd.conflines starting with

music_directoryplaylist_directorydb_filelog_filepid_filestate_filesticker_file

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

~/.mpdconflines starting with music_directory, playlist_directory, db_file, log_file, pid_file, state_file, sticker_file

# Music Player Daemon configuration

music_directory "~/Music"machine-local

playlist_directory "~/.config/mpd/playlists"machine-local

db_file "~/.local/share/mpd/database"machine-local

log_file "~/.local/state/mpd/log"machine-local

pid_file "~/.local/state/mpd/pid"machine-local

state_file "~/.local/state/mpd/state"machine-local

sticker_file "~/.local/share/mpd/sticker.sql"machine-local

auto_update "yes"

restore_paused "yes"

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

~/.mpd/mpd.conflines starting with music_directory, playlist_directory, db_file, log_file, pid_file, state_file, sticker_file

# Music Player Daemon configuration

music_directory "~/Music"machine-local

playlist_directory "~/.config/mpd/playlists"machine-local

db_file "~/.local/share/mpd/database"machine-local

log_file "~/.local/state/mpd/log"machine-local

pid_file "~/.local/state/mpd/pid"machine-local

state_file "~/.local/state/mpd/state"machine-local

sticker_file "~/.local/share/mpd/sticker.sql"machine-local

auto_update "yes"

restore_paused "yes"

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Excluded

Nothing. Music Player Daemon writes no caches or state in your home directory.

Music Player Daemon in your home directory Every rule on this page, by file

music_directoryplaylist_directorydb_filelog_filepid_filestate_filesticker_file

Each machine keeps its own copy of these.

# Music Player Daemon configuration

music_directory "~/Music"machine-local

playlist_directory "~/.config/mpd/playlists"machine-local

db_file "~/.local/share/mpd/database"machine-local

log_file "~/.local/state/mpd/log"machine-local

pid_file "~/.local/state/mpd/pid"machine-local

state_file "~/.local/state/mpd/state"machine-local

sticker_file "~/.local/share/mpd/sticker.sql"machine-local

auto_update "yes"

restore_paused "yes"

…

Each machine keeps its own copy of these.

# Music Player Daemon configuration

music_directory "~/Music"machine-local

playlist_directory "~/.config/mpd/playlists"machine-local

db_file "~/.local/share/mpd/database"machine-local

log_file "~/.local/state/mpd/log"machine-local

pid_file "~/.local/state/mpd/pid"machine-local

state_file "~/.local/state/mpd/state"machine-local

sticker_file "~/.local/share/mpd/sticker.sql"machine-local

auto_update "yes"

restore_paused "yes"

…

Each machine keeps its own copy of these.

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

apps/mpd.tomlThe file this page is generated from

id = "mpd"

name = "Music Player Daemon"

homepage = "https://www.musicpd.org"

description = "Music Player Daemon (MPD) is a flexible, powerful, server-side application for playing music."

# The project logo from musicpd.org.

icon = "https://www.musicpd.org/logo.png"

detect = ["mpd"]

# mpd.conf(5), the Files section: "$XDG_CONFIG_HOME/mpd/mpd.conf — User

# configuration file (usually ~/.config/mpd/mpd.conf)". src/CommandLine.cxx

# spells out the full search, in order:

# #ifdef _WIN32

# GetUserConfigDir() + "mpd\mpd.conf"

# #else

# GetUserConfigDir() + "mpd/mpd.conf" (USER_CONFIG_FILE_LOCATION_XDG)

# GetHomeDir() + ".mpdconf" (USER_CONFIG_FILE_LOCATION1)

# GetHomeDir() + ".mpd/mpd.conf" (USER_CONFIG_FILE_LOCATION2)

# The first is the user config directory under every platform's name for it,

# which is what [configHome] stands for; the other two are plain home

# dotfiles. MPD stops at the first that exists, so a machine has one of them —

# a consumer skips the two that are absent. Homebrew's formula caveat points at

# the same two dotfile spellings ("Please copy it ... into one of these paths:

# ~/.mpd/mpd.conf, ~/.mpdconf").

paths = [

"[configHome]/mpd/mpd.conf",

"~/.mpdconf",

"~/.mpd/mpd.conf",

]

exclude = []

# mpd.conf holds no credential. (MPD's `password` setting exists for its own

# client protocol and lives in the system-wide file on the machines that use

# it; nothing published documents it as a per-user setting, so it is not

# claimed here.)

secret = []

# Every spelling, because MPD reads whichever exists first: a rule naming only

# the XDG file leaves the absolute paths below syncing from a machine that uses

# a dotfile. ~/.mpdconf shares no last segment with the other two, so the

# sibling check cannot pair it — this list is by hand, the way apps/pip.toml's

# is.

# All seven names come from mpd.conf(5)'s own option list, and every one of

# them is an absolute path into this machine's disk: music_directory ("where

# music files are located"), playlist_directory ("the directory for saved

# playlists"), db_file ("where the database file will be stored"), log_file,

# pid_file ("file to store MPD's process ID"), state_file ("location for saving

# MPD state on termination") and sticker_file. Audio outputs, replay gain,

# volume normalisation and the rest of the file are preferences a user wants

# carried, so they are deliberately not here.

# The seven that are here are locations the user wrote out — their music, their

# database, their logs — so they are kept for rebuilding this machine and

# applied to no other.

[[machine_lines]]

file = [

"[configHome]/mpd/mpd.conf",

"~/.mpdconf",

"~/.mpd/mpd.conf",

]

match = { prefix = [

"music_directory",

"playlist_directory",

"db_file",

"log_file",

"pid_file",

"state_file",

"sticker_file",

] }

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/mpd. 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 music_directory and playlist_directory for you — that part is Otty’s own sync, or a template you write by hand.