music123(1)						      General Commands Manual						       music123(1)

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  cur-
	      rent 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)