	Tuner 1.6
	---------

This is tuner version 1.6, a motif-based tuner to accompany the
ethernet radio program, allowing you to select an ethernet radio
station to listen to. It is meant to work with radio 2.0, but will
also work with older releases of radio, although the playlist feature
will not work.

"Radio" is a set of programs that allows you to connect an audio
source (radio, CD player) to your Sun, SGI or NeXT workstation and
broadcast low-fi (approximately AM radio quality) audio over a local
area network. Other users can then listen to your broadcasts.

Radio is distributed separately, and is posted to comp.sources.unix
around this time. It is also available for FTP access, as file
/pub/audio/radio2.0.4.tar.Z on host ftp.cwi.nl. This tuner is also available
there, as /pub/audio/tuner1.6.shar.

Differences with 1.5
--------------------

Tuner can now be run non-interactively, allowing you, for instance, to
mute/unmute a radio from a script. This functionality was previously
provided by the ttytuner program, but that wasn't widely available
(due to being written in python).

Tuner can now control the output volume on machines with AudioFile
support as well as on the Sun or SGI. Thanks to
Axel.Belinfante@cs.utwente.nl and stolcke@icsi.berkeley.edu for the
AudioFile and Sun code.

Fixed a bug whereby a radio started from tuner would make subsequent
use of tuner impossible (with a bind error) on Suns.

Changed the radio button to be a toggle.

Changed a few minor things in the user interface:
- toggle buttons light up,
- sliding the volume slider has immedeate effect.

Building tuner
--------------

Tuner has been tested on an SGI Iris Indigo running Irix 4.0.5 with
Motif 1.1.

Version 1.3 also ran on a Sun Sparcstation running SunOS 4.1 with
Motif 1.0, and I have no reasons to believe this will not work anymore.

The Motif 1.0 user interface has some quirks (updates of the
'playlist' list is an... uhm.... interesting process to watch:-) but
it does work.

Before building tuner, the Makefile, customize.h and possibly
Tuner.resources should be edited to reflect you local configuration.

  The references to 'anp' need a little explanation. We have a service
  locally where we record the hourly newsbulletin from the radio and
  make it available to anyone at any time through the 'anp' program
  (named after the dutch newsservice). A sort of distribution of this
  stuff can be found on ftp.cwi.nl, file /pub/audio/anp1.1.tar.Z.
  Unless you live in the Netherlands and use SGI hardware installation
  is not trivial, though...

  Alternatively, you can:
  - find some way to put the news in a file every hour,
  - create a script with (roughly) the following contents:
     #!/bin/sh
     playaudio newsfile &
     echo $!
     wait
    where 'playaudio' is your audio player. Then set ANP_COMMAND in
    customize.h to the name of this script. The bit with echo and wait
    is meant to make it possible for tuner to abort the news.

In the Makefile, edit MOTIF_INC if you have Motif 1.0 (add option
-DMOTIF1_0) and/or if your motif include files live in a non-standard
place (add option -I<include-path>).

Next, add an option -L<lib-path> to the MOTIF_LIB variable if your
motif library (or X library, or Xt library) doesn't live in the
standard library path.

Finally, update the RESDIR and BINDIR variables to reflect in which
directories you are going to keep the resource file and the tuner
binary.

In the file customize.h you have to edit the DFT_NETS define. It should
be set to all networks on which tuner should look for radio stations.
Edit the RADIO_COMMAND to something that starts radio on your system.
Edit the KILLRADIO_COMMAND to something that kills all radios on your
system, or remove the definition.
Edit ANP_COMMAND to start the newscast, or remove the definition if
you do not want this feature.

You might have to edit Tuner.resources to change the default
appearance of tuner. This will be the case if you use monochrome
machines (tuner will not look very nice on a monochrome machine with
the Tuner.resources file as distributed), if you don't have adobe
fonts or if you want to use a language other than English.

You are now ready to 'make' and 'make install' to build and install tuner.

Notes
-----

Tuner is copyrighted but freely distributable. See the copyright
notice below. If you make changes to tuner I would like to hear from you.

	Jack Jansen
	Centrum voor Wiskunde en Informatica
	Kruislaan 413
	1098 SJ  Amsterdam
	the Netherlands

	phone:    +31 20 592 4098
	fax:      +31 20 592 4199
	internet: jack@cwi.nl
	X.400:    G=Jack;S=Jansen;O=cwi;P=surf;A=400net;C=nl


Copyright notice
----------------

Copyright 1991, 1992, 1993 by Stichting Mathematisch Centrum, Amsterdam, The
Netherlands.

                        All Rights Reserved

Permission to use, copy, modify, and distribute this software and its 
documentation for any purpose and without fee is hereby granted, 
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in 
supporting documentation, and that the names of Stichting Mathematisch
Centrum or CWI not be used in advertising or publicity pertaining to
distribution of the software without specific, written prior permission.

STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
