home | help
dvb-format-convert(1)		  User Commands 	   dvb-format-convert(1)

NAME
     dvb-format-convert - DVBv5 tool for file format conversions

SYNOPSIS
     dvb-format-convert [OPTION]...  input-file output-file

DESCRIPTION
     dvb-format-convert is a tool meant to convert among different file formats.
     It  is compliant with version 5 of the DVB API, being capable of represent-
     ing all properties on any standard supported by the Linux digital	TV  dri-
     vers.

     There are currently 3 different formats supported for input:

     * dvbv5 - the standard format at libdvbv5, capable of representing all dif-
       ferent TV standards;

     * channel	-  the	dvb-apps legacy channel format, with supports only ATSC,
       DVB-C, DVB-S and DVB-T standards, extended to also support s2-scan format
       for DVB-S2 files, and to support DVB-T2.

     * zap - the dvb-apps legacy format for tuning,  with  supports  only  ATSC,
       DVB-C, DVB-S and DVB-T standards.

     There is one extra output format:

     * vdr  -  the  format used by the vdr application. It supports all features
       found up on vdr version 2.1.6.

     Unfortunately, the dvb-apps legacy zap format doesn't store the  DVB  stan-
     dard,  so, any conversions to and/or from this format requires an extra pa-
     rameter, to specify the delivery system.

OPTIONS
     The following options are valid:

     -I, --input-format=format
	    Format of the input file.  Supported input formats: channel zap  and
	    dvbv5.

     -O, --output-format=format
	    Format  of the output file.  Supported output formats: vdr, channel,
	    zap and dvbv5.

     -s, --delsys=system
	    Delivery system type.  Needed if input or output format is ZAP.

     -?, --help
	    Outputs the usage help.

     --usage
	    Give a short usage message.

     -V, --version
	    Print program version.

EXAMPLES
   Converting a channel file from legacy dvb-apps format
     Reads a file at the dvb-apps channel file and writes it at dvbv5 format.

     $ dvb-format-convert -I channel -O dvbv5 dvbc-channel-legacy dvbc-channel
     Reading file dvbc-channel-legacy
     Writing file dvbc-channel

   Convert a dvbv5 file with programs on it to the legacy dvb-apps zap format
     Reads a file generated by dvbv5-scan on dvbv5 format and writes a new  file
     at dvb-apps zap format.

     $ dvb-format-convert -I dvbv5 -O zap -s dvbc/annex_a dvb_channel.conf legacy.conf
     Reading file dvb_channel.conf
     Writing file legacy.conf
     WARNING: missing video PID while parsing entry 6 of legacy.conf
     WARNING: missing video PID while parsing entry 7 of legacy.conf
     WARNING: missing video PID while parsing entry 8 of legacy.conf
     WARNING: missing audio PID while parsing entry 8 of legacy.conf

     Please  notice  that  the legacy dvb-apps format assumes that every channel
     will have one (and just one) audio PID and one (and just  one)  video  PID,
     while the dvbv5 format supports multiple PID per service type.

     The  above  warnings happened on pure-audio channels and on data-only chan-
     nels:

     Original dvb_channel.conf file:

     [the]
	     SERVICE_ID = 4
	     VIDEO_PID = 42
	     AUDIO_PID = 257
	     PID_f1 = 768
	     FREQUENCY = 573000000
	     MODULATION = QAM/256
	     INVERSION = AUTO
	     SYMBOL_RATE = 5217000
	     INNER_FEC = NONE
	     DELIVERY_SYSTEM = DVBC/ANNEX_A

     [quick]
	     SERVICE_ID = 5
	     VIDEO_PID = 288
	     AUDIO_PID = 289
	     FREQUENCY = 573000000
	     MODULATION = QAM/256
	     INVERSION = AUTO
	     SYMBOL_RATE = 5217000
	     INNER_FEC = NONE
	     DELIVERY_SYSTEM = DVBC/ANNEX_A

     [brown]
	     SERVICE_ID = 7
	     VIDEO_PID = 36
	     AUDIO_PID = 305
	     FREQUENCY = 573000000
	     MODULATION = QAM/256
	     INVERSION = AUTO
	     SYMBOL_RATE = 5217000
	     INNER_FEC = NONE
	     DELIVERY_SYSTEM = DVBC/ANNEX_A

     [fox]
	     SERVICE_ID = 13
	     VIDEO_PID = 272
	     AUDIO_PID = 273
	     FREQUENCY = 573000000
	     MODULATION = QAM/256
	     INVERSION = AUTO
	     SYMBOL_RATE = 5217000
	     INNER_FEC = NONE
	     DELIVERY_SYSTEM = DVBC/ANNEX_A

     [jumps]
	     SERVICE_ID = 18
	     VIDEO_PID = 368
	     AUDIO_PID = 369
	     FREQUENCY = 573000000
	     MODULATION = QAM/256
	     INVERSION = AUTO
	     SYMBOL_RATE = 5217000
	     INNER_FEC = NONE
	     DELIVERY_SYSTEM = DVBC/ANNEX_A

     [over]
	     SERVICE_ID = 48
	     VIDEO_PID = 336
	     AUDIO_PID = 337 338 849
	     PID_86 = 816
	     FREQUENCY = 573000000
	     MODULATION = QAM/256
	     INVERSION = AUTO
	     SYMBOL_RATE = 5217000
	     INNER_FEC = NONE
	     DELIVERY_SYSTEM = DVBC/ANNEX_A

     [the]
	     SERVICE_ID = 57
	     AUDIO_PID = 353
	     FREQUENCY = 573000000
	     MODULATION = QAM/256
	     INVERSION = AUTO
	     SYMBOL_RATE = 5217000
	     INNER_FEC = NONE
	     DELIVERY_SYSTEM = DVBC/ANNEX_A

     [lazy]
	     SERVICE_ID = 104
	     AUDIO_PID = 321
	     FREQUENCY = 573000000
	     MODULATION = QAM/256
	     INVERSION = AUTO
	     SYMBOL_RATE = 5217000
	     INNER_FEC = NONE
	     DELIVERY_SYSTEM = DVBC/ANNEX_A

     [dog]
	     SERVICE_ID = 252
	     PID_05 = 3047 3046 3045 3044 3042
	     FREQUENCY = 573000000
	     MODULATION = QAM/256
	     INVERSION = AUTO
	     SYMBOL_RATE = 5217000
	     INNER_FEC = NONE
	     DELIVERY_SYSTEM = DVBC/ANNEX_A

     So, for the channels with multiple PIDs,  the  converted  legacy.conf  file
     will have just the first one.

     For the channels without an audio or video PID, it will store PID=0.

     This is the output file for the above channel list.

     the:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:42:257:4
     quick:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:288:289:5
     brown:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:36:305:7
     fox:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:272:273:13
     jumps:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:368:369:18
     over:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:336:337:48
     the:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:0:353:57
     lazy:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:0:321:104
     dog:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:0:0:252

BUGS
     Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>

COPYRIGHT
     Copyright (c) 2011-2014 by Mauro Carvalho Chehab.

     License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
     This  is  free software: you are free to change and redistribute it.  There
     is NO WARRANTY, to the extent permitted by law.

DVBv5 Utils 1.23.0		 Fri Oct 3 2014 	   dvb-format-convert(1)

home | help