View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Steve Price > Linux-DVB-DVBT > dvbt-scan


Annotate this POD


New  3
Open  0
View/Report Bugs


dvbt-scan - Initialise DVBT channels


dvbt-scan [options] [ <frequency file | country code> ]


       -debug level         set debug level
       -verbose level       set verbosity level
       -help                brief help message
       -man                 full documentation
       -clean               perform a clean scan
       -a|dvb adap          use adapter number
       -countries           list country codes



Print a brief help message and exits.


Prints the manual page and exits.


Set verbosity level. Higher values show more information.


Set debug level. Higher levels show more debugging information (only really of any interest to developers!)


Start a clean scan (i.e. don not merge this scan with previous results). Normally you'll want to merge (the default) so that you scan in the morning and evening to pick up all the channels (since some are only broadcast morning or evening). However, after a frequency change it is best to start from scratch again by using this option.


Use if you wish to specify which one of multiple DVB adapters to use (useful if you are recording on the default adapter).


Does not run a scan, instead it lists all the supported country codes (i.e. those country codes that have information for used DVB-T frequencies).


Script that uses the perl Linux::DVB::DVBT package to provide DVB-T adapter functions.

Runs the frequency scanning function to search for Freeview channels. Stores the channel information into configuration files.

If this program is run as root then the configuration files are stored under /etc/dvb and are available for any user. Otherwise they are stored in $HOME/.tv for just the user.

The command line argument specified must be either a frequency file or a country code. Alternatively, iff a scan has been performed before, then specifying no argument causes the scan to reuse the previously saved frequencies. Note that this only works for scans performed by version 2.11 (and upwards) of the Linux::DVB::DVBT module.

The frequency file is usually something like: /usr/share/dvb/dvb-t/uk-Oxford

The file contents should be something like:

   # Oxford
   # T freq bw fec_hi fec_lo mod transmission-mode guard-interval hierarchy
   T 578000000 8MHz 2/3 NONE QAM64 2k 1/32 NONE

Frequency files are provided by the 'dvb' rpm package available for most distros. Alternatively, if you have kaffeine installed, look in $HOME/.kde/share/apps/kaffeine/dvb-t. If all else fails you can always get them from my CPAN web space:

To determine which file to use, check and enter your postcode.

Alternatively a country code (compliant with ISO 3166-1) can be specified and a (longer!) scan of all valid frequencies for that country will be performed. For example, to scan in the UK use:

        $ dvbt-scan GB

For reference, a scan of 6 frequencies stored in a frequency file takes approximately 4 minutes. A scan based on the UK country code (which consists of 57 frequencies) takes approximately 24 minutes.

For full details of the DVBT functions, please see:

   perldoc Linux::DVB::DVBT
syntax highlighting: