NAME

       mpc123 - your handy Musepack audio player

SYNOPSIS

       mpc123 [options] file(s)

DESCRIPTION

       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.

OPTIONS

       --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:

         oss
           Linux Open Sound System

         alsa
           Advanced Linux Sound Architecture

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

         esd
           Enlightenment sound daemon

         arts
           Analog Real Time System (kde sound daemon)

         null
           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 filename.au, -u filename.au
           Use au file filename.au 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

AUTHOR

       This manual page was written by Daniele Sempione <scrows at oziosi.org>; Fernando Vezzosi <fvezzosi at masobit.net> made some edits

                                           January 2006                                 mpc123(1)