mpc123(1) your handy Musepack audio player


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, -@ 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