fm - Man Page
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:
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.