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

mpc — mpd 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 | | display queue.
lsplaylist | | display available playlists.
update | [MPD_DIR] | update database, if directory is given, only that directory will be updated.
vol | [+-]N | |
save | PLAYLIST | save playlist.
load | PLAYLIST | load playlist.
rm | PLAYLIST | remove playlist.
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.
search | TYPE QUERY | search song in database, eg.: search filename "SEARCH_TERM".
searchplay | TYPE QUERY | play song in queue matching the query, eg.: searchplay filename "SEARCH TERM".
add | FILEPATH | add file to the end of the queue (can read input from pipes).
insert | FILEPATH | add file to the queue after the current song (can read input from pipes).
outputs | | display available outputs.
disable | OUTPUT_ID | disable output.
enable | OUTPUT_ID | enable output.

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

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-03-23|