1ALEVT-CAP(1) Teletext capture ALEVT-CAP(1)
2
6 alevt-cap - simple capture of teletext pages
7
10 alevt-cap [options] ppp[.ss] ...
11
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 de‐
17 tection is supported. Though, it supports different file formats - at
18 the moment ascii, ansi (ascii with color escape sequences), html, png,
19 and ppm.
20
23 A summary of options is included below.
24 -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 -format format-specifier
31 Sets the file format used to save pages (see below). (default:
32 ascii)
33 -format list|help
35 Lists all known file formats and their options.
36 -vbi device
38 Use the given device name. Default: /dev/vbi, /dev/vbi0,
39 /dev/video0, /dev/dvb/adapter0/demux0 tried in this order.
40 -finetune -4..4|auto
42 Specify the fine tuning for the decoder. For the right value
43 play with alevt. Default: 1.
44 -timeout seconds
46 If the pages cannot be captured in seconds, the program termi‐
47 nates with exit status 1 after saving the already captured
48 pages. The default is to wait forever.
49 -charset latin-1|latin-2|koi8-r|iso8859-7
51 Selects the character set to use. Characters not present in the
52 selected set are replaced by similar looking symbols. (default:
53 latin-1)
54 -progname name
56 Specifies the program name if using the DVB interface.
57 -pid pid
59 Specifies the teletext PID if using the DVB interface.
60 --help Show summary of options.
62 --version
64 Show version of program.
65 Every non-option argument is taken as a page number. Subpages may be
67 given in the form ppp.ss where ppp is the page number and ss is the
68 subpage number. If no subpage is specified, the first transmitted sub‐
69 page of that page is taken. The page is saved with the prior given
70 format and name.
71 Filenames
74 The filename may contain %-sequences. The following sequences are de‐
75 fined:
76 %% a single % sign.
78 %e the default extension of the selected output format.
80 %p the page number and an optional subpage number.
82 %P the page number.
84 %S the subpage number.
86 %s the page number as given on the command line.
88 Between the % sign and the letter you can give a field width to which
90 the replacement string should be padded.
91 Format specifiers
94 The output format and associated options are given by the format speci‐
95 fier. It is made up of one or more comma separated words. The first
96 word selects the output format and the others are options for that for‐
97 mat. There are common options valid for all output formats and format
98 specific (private) ones. Some options have the form of an assignment.
99 The order of the options is free. Only the format name itself must be
100 the first word. An example:
101 ansi,reveal,bg=none
103 The ansi is the format and reveal, and bg=none are options.
104 At the moment there are only two common options: reveal, and hide.
106 They control whether the hidden characters present in a page should be
107 shown in the output or not. The default is hide.
108 The special format string list (or help) will give you a list of all
110 supported output formats and their options.
111 (The ansi format is an alias for ascii,color.)
113 The -progname or -pid option specifies the program or teletext PID if
115 using the DVB interface.
116 If neither of these two options is used, alevt outputs informations
118 about the currently accessible streams and uses the first of these PIDs
119 as default. This output contains the PIDs and names that can be used as
120 an input for the -progname or -pid option in the context of the cur‐
121 rently chosen TV channel.
122
125 If the program timed out and some pages are missing the exit status is
126 1. On fatal errors the exit status is 2.
127
130 Before starting this program, you have to set the TV channel with an‐
131 other program like xawtv of set-tv.
132
135 /dev/vbi*
136 /dev/dvb/adapter*/demux*
138
141 alevt(1x), alevt-date(1),
142
145 If you give a page number that is never transmitted the program will
146 not terminate.
147 Bug reports to <https://gitlab.com/alevt/alevt>.
149LINUX 1.8.1 ALEVT-CAP(1)