1dvb-format-convert(1) User Commands dvb-format-convert(1)
2
6 dvb-format-convert - DVBv5 tool for file format conversions
7
9 dvb-format-convert [OPTION]... input-file output-file
10
12 dvb-format-convert is a tool meant to convert among different file for‐
13 mats. It is compliant with version 5 of the DVB API, being capable of
14 representing all properties on any standard supported by the Linux dig‐
15 ital TV drivers.
16 There are currently 3 different formats supported for input:
18 • dvbv5 - the standard format at libdvbv5, capable of representing all
20 different TV standards;
21 • channel - the dvb-apps legacy channel format, with supports only
23 ATSC, DVB-C, DVB-S and DVB-T standards, extended to also support
24 s2-scan format for DVB-S2 files, and to support DVB-T2.
25 • zap - the dvb-apps legacy format for tuning, with supports only ATSC,
27 DVB-C, DVB-S and DVB-T standards.
28 There is one extra output format:
30 • vdr - the format used by the vdr application. It supports all fea‐
32 tures found up on vdr version 2.1.6.
33 Unfortunately, the dvb-apps legacy zap format doesn't store the DVB
35 standard, so, any conversions to and/or from this format requires an
36 extra parameter, to specify the delivery system.
37
39 The following options are valid:
40 -I, --input-format=format
42 Format of the input file. Supported input formats: channel zap
43 and dvbv5.
44 -O, --output-format=format
46 Format of the output file. Supported output formats: vdr, chan‐
47 nel, zap and dvbv5.
48 -s, --delsys=system
50 Delivery system type. Needed if input or output format is ZAP.
51 -?, --help
53 Outputs the usage help.
54 --usage
56 Give a short usage message.
57 -V, --version
59 Print program version.
60
62 Converting a channel file from legacy dvb-apps format
63 Reads a file at the dvb-apps channel file and writes it at dvbv5 for‐
64 mat.
65 $ dvb-format-convert -I channel -O dvbv5 dvbc-channel-legacy dvbc-channel
67 Reading file dvbc-channel-legacy
68 Writing file dvbc-channel
69 Convert a dvbv5 file with programs on it to the legacy dvb-apps zap format
71 Reads a file generated by dvbv5-scan on dvbv5 format and writes a new
72 file at dvb-apps zap format.
73 $ dvb-format-convert -I dvbv5 -O zap -s dvbc/annex_a dvb_channel.conf legacy.conf
75 Reading file dvb_channel.conf
76 Writing file legacy.conf
77 WARNING: missing video PID while parsing entry 6 of legacy.conf
78 WARNING: missing video PID while parsing entry 7 of legacy.conf
79 WARNING: missing video PID while parsing entry 8 of legacy.conf
80 WARNING: missing audio PID while parsing entry 8 of legacy.conf
81 Please notice that the legacy dvb-apps format assumes that every chan‐
83 nel will have one (and just one) audio PID and one (and just one) video
84 PID, while the dvbv5 format supports multiple PID per service type.
85 The above warnings happened on pure-audio channels and on data-only
87 channels:
88 Original dvb_channel.conf file:
90 [the]
92 SERVICE_ID = 4
93 VIDEO_PID = 42
94 AUDIO_PID = 257
95 PID_f1 = 768
96 FREQUENCY = 573000000
97 MODULATION = QAM/256
98 INVERSION = AUTO
99 SYMBOL_RATE = 5217000
100 INNER_FEC = NONE
101 DELIVERY_SYSTEM = DVBC/ANNEX_A
102 [quick]
105 SERVICE_ID = 5
106 VIDEO_PID = 288
107 AUDIO_PID = 289
108 FREQUENCY = 573000000
109 MODULATION = QAM/256
110 INVERSION = AUTO
111 SYMBOL_RATE = 5217000
112 INNER_FEC = NONE
113 DELIVERY_SYSTEM = DVBC/ANNEX_A
114 [brown]
117 SERVICE_ID = 7
118 VIDEO_PID = 36
119 AUDIO_PID = 305
120 FREQUENCY = 573000000
121 MODULATION = QAM/256
122 INVERSION = AUTO
123 SYMBOL_RATE = 5217000
124 INNER_FEC = NONE
125 DELIVERY_SYSTEM = DVBC/ANNEX_A
126 [fox]
129 SERVICE_ID = 13
130 VIDEO_PID = 272
131 AUDIO_PID = 273
132 FREQUENCY = 573000000
133 MODULATION = QAM/256
134 INVERSION = AUTO
135 SYMBOL_RATE = 5217000
136 INNER_FEC = NONE
137 DELIVERY_SYSTEM = DVBC/ANNEX_A
138 [jumps]
141 SERVICE_ID = 18
142 VIDEO_PID = 368
143 AUDIO_PID = 369
144 FREQUENCY = 573000000
145 MODULATION = QAM/256
146 INVERSION = AUTO
147 SYMBOL_RATE = 5217000
148 INNER_FEC = NONE
149 DELIVERY_SYSTEM = DVBC/ANNEX_A
150 [over]
153 SERVICE_ID = 48
154 VIDEO_PID = 336
155 AUDIO_PID = 337 338 849
156 PID_86 = 816
157 FREQUENCY = 573000000
158 MODULATION = QAM/256
159 INVERSION = AUTO
160 SYMBOL_RATE = 5217000
161 INNER_FEC = NONE
162 DELIVERY_SYSTEM = DVBC/ANNEX_A
163 [the]
166 SERVICE_ID = 57
167 AUDIO_PID = 353
168 FREQUENCY = 573000000
169 MODULATION = QAM/256
170 INVERSION = AUTO
171 SYMBOL_RATE = 5217000
172 INNER_FEC = NONE
173 DELIVERY_SYSTEM = DVBC/ANNEX_A
174 [lazy]
177 SERVICE_ID = 104
178 AUDIO_PID = 321
179 FREQUENCY = 573000000
180 MODULATION = QAM/256
181 INVERSION = AUTO
182 SYMBOL_RATE = 5217000
183 INNER_FEC = NONE
184 DELIVERY_SYSTEM = DVBC/ANNEX_A
185 [dog]
188 SERVICE_ID = 252
189 PID_05 = 3047 3046 3045 3044 3042
190 FREQUENCY = 573000000
191 MODULATION = QAM/256
192 INVERSION = AUTO
193 SYMBOL_RATE = 5217000
194 INNER_FEC = NONE
195 DELIVERY_SYSTEM = DVBC/ANNEX_A
196 So, for the channels with multiple PIDs, the converted legacy.conf file
199 will have just the first one.
200 For the channels without an audio or video PID, it will store PID=0.
202 This is the output file for the above channel list.
204 the:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:42:257:4
206 quick:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:288:289:5
207 brown:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:36:305:7
208 fox:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:272:273:13
209 jumps:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:368:369:18
210 over:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:336:337:48
211 the:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:0:353:57
212 lazy:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:0:321:104
213 dog:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:0:0:252
214
216 Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>
217
219 Copyright (c) 2011-2014 by Mauro Carvalho Chehab.
220 License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
222 This is free software: you are free to change and redistribute it.
223 There is NO WARRANTY, to the extent permitted by law.
224DVBv5 Utils 1.22.1 Fri Oct 3 2014 dvb-format-convert(1)