NAME

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

SYNOPSIS

       music123 [-DhiLlqrvZz] [-d ARG] [-@ ARG] [--] files ...

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

       -D     Equivalent to -d0.  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.

       -h     Show command help and exit immediately.

       -i     Ignore case of file path extensions.  For example, .ogg  and  .OGG  are  considered
              equivalent.

       -l     Loop at the end of the playlist.

       -L     List files and exit immediately.

       -q     Quiet mode.  No messages are displayed.

       -r     Recurse into directories, instead of ignoring them.

       -T     Redirect  standard  input,  allowing  q  or Q keys to stop after current file.  The
              player will not see its standard output anymore.

       -v     Display version information and exit immediately.

       -z     Randomize the song list once before starting to play.  music123  will  shuffle  the
              list  once  and  for  all,  then  play the songs without repetition (and repeat the
              selected order over and over with -l).

       -Z     Pick up a song after the other randomly and endlessly,  possibly  playing  a  given
              song  twice  in  a  row,  or  never  playing a given song.  This disables -l and -z
              options.

       -@     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.  Following arguments are interpreted as file names, even  if  they
              start with a dash.

EXAMPLES

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

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

       Play a playlist then a strange file name with a delay between the songs:
              music123 -d 6.0 -@playlist -− -strange.ogg

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>,  Xavier  Grave  <xavier.grave@csnsm.in2p3.fr>,
              Nicolas Boulenguez <nicolas@debian.org>

                                          July 24, 2002                               music123(1)