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