1dvb-format-convert(1)            User Commands           dvb-format-convert(1)
2
3
4

NAME

6       dvb-format-convert - DVBv5 tool for file format conversions
7

SYNOPSIS

9       dvb-format-convert [OPTION]...  input-file output-file
10

DESCRIPTION

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
17       There are currently 3 different formats supported for input:
18
19dvbv5 - the standard format at libdvbv5, capable of representing  all
20         different TV standards;
21
22channel  -  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
26zap - the dvb-apps legacy format for tuning, with supports only ATSC,
27         DVB-C, DVB-S and DVB-T standards.
28
29       There is one extra output format:
30
31vdr - the format used by the vdr application. It  supports  all  fea‐
32         tures found up on vdr version 2.1.6.
33
34       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

OPTIONS

39       The following options are valid:
40
41       -I, --input-format=format
42              Format  of the input file.  Supported input formats: channel zap
43              and dvbv5.
44
45       -O, --output-format=format
46              Format of the output file.  Supported output formats: vdr, chan‐
47              nel, zap and dvbv5.
48
49       -s, --delsys=system
50              Delivery system type.  Needed if input or output format is ZAP.
51
52       -?, --help
53              Outputs the usage help.
54
55       --usage
56              Give a short usage message.
57
58       -V, --version
59              Print program version.
60

EXAMPLES

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
66       $ dvb-format-convert -I channel -O dvbv5 dvbc-channel-legacy dvbc-channel
67       Reading file dvbc-channel-legacy
68       Writing file dvbc-channel
69
70   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
74       $ 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
82       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
86       The  above  warnings  happened  on pure-audio channels and on data-only
87       channels:
88
89       Original dvb_channel.conf file:
90
91       [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
103
104       [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
115
116       [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
127
128       [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
139
140       [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
151
152       [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
164
165       [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
175
176       [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
186
187       [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
197
198       So, for the channels with multiple PIDs, the converted legacy.conf file
199       will have just the first one.
200
201       For the channels without an audio or video PID, it will store PID=0.
202
203       This is the output file for the above channel list.
204
205       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

BUGS

216       Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>
217
219       Copyright (c) 2011-2014 by Mauro Carvalho Chehab.
220
221       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.
224
225
226
227DVBv5 Utils 1.22.1              Fri Oct 3 2014           dvb-format-convert(1)
Impressum