1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154
|
GRadio 1.0.0 by Keith Wesolowski (wesolows@cs.unr.edu)
February 1999
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] seems to work)
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) Install location. The binary will be placed here. . works,
although it will cause complaints.
c) 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.
d) 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@cs.unr.edu. 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.
|