From Linux Man Pages
alevt-cap - simple capture of teletext pages
alevt-cap [options] ppp[.ss] ...
DESCRIPTION
alevt-cap is a simple program to capture teletext pages and write them to disk. You just give it a list of pages
to fetch and it will save them. Nothing fancy like time-outs, page ranges, or channel name detection is sup-
ported. Though, it supports different file formats - at the moment ascii, ansi (ascii with color escape
sequences), html, png, and ppm.
OPTIONS
A summary of options is included below.
-name filename
Gives the filename under which the pages should be saved. It may contain a couple of %-sequences (see
below). (default: ttext-%s.%e)
-format format-specifier
Sets the file format used to save pages (see below). (default: ascii)
-format list|help
Lists all known file formats and their options.
-vbi device
Use the given device name (default: /dev/vbi).
-finetune -4..4|auto
Specify the fine tuning for the decoder. For the right value play with alevt. Default: 1.
-timeout seconds
If the pages cannot be captured in seconds, the program terminates with exit status 1 after saving the
already captured pages. The default is to wait forever.
-charset latin-1|latin-2
Selects the character set to use. Characters not present in the selected set are replaced by similar
looking symbols. (default: latin-1)
--help Show summary of options.
--version
Show version of program.
Every non-option argument is taken as a page number. Subpages may be given in the form ppp.ss where ppp is the
page number and ss is the subpage number. If no subpage is specified, the first transmitted subpage of that page
is taken. The page is saved with the prior given format and name.
Filenames
The filename may contain %-sequences. The following sequences are defined:
%% a single % sign.
%e the default extension of the selected output format.
%p the page number and an optional subpage number.
%P the page number.
%S the subpage number.
%s the page number as given on the command line.
Between the % sign and the letter you can give a field width to which the replacement string should be padded.
Format specifiers
The output format and associated options are given by the format specifier. It is made up of one or more comma
seperated words. The first word selects the output format and the others are options for that format. There are
common options valid for all output formats and format specific (private) ones. Some options have the form of an
assignment. The order of the options is free. Only the format name itself must be the first word. An example:
ansi,reveal,bg=none
The ansi is the format and reveal, and bg=none are options.
At the moment there are only two common options: reveal, and hide. They control wether the hidden characters
present in a page should be shown in the output or not. The default is hide.
The special format string list (or help) will give you a list of all supported output formats and their options.
(The ansi format is an alias for ascii,color.)
DIAGNOSTICS
If the program timed out and some pages are missing the exit status is 1. On fatal errors the exit status is 2.
NOTE
Before starting this program, you have to set the TV channel with another program like xawtv of set-tv.
FILES
/dev/vbi*
RELATED
alevt(1x), alevt-date(1),
BUGS
If you give a page number that is never transmitted the program will not terminate.
Bug reports to <froese@gmx.de>.
CATEGORY