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.
53 zvbi-ntsc-cc still needs a station name to determine the Program
55 ID of the video elementary stream it should extract.
56 Tuning options
58 -e file name
59 --channel-conf file name
60 To tune in a TV station zvbi-ntsc-cc needs a channel configura‐
61 tion file. We use the config file of the azap tuning tool from
62 the linuxtv-dvb-apps package. You can create it with the scan
63 tool from the same package.
64 This option selects a different channel configuration file. The
66 default is
67 $HOME/.azap/channels.conf
68 -L --list
70 List all stations in the channel configuration file and their
71 transponder frequency.
72 -n station name
74 --station station name
75 The station to tune in. Usually the -n can be omitted.
76 zvbi-ntsc-cc can record caption from multiple stations at once
78 if they share a transponder frequency. Just specify multiple
79 station names on the command line to enable this.
80 Caption options
82 With the caption and XDS options you must specify for each station
83 which data zvbi-ntsc-cc should extract. If multiple station names are
84 given these options apply to the next station on the command line.
85 -c --cc
87 Print any received caption on standard output.
88 -C file name
90 --cc-file file name
91 Append any received caption to the specified file.
92 -l number
94 --channel number
95 Print NTSC Closed Caption channel 1, 2, 3 or 4 on standard out‐
96 put.
97 -1 ... -4 file name
99 --cc1-file ... --cc4-file file name
100 Filter out NTSC Closed Caption channel CC1 ... CC4 and append
101 the text to the specified file. CC1 is the primary, CC3 the sec‐
102 ondary caption service. If both services are transmitted CC1
103 usually carries English, CC3 Spanish caption.
104 -5 ... -8 file name
106 --t1-file ... --t4-file file name
107 Filter out NTSC Text service T1 ... T4 and append the text to
108 the specified file.
109 -9 ... -0 file name
111 --s1-file ... --s2-file file name
112 Filter out DTVCC service 1 or 2 and append the text to the spec‐
113 ified file. Service 1 is the primary, service 2 the secondary
114 caption service. If both services are transmitted service 1 usu‐
115 ally carries English, service 2 Spanish caption.
116 Digital TV stations are supposed to transmit language codes and
118 other information about the available caption services but these
119 are not presently evaluated. zvbi-atsc-cc filters out text
120 which does not appear to be caption, such as tickers or verti‐
121 cally printed text.
122 -b --no-webtv
124 Do not print WebTV links.
125 -m --timestamps
127 Prepend timestamps (YYYYMMDDHHMMSS) to caption lines.
128 -s --sentences
130 Print caption one sentence at a time.
131 -j type
133 --format type
134 When type is "plain" zvbi-atsc-cc prints caption and XDS text
135 without any markup. When type is "vt100" it faithfully repro‐
136 duces the caption foreground and background color, italic and
137 underline attributes by inserting VT.100 terminal control codes.
138 With type "ntsc-cc" it mimics the output of the ntsc-cc and
139 zvbi-ntsc-cc tool, which is also the default.
140 zvbi-atsc-cc supports all Closed Caption character sets and con‐
142 verts to the encoding of the current locale, usually UTF-8.
143 -p --plain
145 Same as -j plain
146 XDS options
148 -x --xds
149 Print all received XDS data on standard output.
150 -X file name
152 --xds-file file name
153 Filter out eXtended Data Service data (station name, program
154 name, program rating etc.) and append it as text to the speci‐
155 fied file.
156 -f type[,type]*
158 --filter type[,type]*
159 Filter out specific XDS information: all, call (station call
160 sign), desc (program synopsis), length, network, rating, time,
161 timecode, timezone, title. Multiple -f options accumulate. The
162 default is "all".
163
165 zvbi-ntsc-cc -c NJN-HD
166 zvbi-ntsc-cc --cc1-file wnyw.txt WNYW-DT --cc1-file wwor.txt WWOR-DT
168 (NJN-HD, WNYW-DT and WWOR-DT are TV stations in New York.)
170
172 $HOME/.azap/channels.conf
173
175 zvbi-ntsc-cc, azap
176 http://zapping.sourceforge.net
178
180 Michael H. Schimek (mschimek AT users.sourceforge.net)
181 timecop@japan.co.jp
182 Mike Baker
183 Mark K. Kim
184
186 This program is free software; you can redistribute it and/or modify it
187 under the terms of the GNU General Public License as published by the
188 Free Software Foundation; either version 2 of the License, or (at your
189 option) any later version.
190 This program is distributed in the hope that it will be useful, but
192 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
193 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
194 Public License for more details.
195 You should have received a copy of the GNU General Public License along
197 with this program; if not, write to the Free Software Foundation, Inc.,
198 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
199 zvbi-atsc-cc(1)