w_scan(1)

1w_scan(1)                                                            w_scan(1)
2
3
4

NAME

6       w_scan - a universal ATSC and DVB blind scanner
7

SYNOPSIS

9       w_scan -fa -c <COUNTRY_ID> [ options ]
10       w_scan -fc -c <COUNTRY_ID> [ options ]
11       w_scan -ft -c <COUNTRY_ID> [ options ]
12       w_scan -fs -s <SATELLITE_ID> [ options ]
13

DESCRIPTION

15       w_scan  scans for DVB-C, DVB-S/S2, DVB-T, ISDB-T and ATSC channels. Any
16       other program accessing the DVB hardware (like  e.g.  VDR)  has  to  be
17       closed in order to avoid conflicts while running w_scan.
18       w_scan  provides the channels in different output formats (Default: VDR
19       channels.conf). For other output formats see OPTIONS.
20

OPTIONS

22       The following options are available.
23
24       -f TYPE
25              Frontend type,
26              "a" = ATSC,
27              "c" = DVB-C,
28              "s" = DVB-S/S2,
29              "t" = DVB-T (and ISDB-T) [default]
30              Depending on "TYPE", either of the arguments  "-s"  or  "-c"  is
31              mandatory.
32
33       -c COUNTRY_ID
34              Mandatory  argument  for ATSC scans, cable scans and terrestrian
35              scans, see option -f.
36              Specifies the country where you try  to  scan  for  channels  as
37              uppercase two letter identifier, e.g.
38              DE = Germany,
39              US = United States,
40              FR = France
41              Use "-c?" for a list of all known identifiers.
42
43       -s SATELLITE_ID
44              Mandatory argument for satellite scans, see option -f.
45              Specifies  the  satellite  you wish to scan as uppercase identi‐
46              fier, e.g.
47              S19E2 = 19.2° east,
48              S13E0 = 13.0° east,
49              S0W8 = 0.8° west.
50              Use "-s?" for a list of all known identifiers.
51
52       -A N   specify ATSC scan type
53              1 = terrestrial [default],
54              2 = cable,
55              3 = both, cable and terrestrial.
56
57       -o N   VDR channels.conf format
58              2 = VDR-2.0 [default],
59              21 = VDR-2.1
60
61       -X     generate zap/czap/xine output instead of VDR channels.conf.
62
63       -x     generate initial tuning data output for  (dvb-)scan  instead  of
64              VDR channels.conf.
65
66       -k     generate channels.dvb for kaffeine instead of VDR channels.conf.
67
68       -L     generate VLC xspf playlist (experimental)
69
70       -M     mplayer output instead of vdr channels.conf
71
72       -G     generate output for Gstreamer dvbsrc plugin
73
74       -h     show help
75
76       -H     show expert help
77

EXPERT OPTIONS

79       -C CHARSET
80              specifies the output charset, i.e. "UTF-8", "ISO-8859-15"
81              use 'iconv --list' to see full list of charsets.
82
83       -I FILE
84              import dvbscan initial_tuning_data
85
86       -v     verbose (repeat for more)
87
88       -q     quiet (repeat for less)
89
90       -R N   Radio channels
91              0 = don't search radio channels
92              1 = search radio channels [default]
93
94       -T N   TV channels
95              0 = don't search TV channels,
96              1 = search TV channels [default]
97
98       -O N   Other services
99              0 = don't search other services [default]
100              1 = search other services
101
102       -E N   Conditional access / encrypted channels
103              0 = only Free TV channels,
104              1 = include encrypted channels [default]
105
106       -a N   use device /dev/dvb/adapterN/ [default: auto detect]
107              (also allowed: -a /dev/dvb/adapterN/frontendM)
108              NOTE: This option is deprecated and should be usually omitted.
109
110       -F     Long filter timeout for reading data from hardware.
111
112       -t N   Tuning  timeout,  increasing  may help if device tunes slowly or
113              has bad reception.
114              1 = fastest [default],
115              2 = medium,
116              3 = slowest
117
118       -i N   spectral inversion setting for cable TV
119              0 = off,
120              1 = on,
121              2 = auto [default]
122
123       -Q     DVB-C modulation [default: choosen by country]
124              NOTE: for experienced users only!
125              0 = QAM64,
126              1 = QAM256,
127              2 = QAM128
128
129       -S RATE
130              set DVB-C symbol rate, see table: [default: choosen by country]
131              NOTE: for experienced users only!!
132              0 = 6.9000 MSymbol/s
133              1 = 6.8750 MSymbol/s
134              2 = 6.9565 MSymbol/s
135              3 = 6.9560 MSymbol/s
136              4 = 6.9520 MSymbol/s
137              5 = 6.9500 MSymbol/s
138              6 = 6.7900 MSymbol/s
139              7 = 6.8110 MSymbol/s
140              8 = 6.2500 MSymbol/s
141              9 = 6.1110 MSymbol/s
142              10 = 6.0860 MSymbol/s
143              11 = 5.9000 MSymbol/s
144              12 = 5.4830 MSymbol/s
145              13 = 5.2170 MSymbol/s
146              14 = 5.1560 MSymbol/s
147              15 = 5.0000 MSymbol/s
148              16 = 4.0000 MSymbol/s
149              17 = 3.4500 MSymbol/s
150
151       -e     extended DVB-C scan flags.
152              NOTE: for experienced users only!
153              Any combination of these flags:
154              1 = use extended symbolrate list,
155              2 = extended QAM scan
156
157       -l TYPE
158              choose LNB type by name (DVB-S/S2 only) [default: UNIVERSAL],
159              "-l?" for list of known LNBs.
160
161       -D Nc  use DiSEqC committed switch position N (N = 0 .. 3)
162
163       -D Nu  use DiSEqC uncommitted switch position N (N = 0 .. 15)
164
165       -p <file>
166              use DiSEqC rotor Position file
167
168       -r N   use Rotor position N (N = 1 .. 255)
169
170       -P     ATSC scan: do not use ATSC PSIP tables for  scan  (PAT  and  PMT
171              only)
172

EXAMPLES

174       scan satellite 19.2° east:
175              w_scan -fs -s S19E2
176
177       scan cable (DVB), Germany:
178              w_scan -fc -c DE
179
180       scan aerial (DVB), France:
181              w_scan -ft -c FR
182
183       scan cable (ATSC), United States:
184              w_scan -fa -A2 -c US
185
186       scan aerial (ATSC), United States:
187              w_scan -fa -A1 -c US
188
189       use output format kaffeine:
190              w_scan [ OTHER OPTIONS ] -k
191
192       use output format zap/czap/xine:
193              w_scan [ OTHER OPTIONS ] -X
194
195       use output format dvbscan/scan/scan-s2 initial tuning data.
196              w_scan [ OTHER OPTIONS ] -x
197              NOTE:  w_scan also performs full scans, so there is generally no
198              need for this.
199

REPORTING BUGS

201       see README file from source code package.
202

AUTHOR

204       Written by W.Koehler
205
206       Permission is granted to copy, distribute and/or modify  this  document
207       under  the terms of the GNU General Public License, Version 2 any later
208       version published by the Free Software Foundation.
209