GRadio 1.0.1 by Keith Wesolowski (wesolows@foobazco.org)
April 2000

GRadio is distributed under the terms of the GNU General Public License.
Read COPYING for more details.

What is GRadio?

GRadio is a (very) graphical interface to several fairly common types
of FM radio tuner cards for PCs running Linux. It is written in C with
GTK+ and supports the 2.1/2.2 series kernel driver (v4l). The old-style
direct port access is no longer supported. It features consistent
volume and frequency tracking, 8-station memory, type-to-set
frequency, fine-tuning, mute, and a large, colorful LCD-ish
display. It is designed to be easy to use and pleasing to look at.

What is missing?

Better support for multiple v4l-supported cards is planned for the 1.1
version (ie autoscanning for multiple cards/cards with multiple tuners).

Who deserves special thanks?

Gideon LaGrange, Frans Brinkman, Matthew Kirkwood, Russell Kroll, Alan
Cox, and others for figuring out how radio cards work and for writing 
v4l drivers for them, as appropriate; Thomas Lehmann, author of the
XRadio program, deserves credit for providing the inspiration for GRadio;
the entire GTK team for the GUI libraries; Ben Pfaff for some patches
and a man page; and many people who have sent in bug reports and
questions.

Requirements
------------

1) A radio card of a type supported by your video4linux kernel driver.

2) Linux >=2.1.106. (2.2.x is fine)

3) GTK+ 1.0 or greater libraries and headers. (1.1.1[56] and 1.2.x work also)

Installation
------------

1) Untar the source code:

	$ tar xzvf gradio-VERSION-src.tar.gz

2) Edit the makefile to suit your tastes and system. The options 
   available are:

	a) Display colors. You can choose standard or nonstandard. If you
	   choose nonstandard, you may wish to edit the colors themselves
	   in pixmaps.h. Tinker with it. :)
	b) Frequency range options. You may set either or both of WIDE_FREQ
	   and OVERRIDE_FREQ. WIDE_FREQ uses a wider default frequency range 
	   suitable for Japan and elsewhere. OVERRIDE_FREQ ignores 
	   driver-supplied frequency ranges and should only be used if you are
	   unable to tune some frequencies that your hardware is known to 
	   support.
	c) Install location. The binary will be placed here. . works,
	   although it will cause complaints.
	d) Location of your kernel headers. Although you can specify this
	   using make CFLAGS=-I..., it seems like a good thing to have.
	   If they're in /usr/include, you don't need this.
	e) Device to access. This is normally /dev/radio or /dev/radio0,
	   but if your radio device is called something else, put it here.
	   You can override this option at runtime (see below).

3) Compile:

	$ make

4) Install:

	$ make install

Using GRadio
------------

1) Run the program:

	$ gradio &

2) Enjoy!:

	GRadio is designed to have a very simple and intuitive interface.
	For the most part, functions are obvious. The following hints will
	make using GRadio easier:

	Clicking the display brings up a menu which allows you to set the
	frequency to pretty much anything by typing in the value. This
	saves clicking the tune buttons a million times.

	To fine-tune the frequency (for odd stations, or in case of poor
	reception), right-click the tuning buttons.

	To set a memory button to the current frequency, right-click the
	appropriate button. To recall it, left-click.

	The left part of the display gives data about the radio's state.
	At the top, the volume is indicated on a scale 0-100. On the
	bottom, up to 3 letters may be displayed. They stand for:

		T	tuned (this is somewhat suspect)
		M	muted
		K	using kernel driver interface (no longer optional)
	
	At the lower right, the current memory selection is indicated, if
	you have made one.

	(New in 0.9.7) There is now a _working_ set of commandline
	options. I wanted to get them in as quickly as possible so that
	GRadio can be more of an all-in-one package. Run it from crontabs!
	Put it in your .login! Endless uses for this miracle feature!!!
	
	To use these options, use the -c runtime option, followed by one
	or more of:

		-v n		Set volume to n, where 0<=n<=11
		-f n		Set frequency to n MHz
		-m +|-		Mute/unmute card

	(New in 0.9.11) You can now specify a specific device file at
	runtime. To do this, use:

		-d filename	Use device filename instead of the default
	
	Other options:

		-h		Show usage information
		-V		Display version information and exit


Reporting a bug
---------------

	GRadio has bugs. I am especially interested in hearing about
	how the program works for people who are using non-RadioTrack cards,
	particularly cards which have other functions (e.g. TV cards). Report
	any and all bugs to wesolows@foobazco.org. Please provide as much
	information as you can.

NOTES
-----

	UPDATE: As of 2.1.105 the kernel driver has indeed been replaced. 
	You'll want to get the 2.1.106 or better version, however, as the
	2.1.105 driver is not quite there. I have tested GRadio with
	2.2.0-pre5 and a RadioReveal card. I am interested in finding
	out whether GRadio works with other kernel-supported radio cards.
	It should, but it'd be nice to know for sure. 

	UPDATE: I have at least one report of success with an Aztech card
	+ video4linux. Probably you will be able to get GRadio to work
	with other cards if you have video4linux support for them in your
	kernel.

	GRadio apparently works on alpha as well as x86. Thanks to Rick Niles
	<niles@axp745.gsfc.nasa.gov> for this information as well as the RPM
	he has made available.