fmtools version 1.0.
[fmtools.git] / fmscan.1
blob3e68e1deae3439fceea1637a3390a5be3c5fbc5a
1 .TH FM 1 "fmscan 0.99.1"
2 .SH NAME
3 fmscan \- scan FM band for radio stations
4 .SH SYNOPSIS
5 .HP
6 .B fm
8 .B \-h
9 ] [
10 .B \-d
11 .I device
12 ] [
13 .B \-s
14 .I freq
15 ] [
16 .B \-e
17 .I freq
18 ] [
19 .I \-i
20 .I freq
22 .SH DESCRIPTION
23 .B fmscan
24 is a program to scan a frequency band for radio stations, using the
25 video4linux interface introduced in 2.1.x series Linux kernels.  It
26 shows which ones have a accumulated signal strength of 50% or higher.
27 This process can take a while, and results vary greatly depending on the
28 radio card in use.
29 .SS OPTIONS
30 .PP
31 .TP
32 .B \-h
33 Print a usage message to standard output, and exit.
34 .TP
35 \fB\-d \fIdevice
36 Sets \fIdevice\fR as the device to tune.  The default is
37 \fB/dev/radio0\fR.
38 .TP
39 \fB\-s \fIfreq
40 Starting frequency for scan, in MHz.  Default: 87.9.
41 .TP
42 \fB\-e \fIfreq
43 Ending frequency for scan, in MHz.  Default: 107.9.
44 .TP
45 \fB\-i \fIfreq
46 Increment between scanned channels, in MHz.  Default: 0.2.
47 .TP
48 \fB\-t \fIpercent
49 Signal strength threshold to consider a channel.  Default: 50%.
50 .SH BUGS
51 This program may not do much if your radio card's driver doesn't support
52 fine tuning in 1/16000 MHz offsets.  By default, v4l assumes 1/16 MHz
53 tuning units, which introduces evil rounding errors on many frequencies.
54 If in doubt, grep for VIDEO_TUNER_LOW in your driver's source.
55 .PP
56 Supports only tuner 0 on any given device.
57 .SH SEE ALSO
58 .TP
59 Additional documentation:
60 .B /usr/doc/fmtools/README
61 .TP
62 The fmtools homepage:
63 .B http://www.exploits.org/v4l/fmtools.html
64 .TP
65 The video4linux webpage:
66 .B http://roadrunner.swansea.uk.linux.org/v4l.shtml
67 .SH AUTHORS
68 Russell Kroll <rkroll@exploits.org>, now maintained by Ben Pfaff
69 <blp@cs.stanford.edu.>. This manpage written by Ben Pfaff.