1FM(1)                       General Commands Manual                      FM(1)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

13       fm is a program to control the frequency, volume, and mute/unmute state
14       of  an  FM  radio  card,  using the video4linux interface introduced in
15       2.1.x series Linux kernels.
16
17   OPTIONS
18       -h     Print a usage message to standard output, and exit.
19
20       -o     Ignore frequency range limits of card.  Use if you suspect  that
21              the  card  supports  a  wider  frequency  range  than its driver
22              believes.
23
24       -q     Quiet mode.  Keeps information on station and volume from  being
25              printed on standard output.
26
27       -d device
28              Sets device as the device to tune.  The default is /dev/radio0.
29
30       -t tuner
31              Sets  tuner  as the tuner on the selected device to adjust.  The
32              default is tuner 0.  Most  radio  devices  have  only  a  single
33              tuner.
34
35       -T none | forever | time
36              After  tuning, sleep for the time specified or forever.  Time is
37              specified in seconds by default.  A suffix of m  indicates  min‐
38              utes, h indicates hours, or d indicates days.
39
40              The  -T option is useful with radio card drivers that only main‐
41              tain the  tuner  settings  while  the  tuner's  file  descriptor
42              remains  open.   Try  using this option if running fm ordinarily
43              produces only a single "pop" from your speakers.
44
45       freq   Frequency to tune the radio to,  in  MHz.   For  instance,  88.9
46              specifies  a  frequency  of  88.9 MHz.  AM tuner values are also
47              specified in MHz; for instance, 530 kHz would  be  specified  as
48              .530.
49
50       on     Turn the radio on (unmute).
51
52       off    Turn the radio off (mute).
53
54       volume Specify  the  desired volume, in percent.  Not all radio devices
55              support volume control.
56
57       +      Increase the current volume.
58
59       -      Decrease the current volume.
60

CONFIGURATION

62       fm reads $HOME/.fmrc, if it exists, to obtain default  settings.   Each
63       line may take one of the following forms:
64
65       VOL percent
66              Specifies default volume (default: 12.5%).
67
68       INCR percent
69              Volume increment used for + and - options (default: 10%).
70
71       TIME   Default sleep time (default: none).
72
73       All other lines are ignored.
74

SEE ALSO

76       Additional documentation:
77              /usr/share/doc/fmtools/README
78
79       The fmtools homepage:
80              http://benpfaff.org/fmtools
81

AUTHORS

83       Russell  Kroll  <rkroll@exploits.org>,  now  maintained  by  Ben  Pfaff
84       <blp@cs.stanford.edu>.  Sleep time feature contributed by  Dave  Ulrick
85       <d-ulrick@insightbb.com>.  This manpage written by Ben Pfaff.
86
87
88
89                                   fm 1.0.2                              FM(1)