NAME

       mailsound - play sounds when mail is received

SYNOPSIS

       mailsound [-hszZvrd] soundname ...

DESCRIPTION

       mailsound  allows  a  user  to play sounds when new mail arrives.  It reads a mail message
       from stdin and uses Mark Boyns' rplay library to play sounds.  The sound that is played is
       determined  by a configuration file in the user's home directory called .mailsounds.  Each
       line in this file has two parts.  The first part is a regular  expression  which  will  be
       used  to match the from address from a mail message.  The second part describes what to do
       when a match is found.  The options in the second part are identical to the options on the
       command  line.   The command line options will set defaults which will be used if they are
       not specified in the configuration file.
       If not specified, the mailsound program will use the following defaults:

              default sound: youvegotmail.au
              default volume:     127 (50%)

       If the mail address does not match any of the regular expressions in the .mailsounds file,
       no sound will be played.

OPTIONS

       -h hostname:[hostname...]
              Play sounds on all of these hosts.

       -z <minsize>:<minvolume>,<maxsize>:<maxvolume>
              The  volume  the sound will be played at will be determined by the size of the mail
              message.  The sound for a message with a size smaller than <minsize> will be played
              at  volume  <minvolume>.  The sound for a message with a size larger than <maxsize>
              will be played at volume <maxvolume>.  The sound for a message with a size  between
              <minsize>  and <maxsize> will be played at a volume which is a linear interpolation
              between <minvolume> and <maxvolume>.

       -Z <minsize>,<maxsize>
              The sound to be played is determined by the size  of  the  mail  message.   If  the
              message  is  smaller  than  <minsize>,  the  first  listed sound is played.  If the
              message is larger than <maxsize>, the last listed sound is played.  If the  message
              size is between those two values, the appropriate sound from the list is played.

       -s <subject re>
              The  regular expression supplied will have to match the subject of the message.  If
              this option is not there, the subject of the message  is  completely  ignored.   Be
              careful  that  the  regular expression does not contain spaces.  Due to laziness of
              the author of this program, this will hopelessly confuse the program.

       -v <int>
              Set the volume at which the sound should be played.  The range is 0-255.

       -r     Pick a sound at random from the list of sounds provided.

       -d     Turn on debugging.  This will produce diagnostic output to stdout.

EXAMPLE

       The following could appear in the .forward file in your home directory: (This assumes that
       your username is pickard)

              \pickard, |"/usr/local/bin/mailsound"

       Here is a sample $HOME/.mailsounds file:

              Andrew.*  -r Passing_Train riot arrp flinstones
              root.*         out!
              daemon.*  -v 220 sci_fi_fun
              MAILER.*  -S 1000,10000 cuckoo pig  Oomph
              *.        pigs

FILES

       $HOME/.mailsounds

SEE ALSO

       rplay.conf(5), rplayd(1)

AUTHOR

       This  program  was  written by Andrew Scherpbier at San Diego State University.  He can be
       reached by E-mail as follows:

              Andrew@SDSU.Edu

       The mailsound program makes use of Mark Boyns'  rplay  package  which  can  play  multiple
       sounds on remote machines.
       He can be reached by E-mail as follows:

              boyns@sdsu.edu

BUGS

       The code does very little error checking.  No range checking on any of the values is done.

                                          11 August 1993                             MAILSOUND(1)