1ALEVT-CAP(1)                   Teletext capture                   ALEVT-CAP(1)
2
3
4

NAME

6       alevt-cap - simple capture of teletext pages
7
8

SYNOPSIS

10       alevt-cap [options] ppp[.ss] ...
11
12

DESCRIPTION

14       alevt-cap is a simple program to capture teletext pages and write them
15       to disk.  You just give it a list of pages to fetch and it will save
16       them.  Nothing fancy like time-outs, page ranges, or channel name
17       detection is supported.  Though, it supports different file formats -
18       at the moment ascii, ansi (ascii with color escape sequences), html,
19       png, and ppm.
20
21

OPTIONS

23       A summary of options is included below.
24
25       -name filename
26              Gives the filename under which the pages should be saved.  It
27              may contain a couple of %-sequences (see below).  (default:
28              ttext-%s.%e)
29
30       -format format-specifier
31              Sets the file format used to save pages (see below).  (default:
32              ascii)
33
34       -format list|help
35              Lists all known file formats and their options.
36
37       -vbi device
38              Use the given device name (default: /dev/vbi0).
39
40       -finetune -4..4|auto
41              Specify the fine tuning for the decoder.  For the right value
42              play with alevt.  Default: 1.
43
44       -timeout seconds
45              If the pages cannot be captured in seconds, the program termi‐
46              nates with exit status 1 after saving the already captured
47              pages.  The default is to wait forever.
48
49       -charset latin-1|latin-2|russian
50              Selects the character set to use.  Characters not present in the
51              selected set are replaced by similar looking symbols.  (default:
52              latin-1)
53
54       --help Show summary of options.
55
56       --version
57              Show version of program.
58
59       Every non-option argument is taken as a page number.  Subpages may be
60       given in the form ppp.ss where ppp is the page number and ss is the
61       subpage number.  If no subpage is specified, the first transmitted sub‐
62       page of that page is taken.  The page is saved with the prior given
63       format and name.
64
65
66   Filenames
67       The filename may contain %-sequences.  The following sequences are
68       defined:
69
70              %%     a single % sign.
71
72              %e     the default extension of the selected output format.
73
74              %p     the page number and an optional subpage number.
75
76              %P     the page number.
77
78              %S     the subpage number.
79
80              %s     the page number as given on the command line.
81
82       Between the % sign and the letter you can give a field width to which
83       the replacement string should be padded.
84
85
86   Format specifiers
87       The output format and associated options are given by the format speci‐
88       fier.  It is made up of one or more comma separated words.  The first
89       word selects the output format and the others are options for that for‐
90       mat.  There are common options valid for all output formats and format
91       specific (private) ones.  Some options have the form of an assignment.
92       The order of the options is free.  Only the format name itself must be
93       the first word.  An example:
94
95       ansi,reveal,bg=none
96              The ansi is the format and reveal, and bg=none are options.
97
98       At the moment there are only two common options: reveal, and hide.
99       They control whether the hidden characters present in a page should be
100       shown in the output or not.  The default is hide.
101
102       The special format string list (or help) will give you a list of all
103       supported output formats and their options.
104
105       (The ansi format is an alias for ascii,color.)
106
107

DIAGNOSTICS

109       If the program timed out and some pages are missing the exit status is
110       1.  On fatal errors the exit status is 2.
111
112

NOTE

114       Before starting this program, you have to set the TV channel with
115       another program like xawtv of set-tv.
116
117

FILES

119       /dev/vbi*
120
121

SEE ALSO

123       alevt(1x), alevt-date(1),
124
125

BUGS

127       If you give a page number that is never transmitted the program will
128       not terminate.
129
130       Bug reports to <froese@gmx.de>.
131
132
133
134LINUX                                1.6.2                        ALEVT-CAP(1)
Impressum