Scroll to navigation

FM(1) General Commands Manual FM(1)

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

Print a usage message to standard output, and exit.
Ignore frequency range limits of card. Use if you suspect that the card supports a wider frequency range than its driver believes.
Quiet mode. Keeps information on station and volume from being printed on standard output.
Sets device as the device to tune. The default is /dev/radio0.
Sets tuner as the tuner on the selected device to adjust. The default is tuner 0. Most radio devices have only a single tuner.
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.
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.
Turn the radio on (unmute).
Turn the radio off (mute).
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:

Specifies default volume (default: 12.5%).
Volume increment used for + and - options (default: 10%).
Default sleep time (default: none).

All other lines are ignored.

SEE ALSO

/usr/share/doc/fmtools/README
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