NAME

       radio - console radio application

SYNOPSIS

       radio [ options ]

DESCRIPTION

       radio is a interactive, ncurses-bases console radio application.

OPTIONS

       -h     print a short help text.

       -d     enable debug output.

       -q     quit  after  processing  the  cmd line options, don't enter interactive ncurses mode.  Only useful
              together with other options for obvious reasons ...

       -m     mute radio.

       -f freq
              tune the specified radio frequency (and unmute the radio).

       -c dev specify radio device (default is /dev/radio0).

       -s     Do a scan for radio stations.

       -S     Same as above + write a radio.fmmap with the signal for every frequency.  You can get a graph  for
              it with gnuplot (plot "radio.fmmap" w lin).

       -i     Scan, write a initial ~/.radio file to stdout and quit.  So you can create a config file where you
              only  have  to fill in the correct station names later this way: "radio -i > ~/.radio".  See below
              for the config file syntax.

CONFIGURATION

       radio picks up station names and present stations from a config file.  It can  parse  kradio  (KDE  radio
       app)    config    files,   therefore   it   first   tries   the   usual   KDE   config   file   location:
       ~/.kde/share/config/kradiorc. Failing that, radio tries ~/.radio (which makes things  a  bit  easier  for
       people who don't use kradio).

       The format looks like this:

       # KDE Config File
       [Buttons]
       1=95800000
       2=91400000
       [Stations]
       100600000=Hundert,6
       95800000=Radio eins
       102600000=Fritz
       94300000=r.s.2
       91400000=Berliner Rundfunk

       The  [Buttons]  section  can have up to eight entries.  That are the present stations, they get mapped to
       F1-F8.  The [Stations] section maps frequencies to station names.  The frequencies in both  sections  are
       specified in Hz.

KEYS

       X         exit
       ESC,Q,E      mute and exit.
       up/down      inc/dec frequency
       pgup/pgdown  next/previous station.  This one uses the
                    stations from the config file by default.
                    When started with the -s option these keys
                    will cycle througth the stations found during
                    the scan.
       F1-F8, 1-8   preset buttons.
       Ctrl+L       redraw screen.

AUTHOR

       Gerd Knorr <kraxel@bytesex.org>

COPYRIGHT

       Copyright (C) 1997-2001 Gerd Knorr

       This  program  is  free  software;  you  can  redistribute it and/or modify it under the terms of the GNU
       General Public License as published by the Free Software Foundation; either version 2 of the License,  or
       (at your option) any later version.

       This  program  is  distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
       the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General  Public
       License for more details.

       You  should have received a copy of the GNU General Public License along with this program; if not, write
       to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

                                            (c) 1998-2001 Gerd Knorr                                    radio(1)