NAME

dvbt-scan - Initialise DVBT channels

SYNOPSIS

dvbt-scan [options] frequency_file

Options:

-debug level         set debug level
-verbose level       set verbosity level
-help                brief help message
-man                 full documentation
-clean               perform a clean scan
-a adap              use adapter number

OPTIONS

-help

Print a brief help message and exits.

-man

Prints the manual page and exits.

-verbose

Set verbosity level. Higher values show more information.

-debug

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

-clean

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.

-a

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

DESCRIPTION

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 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:

http://www.cpan.org/authors/id/S/SD/SDPRICE/Files/dvb-t.tar.gz

To determine which file to use, check http://www.ukfree.tv/transmitters.php and enter your postcode.

For full details of the DVBT functions, please see:

  perldoc Linux::DVB::DVBT