mpc123 [options] file(s)


mpc123 is a command-line player for the Musepack audio compression format. mpc123 reads mpc audio files and decodes them to the devices specified on the command line.

During playback, you can pass to the next playlist element (or a random one if one of the -z and -Z options were used, see below) by sending SIGINT to the process, thus usually pressing ^C will act as a "next-button" for the player.


--gain N, -g N

Set gain (audio volume) to N (0-100 inclusive, default 100, 0 mutes sound)

-o driver

Set output devicetype to driver; possible drivers include:


Linux Open Sound System


Advanced Linux Sound Architecture


ALSA version 0.9 and newer (you should really be using this)


Enlightenment sound daemon


Analog Real Time System (kde sound daemon)


Debugging output target

--audiodevice dev, -a dev

Use dev for audio-out; If not specified, the program tries to pick some sane defaults, based on the used audio output driver. Common devices include:

/dev/dsp or /dev/dsp1

for oss output

default or hw:0

for alsa09 output

--au, -u

Use au file for output

--cdr filename.cdr, -c filename.cdr

Use raw file filename.cdr for output (this can be used directly with cdrecord's -audio option)

--wav filename.wav, -w filename.wav

Use wave file filename.wav for output

--list file, [email protected] file

Use playlist file as list of Musepack files; The playlist format is simple: one file per line. You can easily generate a playlist for mpc123 with the find(1) command:

find /path/to/musicroot -iname \\*.mpc -fprint file
--random, -Z

Play files randomly until interrupted

--shuffle, -z

Shuffle list of files before playing

--verbose, -v

Increase verbosity (default verbosity is 0), the more -v, the more verbose mpc123 becomes

--quiet, -q

Reset verbosity to 0 (no title or boilerplate); this is the default

--help, -h

Print the help screen, with some brief usage information


This manual page was written by Daniele Sempione <scrows at>; Fernando Vezzosi <fvezzosi at> made some edits