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)