.Dd Created:2025-11-23|Updated:2025-11-23
.de ocsi
\\$*
,
..
.de oxr
.ocsi .Xr \\$*
..
.de oit
.It
\\$*
..
.de obdi
.Bl -dash -compact
.oit \\$*
..
.de obdl
.Bd -literal -compact
\\$*
..
.de onote
.Bl -hang -compact
.oit \\$*
.El
..
.de ocomm
.Bl -diag -compact
.oit \\$*
.El
..
.de opsy
.Pp
.Sy - \\$*
..
.de obc
.Bl -column \\$*
..
.de obc2
.obc opt desc
..
.de obc3
.obc option arguments description
..
.Dt MPD oh
.Os linux , OpenBSD |
.Nm mpd 
.Nd music player daemon - usage, config, clients and tips
.Sh DESCRIPTION
MPD is a music daemon which can be crontrolled through different clients.
.Sh CONFIG
MPD provides a sample config file which can be found at /etc/mpd.conf.
Uncomment and edit the following lines as needed.
.obdl music_directory         "MUSIC_DIR"
playlist_directory      "PLAYLIST_DIR"
db_file                 "DATABASE_FILE"
log_file                        "LOG_FILE"
pid_file                        "PID_FILE"
state_file                      "STATE_FILE"
sticker_file                    "SQL_FILE"
port                            "6600"
.Ed
.Ss Outputs
Multiple outputs can be enabled.
.obdl audio_output {
        type            "alsa"
        name            "My ALSA Device"
        mixer_type      "software"              # optional
}
audio_output {
        type            "pulse"
        name            "My Pulse Output"
}
.Ed
.Ss HTTPD streaming
An httpd streaming output can be configured to be played using the url http://HOST:PORT.
.obdl audio_output {
        type            "httpd"
        name            "My HTTP Stream"
        encoder         "vorbis"                # optional, vorbis or lame
        port            "8000"
        bind_to_address "0.0.0.0"               # optional, IPv4 or IPv6
        bitrate         "128"                   # do not define if quality is defined
        format          "44100:16:1"
        max_clients     "0"                     # optional 0=no limit
}
.Ed
.Ss ENV
.obc2
.It MPD_HOST
.It MPD_PORT
.El
.Ss Command line options
.obc mpd_CONFIG_FILE_kill_ desc
.It mpd [CONFIG_FILE] Ta | start mpd. CONFIG_FILE can be specified.
.It mpd --kill [CONFIG_FILE] Ta | kill mpd session. If CONFIG_FILE is given, kill session running from CONFIG_FILE
.El
.Sh CLIENTS
.obc ncmpc desc
.It mpc Ta | command line client.
.It ncmpc Ta | ncurses client.
.It ncmpcpp Ta | ncurses client inspired by ncmpc (written in c++).
.It vimpc Ta | ncurses client with vi-like bindings.
.El
.Sh mpc
.Dl mpc [COMMAND]
.Ss format
Format to display songs in playlist:
.obc _command_line_ MPC_FORMAT_ desc
.It ENV Ta | MPC_FORMAT Ta | MPC_FORMAT="%position% - %file%"
.It command line Ta | Ta | Li mpc -f \&"%position% - %file%\&" playlist
.El
.Ss queue control
.ocsi toggle
.ocsi next
.ocsi prev
.ocsi clear
shuffle
.Ss playing modes
.ocsi random 
.ocsi single 
.ocsi repeat 
consume
.Ss commands
.obc command _argument description
.It playlist Ta | Ta | display queue.
.It lsplaylist Ta | Ta | display available playlists.
.It update Ta | [MPD_DIR] Ta | update database, if directory is given, only that directory will be updated.
.It vol Ta | [+-]N Ta | Li mpc vol +10 | mpc vol 50.
.It save Ta | PLAYLIST Ta | save playlist.
.It load Ta | PLAYLIST Ta | load playlist.
.It rm Ta | PLAYLIST Ta | remove playlist.
.It seek Ta | [+-]N Ta | seek position in song, eg.: Li seek -20.
.It del Ta | QUEUE_ID Ta | delete song in given position, if position is 0, delete the current song.
.It search Ta | TYPE QUERY Ta | search song in database, eg.: search filename \&"SEARCH_TERM\&".
.It searchplay Ta | TYPE QUERY Ta | play song in queue matching the query, eg.: searchplay filename \&"SEARCH TERM\&".
.It add Ta | FILEPATH Ta | add file to the end of the queue (can read input from pipes).
.It insert Ta | FILEPATH Ta | add file to the queue after the current song (can read input from pipes).
.It outputs Ta | Ta | display available outputs.
.It disable Ta | OUTPUT_ID Ta | disable output.
.It enable Ta | OUTPUT_ID Ta | enable output.
.El
.Ss Examples
.Dl mpc search filename \&"SEARCH\&" | mpc add
.Dl mpc search filename \&"SEARCH\&" | mpc insert
.Sh SLACKWARE
.Ss slackbuilds
mpd has the requirement fmt from slackbuilds which conflicts with the core fmt, editing this requirement should avoid the conflict.
The version 0.23.16 on the repository does not build, the version can be changed to 0.24.6 which works fine.
.Sh SEE ALSO
.Xr slackware oh
.opsy ArchLinux manpages:
.oxr mpd 1
.oxr mpd.conf 5
.oxr mpc 1
.oxr ncmpc 1
.Xr ncmpcpp 1
.Ss links
.obc2
.It - Lk https://www.musicpd.org/ mpd
.It - Lk https://sourceforge.net/projects/vimpc/ vimpc
.El
.Sh AUTHORS
.An -nosplit
.Xr ohazot oh |
.Xr about oh |
.Lk https://ohazot.com ohazot.com
.Aq Mt admin@ohazot.com