NAME

       music123 - plays various sound files (usually including MP3, Ogg and Wav).

SYNOPSIS

       music123 [ -hqrvz ] file ...

DESCRIPTION

       music123  is  a  shell  around various command line programs to play music files.  It will
       descend directories trees with -r, and randomize file lists with -z. The programs used and
       the options given them are listed in /etc/music123rc or ~/.music123rc.

OPTIONS

       -h     Show command help and exit;

       -q     Quiet mode.  No messages are displayed.

       -r     Recurse into directories, instead of ignoring them.

       -v     Display version information and exit.

       -z     Play files in random order.

       -Z     Play the files randomly and endlessly.

       -l     Loop.  -z  -l  differs  from -Z in that -z -l will randomize, play through the song
              list (without repetition) in random order once, and repeat the songs in that  order
              over  and  over;  -Z  will  randomly  play  the  songs, without any order, and will
              possibly play a song right after itself.

       -i     Ignore extension case.

       -L     List files and exit.

       -T     Start a task that handle commands, only one command supported : quit, using q or  Q
              will quit the application at the end of the current song.

       -D     Set music123 not to delay between songs. (May make music123 harder to kill).

       -d     Customize  the time music123 delays between songs. -d takes one argument, expressed
              in seconds, which may have a fractional part.

       -@     Play the files listed in the mandatory argument of -@. Other files can be added  on
              the  command  line, and this option can be given several times.  Note that music123
              doesn't yet play URLs.

       --     End option list.

EXAMPLES

       Play three songs:
              music123 test1.ogg test2.mp3 test3.wav

       Play a couple of directories and other songs at random:
              music123 -z -r Rock/ test1.ogg Pop/ test4.wav

FILES

       /etc/music123rc
              Describes which programs music123 uses, which files types it  supports,  and  which
              options it passes those programs.

       ~/.music123rc
              Per-user config file to override the system wide settings.

AUTHORS

       Authors:
              David Starner <dvdeug@debian.org>

                                          July 24, 2002                               music123(1)