
HOW TO USE JUKEBOX :
********************

1. What is jukebox ?
--------------------

Jukebox is a small program that plays a list of songs on the host of your
choice.  This allows you to have some background music while you are working
or doing anything else.


2. Command line options : jukebox host [options] [directory ...]
----------------------------------------------------------------

The first (not optional) parameter must be the name of the host you want to
play the songs on.  Then you may add the following options :

       -a       to play the songs in alphabetical order (file names).  This
                might be useful if the file names begin with the name of
		the artist or group, for example.

       -f name  to load the list of songs from a file (see below for details).

       -h       to see the help message.

       -l       to play the songs forever (loop mode).

       -q       to suppress output except for error messages.

       -r       to play the songs in a random order.  If the jukebox is in
                loop mode, a new list (in a different order) will be created
                each time the jukebox reaches the last song.

       -s n     to introduce a delay between the songs (n is in milliseconds).
                If you give a negative number, the two songs will be
                superimposed.  You may use this option to create a "fade in /
                fade out" effect (see examples below).

       -v n     to change the play volume.

The remaining parameters on the command line (not beginnig with a "-") will
be interpreted as the names of directories where the jukebox will find some
songs.  Every file whith a name that ends in ".au" will be added to the list.

3. While the jukebox is running...
----------------------------------

You may do the following things while the program is running :

       "Ctrl-C" will stop the current song and play the next one.

       "Ctrl-Z" will stop the current song then stop the jukebox.

After a "Ctrl-Z", you may continue with the next song : use "fg", or whatever
your shell needs to continue a stopped process.  If you want to terminate the
process, use "kill XXX" or "kill -HUP XXX", where XXX is the process number
of the jukebox.

4. Examples
-----------

Suppose you have several directories named "songs/XXX", where "XXX" is the name
of some artist or group.  If you want to play some music on "verif1" (replace
this with the name of your host), you might type something like this :

  jukebox verif1 -r -s -4000 songs/*

This will play all the songs from these directories, taken in a random order.
There is also a "negative delay" of 4 seconds.  If all the songs begin with
a "fade in" and end with a "fade out", you will get a pretty good effect.
If you want to play your favourite songs over and over, you could type :

  jukebox verif1 -l -q songs/kate_bush songs/queen songs/rem ...

(By the way, it is simpler to go in the "songs" directory to type these
commands as the paths would be shorter, but this is only an example).
Here, the "-q" option is used to suppress all normal output.  You can then
use the jukebox as a background job if you are short of terminals.

You may also put the names of your favorite songs in a file, and use this file
with the "-f" option.  You may even create several files and use them in any
order, like this :

  jukebox verif1 -f rock_n_roll -f pop_music songs/rap ...

In this example, the songs are taken from the files "rock_n_roll" and
"pop_music", but also from the directory "songs/rap".


5. Feedback
-----------

Messages telling me that you can't work because your friends keep playing some
music on your host should go to the bit bucket...  Other comments, suggestions
and bug reports may be sent to "quinet@montefiore.ulg.ac.be" (This account
may be closed in 1994).

Have fun !
                                          Raphael Quinet

