.Dd Created:2026-03-23|Updated:2026-03-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 MPC oh
.Os linux , OpenBSD 7.8 |
.Nm mpc 
.Nd mpd command line client
.Sh USAGE
.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 SEE ALSO
.Xr mpd oh
.opsy Archlinux manpages:
.Xr mpc 1
.Ss links
.obc2
.It - Lk https://www.musicpd.org/clients/mpc/ mpc
.El
.Sh AUTHORS
.An -nosplit
.Xr ohazot oh |
.Xr about oh |
.Lk https://ohazot.com ohazot.com
.Aq Mt admin@ohazot.com