W scan: Difference between revisions

From LinuxTVWiki
Jump to navigation Jump to search
(update to current w_scan syntax.)
(redirect to w_scan_cpp. Who still really want it, should know about newer and maintained version.)
 
(30 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{lowercase|w_scan}}
{{lowercase|w_scan}}


"w_scan" is a small command line utility used to perform [[Frequency scan|frequency scan]]s for DVB and ATSC transmissions. It is capable of directly creating channels.conf files as well as initial tuning data for [[Scan|scan]] which is contained in the [[LinuxTV dvb-apps]].
''w_scan'' is a small command line utility used to perform [[Frequency scan|frequency scan]]s for [[DVB]] and [[ATSC]] transmissions. It is not included in [[LinuxTV dvb-apps]], but complements the two [[Frequency scan|frequency scanning]] utilities available through [[LinuxTV dvb-apps]], [[Dvbscan|dvbscan]] and [[Scan|scan]]. It is meanwhile replaced by the newer tool [[w_scan_cpp]] with similar syntax.

''w_scan'' is capable of directly creating channels.conf files as well as initial tuning data for [[Scan|scan]].


==Obtaining w_scan==
==Obtaining w_scan==
You can get w_scan [http://wirbel.htpc-forum.de/w_scan/index2.html here].
The last ''w_scan'' version can be still obtained [https://www.gen2vdr.de/wirbel/w_scan_cpp/index2.html here]. There will be no further updates.


==Documentation==
==Documentation==
''w_scan'' doesn't have a man page. However, if you run it with the -h parameter, the output provides a summary of its command line options.
Detailed information can be found in the ''w_scan'' man page (i.e. from a console, run <code>man w_scan</code>). Additionally, running ''w_scan'' with the -h parameter will produce an output that provides a summary of it's main command line options.
<pre>w_scan [options...] >> channels.conf</pre>
<pre>w_scan [options...] >> channels.conf</pre>
'''If you try to use w_scan you should at least specify three parameters: frontend type, country/satellite and output format.'''<br>
If the output format is not specified, w_scan defaults to create [http://www.cadsoft.de/vdr/ VDR-1.6 channels.conf].

{| border=1 cellpadding=1 cellspacing=0
|- bgcolor=#efefef
!Parameter
!Description
|-
| '''-f Type'''||
'''Frontend Type'''<br>
a = ATSC (North America, cable and terrestrial)<br>
c = DVB-C (Europe, cable)<br>
s = DVB-S/S2 (Satellite)<br>
t = DVB-T (Europe, terrestrial = default)<br>
''NOTE: ATSC support needs w_scan >= 20080815''
''NOTE: Satellite support needs w_scan >= 20090504''
|-
| '''-A Type'''||
'''ATSC Type''' (ignored for DVB-C and DVB-T)<br>
1 = VSB ("Over-the-Air)"<br>
2 = QAM annex B ("cable TV")<br>
3 = both of them
|-
| '''-c ID'''||
'''Country''' (mandatory for ATSC, DVB-C, DVB-T)<br>
uppercase two character identifier as defined in ISO 3166-1,<br>
(DE,FR,GB,US,FI,...)<br>
see -c? for list of contries.
|-
| '''-s ID'''||
'''Satellite''' (mandatory for DVB-S/S2)<br>
uppercase character constant with E (east) or W (west)as separator,<br>
(S19E2,S13E0,S0W8,...)<br>
see -s? for list of satellites.
|-
| '''-X'''||
czap/tzap/xine channels.conf<br>
|-
| '''-x'''||
"initial tuning data" for [[Scan]]
|-
| '''-k'''||
channels.dvb for [[Kaffeine]]
|-
| '''--help'''||
basic help
|-
| '''-H'''||
extended help for expert functionality
|}

''Experts'' or ''experienced users'' may use some of the other options, but this is not recommended.<br>
{{Note|w_scan searches ''/dev/dvb/adapterX/frontendY'' for DVB/ATSC cards matching to option "-f", therefore specifying the adapter "-a XX" is not recommended.}}

==Examples==
NOTE: ATSC support needs w_scan >= 20080815
NOTE: DVB-S/S2 support needs w_scan >= 20090504


In general, when using ''w_scan'' you should at least specify three parameters: frontend type, country/satellite and output format.
===Scanning ATSC VSB (United States, Over-the-Air)===
$ w_scan -fa -A1 -c US -X
===Scanning ATSC QAM annex B (United States, digital cable TV)===
$ w_scan -fa -A2 -c US -X
===Scanning DVB-T (Germany, Over-the-Air, VDR output)===
$ w_scan -ft -c DE
===Scanning DVB-C (Germany, digital cable TV, kaffeine channels.dvb)===
$ w_scan -fc -c DE -k
===Scanning DVB-S/S2 (Astra 19.2east, vdr-1.7.x)===
$ w_scan -fs -s S19E2 -o 7
===Scanning DVB-S (Thor 0.8west, vdr-1.3.x .. vdr-1.6.x)===
$ w_scan -fs -s S0W8
===Generating dvbscan tuning data===
Exactly as above, just specify output format dvbscan with "-x":
$ w_scan -f <FRONTEND_TYPE> {-c <COUNTRY>,-s <SATELLITE>} -x >''cc-Ttttt''


''As w_scan was superceeded quite a long time ago, pls refer to the [[w_scan_cpp]] page for it's similar syntax.''
If you choose to create an initial scan file (and you know the name of your local transmitter or cable provider), you can send the resulting file to the [http://linuxtv.org/cgi-bin/mailman/listinfo/linux-dvb dvb mailing list] after checking that it hasn't already been posted or added to the [http://linuxtv.org/hg/dvb-apps/file/tip/util/scan/ scan directory in the dvb-apps repository].


==Also See==
==Also See==
* [[Frequency_scan#Comparison_of_DVB_frequency_scanning_commandline_utilities|Comparison of the scanning utilities]].
* [https://www.mankier.com/1/w_scan man w_scan]
* [[scan]]
* [[scan]]
* [[dvbscan]]
* [[dvbscan]]


==External Links==
==External Links==
* [[w_scan_cpp|see w_scan_cpp]]
* [http://wirbel.htpc-forum.de/w_scan/index2.html Homepage]
* [http://64.233.179.104/translate_c?hl=en&langpair=de%7Cen&u=http://wirbel.htpc-forum.de/w_scan/index2.html English translation via Google]
* [http://edafe.org/vdr/w_scan/ English howto by edafe]


[[Category:Apps & Utilities]]
[[Category:Apps & Utilities]]

Latest revision as of 10:21, 8 August 2021

w_scan is a small command line utility used to perform frequency scans for DVB and ATSC transmissions. It is not included in LinuxTV dvb-apps, but complements the two frequency scanning utilities available through LinuxTV dvb-apps, dvbscan and scan. It is meanwhile replaced by the newer tool w_scan_cpp with similar syntax.

w_scan is capable of directly creating channels.conf files as well as initial tuning data for scan.

Obtaining w_scan

The last w_scan version can be still obtained here. There will be no further updates.

Documentation

Detailed information can be found in the w_scan man page (i.e. from a console, run man w_scan). Additionally, running w_scan with the -h parameter will produce an output that provides a summary of it's main command line options.

w_scan [options...] >> channels.conf

In general, when using w_scan you should at least specify three parameters: frontend type, country/satellite and output format.

As w_scan was superceeded quite a long time ago, pls refer to the w_scan_cpp page for it's similar syntax.

Also See

External Links