fm (1) - Linux Manuals

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

Command to display fm manual in Linux: $ man 1 fm

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

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.

AUTHORS

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