1zvbi-atsc-cc(1) General Commands Manual zvbi-atsc-cc(1)
2
6 zvbi-atsc-cc - ATSC Closed Caption decoder
7
9 zvbi-atsc-cc [ options ] [-n] station name
10
12 zvbi-atsc-cc captures ATSC TV transmissions using a Linux DVB device
13 and decodes the enclosed Closed Caption data. It can record both NTSC
14 caption (EIA 608-B) and DTVCC caption (CEA 708-C).
15
17 -? -h --help --usage
18 Print a short usage message.
19 -q --quiet
21 Suppress all progress and error messages.
22 -v --verbose
24 Increase verbosity.
25 Device options
27 -a number
28 --adapter-num number
29 Select a different DVB device to capture the signal
30 (/dev/dvb/adapterN). The default is adapter 0.
31 -i number
33 --frontend-id number
34 Select a different frontend on the DVB device
35 (/dev/dvb/adapterN/frontendM). Most devices have only one fron‐
36 tend. The default is frontend 0.
37 -d number
39 --demux-id number
40 Select a different demultiplexer on the DVB device
41 (/dev/dvb/adapterN/demuxM). Most devices have only one demulti‐
42 plexer. The default is demultiplexer 0.
43 -r number
45 --dvr-id number
46 Select a different DVR interface on the DVB device
47 (/dev/dvb/adapterN/dvrM). Most devices have only one DVR inter‐
48 face. The default is DVR interface 0.
49 -T
51 --ts Decode an MPEG-2 Transport Stream on standard input instead of
52 opening a DVB device. This option is mainly intended for debug‐
53 ging.
54 Since Transport Streams can contain multiple programs you must
56 still specify one or more station names, which zvbi-atsc-cc will
57 look up in a channel configuration file to determine the Program
58 ID of the video elementary stream or streams it should extract.
59 You should also add the --atsc option to clarify that this is an
60 ATSC TS and the program should expect an azap channel configura‐
61 tion file, which is otherwise inferred from the DVB device capa‐
62 bilities.
63 Tuning options
65 -e file name
66 --channel-conf file name
67 To tune in a TV station zvbi-atsc-cc needs a channel configura‐
68 tion file. We use the config file of the azap tuning tool from
69 the linuxtv-dvb-apps package. You can create it with the scan
70 tool from the same package.
71 The azap channel configuration file is a text file which lists
73 one station per line. Each line contains six fields separated by
74 a colon: The station name, the transponder frequency in Hz, the
75 modulation used (8VSB, 16VSB, QAM_64, QAM_256), the video stream
76 PID, the audio stream PID, and the service ID. Empty lines and
77 lines starting with a number sign will be ignored.
78 This option selects a different channel configuration file. The
80 default is
81 $HOME/.azap/channels.conf
82 -L --list
84 List all stations in the channel configuration file and their
85 transponder frequency.
86 -n station name
88 --station station name
89 The station to tune in. Usually the -n can be omitted.
90 zvbi-atsc-cc can record caption from multiple stations at once
92 if they share a transponder frequency. Just specify multiple
93 station names on the command line to enable this.
94 Caption options
96 With the caption and XDS options you specify which data zvbi-atsc-cc
97 should extract. If multiple station names are given these options apply
98 to the succeeding station name. You must specify at least one of these
99 options for each station.
100 -c --cc
102 Print any received caption on standard output.
103 -C file name
105 --cc-file file name
106 Append any received caption to the specified file.
107 -l number
109 --channel number
110 Print NTSC Closed Caption channel 1, 2, 3 or 4 on standard out‐
111 put.
112 -1 ... -4 file name
114 --cc1-file ... --cc4-file file name
115 Filter out NTSC Closed Caption channel CC1 ... CC4 and append
116 the text to the specified file. CC1 is the primary, CC3 the sec‐
117 ondary caption service. If both services are transmitted CC1
118 usually carries English, CC3 Spanish caption.
119 -5 ... -8 file name
121 --t1-file ... --t4-file file name
122 Filter out NTSC Text service T1 ... T4 and append the text to
123 the specified file.
124 -9 ... -0 file name
126 --s1-file ... --s2-file file name
127 Filter out DTVCC service 1 or 2 and append the text to the spec‐
128 ified file. Service 1 is the primary, service 2 the secondary
129 caption service. If both services are transmitted service 1 usu‐
130 ally carries English, service 2 Spanish caption.
131 Digital TV stations are supposed to transmit language codes and
133 other information about the available caption services but these
134 are not presently evaluated. zvbi-atsc-cc filters out text
135 which does not appear to be caption, such as tickers or verti‐
136 cally printed text.
137 -b --no-webtv
139 Do not print WebTV links.
140 -m --timestamps
142 Prepend timestamps (YYYYMMDDHHMMSS) to caption lines.
143 -s --sentences
145 Print caption one sentence at a time.
146 -j type
148 --format type
149 When type is "plain" zvbi-atsc-cc prints caption and XDS text
150 without any markup. When type is "vt100" it faithfully repro‐
151 duces the caption foreground and background color, italic and
152 underline attributes by inserting VT.100 terminal control codes.
153 With type "ntsc-cc" it mimics the output of the ntsc-cc and
154 zvbi-ntsc-cc tool. The default is "ntsc-cc".
155 zvbi-atsc-cc supports all Closed Caption character sets and con‐
157 verts to the encoding of the current locale, usually UTF-8.
158 -p --plain
160 Same as -j plain
161 XDS options
163 -x --xds
164 Print all received XDS data on standard output.
165 -X file name
167 --xds-file file name
168 Filter out eXtended Data Service data (station name, program
169 name, program rating etc.) and append it as text to the speci‐
170 fied file.
171 -f type[,type]*
173 --filter type[,type]*
174 Filter out specific XDS information: all, call (station call
175 sign), desc (program synopsis), length, network, rating, time,
176 timecode, timezone, title. Multiple -f options accumulate. The
177 default is "all".
178
180 zvbi-atsc-cc -c NJN-HD
181 zvbi-atsc-cc --cc1-file wnyw.txt WNYW-DT --cc1-file wwor.txt WWOR-DT
183 (NJN-HD, WNYW-DT and WWOR-DT are TV stations in New York. WNYW-DT
185 and WWOR-DT can be captured simultaneously because they share a
186 transponder frequency.)
187
189 $HOME/.azap/channels.conf
190
192 zvbi-ntsc-cc, azap
193 http://zapping.sourceforge.net
195
197 Michael H. Schimek (mschimek AT users.sourceforge.net)
198 timecop@japan.co.jp
199 Mike Baker
200 Mark K. Kim
201
203 This program is free software; you can redistribute it and/or modify it
204 under the terms of the GNU General Public License as published by the
205 Free Software Foundation; either version 2 of the License, or (at your
206 option) any later version.
207 This program is distributed in the hope that it will be useful, but
209 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
210 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
211 Public License for more details.
212 You should have received a copy of the GNU General Public License along
214 with this program; if not, write to the Free Software Foundation, Inc.,
215 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
216 zvbi-atsc-cc(1)