NAME

       w_scan - a universal ATSC and DVB blind scanner

SYNOPSIS

       w_scan -fa -c <COUNTRY_ID> [ options ]
       w_scan -fc -c <COUNTRY_ID> [ options ]
       w_scan -ft -c <COUNTRY_ID> [ options ]
       w_scan -fs -s <SATELLITE_ID> [ options ]

DESCRIPTION

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

OPTIONS

       The following options are available.

       -f TYPE
              Frontend type,
              "a" = ATSC,
              "c" = DVB-C,
              "s" = DVB-S/S2,
              "t" = DVB-T (and ISDB-T) [default]
              Depending on "TYPE", either of the arguments "-s" or "-c" is mandatory.

       -c COUNTRY_ID
              Mandatory argument for ATSC scans, cable scans and terrestrian  scans,  see  option
              -f.
              Specifies  the  country  where you try to scan for channels as uppercase two letter
              identifier, e.g.
              DE = Germany,
              US = United States,
              FR = France
              Use "-c?" for a list of all known identifiers.

       -s SATELLITE_ID
              Mandatory argument for satellite scans, see option -f.
              Specifies the satellite you wish to scan as uppercase identifier, e.g.
              S19E2 = 19.2° east,
              S13E0 = 13.0° east,
              S0W8 = 0.8° west.
              Use "-s?" for a list of all known identifiers.

       -A N   specify ATSC scan type
              1 = terrestrial [default],
              2 = cable,
              3 = both, cable and terrestrial.

       -o N   VDR channels.conf format
              2 = VDR-2.0 [default],
              21 = VDR-2.1

       -X     generate zap/czap/xine output instead of VDR channels.conf.

       -x     generate initial tuning data output for (dvb-)scan instead of VDR channels.conf.

       -k     generate channels.dvb for kaffeine instead of VDR channels.conf.

       -L     generate VLC xspf playlist (experimental)

       -M     mplayer output instead of vdr channels.conf

       -G     generate output for Gstreamer dvbsrc plugin

       -h     show help

       -H     show expert help

EXPERT OPTIONS

       -C CHARSET
              specifies the output charset, i.e. "UTF-8", "ISO-8859-15"
              use 'iconv --list' to see full list of charsets.

       -I FILE
              import dvbscan initial_tuning_data

       -v     verbose (repeat for more)

       -q     quiet (repeat for less)

       -R N   Radio channels
              0 = don't search radio channels
              1 = search radio channels [default]

       -T N   TV channels
              0 = don't search TV channels,
              1 = search TV channels [default]

       -O N   Other services
              0 = don't search other services,
              1 = search other services [default]

       -E N   Conditional access / encrypted channels
              0 = only Free TV channels,
              1 = include encrypted channels [default]

       -a N   use device /dev/dvb/adapterN/ [default: auto detect]
              (also allowed: -a /dev/dvb/adapterN/frontendM)
              NOTE: This option is deprecated and should be usually omitted.

       -F     Long filter timeout for reading data from hardware.

       -t N   Tuning timeout, increasing may help if device tunes slowly or has bad reception.
              1 = fastest [default],
              2 = medium,
              3 = slowest

       -i N   spectral inversion setting for cable TV
              0 = off,
              1 = on,
              2 = auto [default]

       -Q     DVB-C modulation [default: choosen by country]
              NOTE: for experienced users only!
              0 = QAM64,
              1 = QAM256,
              2 = QAM128

       -S RATE
              set DVB-C symbol rate, see table: [default: choosen by country]
              NOTE: for experienced users only!!
              0 = 6.9000 MSymbol/s
              1 = 6.8750 MSymbol/s
              2 = 6.9565 MSymbol/s
              3 = 6.9560 MSymbol/s
              4 = 6.9520 MSymbol/s
              5 = 6.9500 MSymbol/s
              6 = 6.7900 MSymbol/s
              7 = 6.8110 MSymbol/s
              8 = 6.2500 MSymbol/s
              9 = 6.1110 MSymbol/s
              10 = 6.0860 MSymbol/s
              11 = 5.9000 MSymbol/s
              12 = 5.4830 MSymbol/s
              13 = 5.2170 MSymbol/s
              14 = 5.1560 MSymbol/s
              15 = 5.0000 MSymbol/s
              16 = 4.0000 MSymbol/s
              17 = 3.4500 MSymbol/s

       -e     extended DVB-C scan flags.
              NOTE: for experienced users only!
              Any combination of these flags:
              1 = use extended symbolrate list,
              2 = extended QAM scan

       -l TYPE
              choose LNB type by name (DVB-S/S2 only) [default: UNIVERSAL],
              "-l?" for list of known LNBs.

       -D Nc  use DiSEqC committed switch position N (N = 0 .. 3)

       -D Nu  use DiSEqC uncommitted switch position N (N = 0 .. 15)

       -p <file>
              use DiSEqC rotor Position file

       -r N   use Rotor position N (N = 1 .. 255)

       -P     ATSC scan: do not use ATSC PSIP tables for scan (PAT and PMT only)

EXAMPLES

       scan satellite 19.2° east:
              w_scan -fs -s S19E2

       scan cable (DVB), Germany:
              w_scan -fc -c DE

       scan aerial (DVB), France:
              w_scan -ft -c FR

       scan cable (ATSC), United States:
              w_scan -fa -A2 -c US

       scan aerial (ATSC), United States:
              w_scan -fa -A1 -c US

       use output format kaffeine:
              w_scan [ OTHER OPTIONS ] -k

       use output format zap/czap/xine:
              w_scan [ OTHER OPTIONS ] -X

       use output format dvbscan/scan/scan-s2 initial tuning data.
              w_scan [ OTHER OPTIONS ] -x
              NOTE: w_scan also performs full scans, so there is generally no need for this.

REPORTING BUGS

       see README file from source code package.

AUTHOR

       Written by W.Koehler

       Permission is granted to copy, distribute and/or modify this document under the  terms  of
       the GNU General Public License, Version 2 any later version published by the Free Software
       Foundation.

SEE ALSO

       vdr(1)

                                          28 March 2011                                 w_scan(1)