NAME

       fm - control frequency, volume, mute/unmute of FM radio card

SYNOPSIS

       fm [ -h ] [ -o ] [ -q ] [ -d device ] [ -t tuner ] [ -T none | forever | time ] on | off | + | - | freq [
              volume ]

DESCRIPTION

       fm  is  a  program to control the frequency, volume, and mute/unmute state of an FM radio card, using the
       video4linux interface introduced in 2.1.x series Linux kernels.

   OPTIONS
       -h     Print a usage message to standard output, and exit.

       -o     Ignore frequency range limits of card.  Use  if  you  suspect  that  the  card  supports  a  wider
              frequency range than its driver believes.

       -q     Quiet mode.  Keeps information on station and volume from being printed on standard output.

       -d device
              Sets device as the device to tune.  The default is /dev/radio0.

       -t tuner
              Sets  tuner  as  the  tuner on the selected device to adjust.  The default is tuner 0.  Most radio
              devices have only a single tuner.

       -T none | forever | time
              After tuning, sleep for the time specified or forever.  Time is specified in seconds  by  default.
              A suffix of m indicates minutes, h indicates hours, or d indicates days.

              The  -T  option  is useful with radio card drivers that only maintain the tuner settings while the
              tuner's file descriptor remains open.  Try using this option if  running  fm  ordinarily  produces
              only a single "pop" from your speakers.

       freq   Frequency to tune the radio to, in MHz.  For instance, 88.9 specifies a frequency of 88.9 MHz.  AM
              tuner values are also specified in MHz; for instance, 530 kHz would be specified as .530.

       on     Turn the radio on (unmute).

       off    Turn the radio off (mute).

       volume Specify the desired volume, in percent.  Not all radio devices support volume control.

       +      Increase the current volume.

       -      Decrease the current volume.

CONFIGURATION

       fm  reads $HOME/.fmrc, if it exists, to obtain default settings.  Each line may take one of the following
       forms:

       VOL percent
              Specifies default volume (default: 12.5%).

       INCR percent
              Volume increment used for + and - options (default: 10%).

       TIME   Default sleep time (default: none).

       All other lines are ignored.

SEE ALSO

       Additional documentation:
              /usr/share/doc/fmtools/README

       The fmtools homepage:
              http://benpfaff.org/fmtools

AUTHORS

       Russell Kroll <rkroll@exploits.org>, now maintained  by  Ben  Pfaff  <blp@cs.stanford.edu>.   Sleep  time
       feature contributed by Dave Ulrick <d-ulrick@insightbb.com>.  This manpage written by Ben Pfaff.

                                                    fm 1.0.2                                               FM(1)