_                    _
  ___ | |__   __ _ _______ | |_
 / _ \| '_ \ / _` |_  / _ \| __|
| (_) | | | | (_| |/ / (_) | |_
 \___/|_| |_|\__,_/___\___/ \__|

mpcmpd command line client

mpc [COMMAND]

Format to display songs in playlist:

ENV | MPC_FORMAT | MPC_FORMAT="%position% - %file%"
command line | |

toggle , next , prev , clear , shuffle

random , single , repeat , consume

playlist | queue.
lsplaylist | available playlists.
outputs | available outputs.
current | current song.

playlist |
output |

[search|searchplay] TYPE QUERY

Eg.: [search|searchplay] filename "SEARCH TERM"

search | search in database.
searchplay | search in queue and play.

[add|insert] FILEPATH
add | adds at the end of the queue.
insert | adds after current song.

Input can be read from pipes:

mpc search filename "SEARCH" | mpc add
mpc search filename "SEARCH" | mpc insert

update | [MPD_DIR] | update database, if directory is given, only that directory will be updated.
vol | [+-]N | |
seek | [+-]N | seek position in song, eg.: seek -20.
del | QUEUE_ID | delete song in given position, if position is 0, delete the current song.
addplaylist | PLAYLIST | add song from database to PLAYLIST.

mpc current | mpc addplaylist PLAYLIST

(back to top)

mpd

- Archlinux manpages: mpc(1)

- mpc

(back to top)

ohazot | about | ohazot.com <admin@ohazot.com>

This document applies to: linux , OpenBSD 7.8 | Created:2026-03-23|Updated:2026-04-13|