DDPINFO(1)                      ddpinfo Manual                      DDPINFO(1)


NAME
       ddpinfo — display and export the content of a DDP fileset

SYNOPSIS
       ddpinfo [options] ddpdirectory
       ddpinfo [--help|--version]

DESCRIPTION
       The  ddpinfo  command reads DDP filesets and shows its content in human
       readable form, it also offers to  export  the  DDP  as  cue/wav  image.
       While  mainly  focussed  at  DDP masters describing Red Book audio CDs,
       other types of DDP filesets should yield some useful output as well.

       To properly display non-ASCII characters in CD text fields on UNIX-like
       systems  set  your  terminal encoding to either "UTF-8" or "IS0 8859-1"
       (i.e. "Latin1").  On Microsoft Windows set  the  font  of  the  Command
       Promt window to "Lucida Console" or "Consolas".

       If a UPC/EAN code is present, it's checksum digit will be validated.

OPTIONS
       -y, --verify
              Search for MD5 and CRC32 checksum files in the DDP directory and
              use the checksums found to verify the integrity of the DDP file-
              set.  Multiple  checksum  files  will  be  evaluated  one  after
              another.  File formats known to be recognized are: md5sum, Pyra-
              mix,  Sequoia,  SADiE  (all flavors), Sonoris, DSP Quattro, Wave
              Editor.  Feel free to contact the author, if  you  encounter  an
              unsupported file format.

       -x, --add-checksum
              Write  MD5 and CRC32 checksum files with checksums for each file
              which is part of the DDP fileset.  If already present the check-
              sum  files  will  be  overwritten (CHECKSUM.MD5 and CHECKSUM.TXT
              respectively).

       -e, --expert
              Show the content of a DDP fileset in a rather raw format.   Note
              that this is only useful, if you are familiar with the DDP spec-
              ification and want to examine broken or flawed masters.

       --html Print a PQ listing to standard output, formatted as HTML5  docu-
              ment  using  CSS,  so  you  can easily adjust the layout to your
              needs.

       -c, --cuesheet
              Print the subcode data found in a DDP formatted  as  CDRWin  cue
              sheet.   The  data file and CD text file linked will be the ones
              from the DDP with either an absolute path or a path relative  to
              the current directory. This cue sheet together with the data and
              CD text file from the DDP will make up a cue/bin  image.  Please
              note  that in many cases a DDP includes the first two seconds of
              a CD, so that the cue/bin image also  includes  them,  and  many
              burning  applications seem to add another two seconds of silence
              when creating CDs. Thus for burning it's recommended to use  the
              "-w"  option  to  create a separate cue/wav image from this DDP,
              which will copy the DDP's audio excluding the first  pre-gap  if
              any to a wave file.

       -d, --cuesheet-inside
              Write  the subcode data found in the DDP formatted as CDRWin cue
              sheet to a file named "DDP_image.cue" inside the DDP folder. The
              data  file and CD text file linked will be the one from the DDP,
              these files are referenced only by their filename, not including
              any  directory.   The generated cue sheet together with the data
              and CD text file from the DDP will  make  up  a  cue/bin  image.
              Please note that in many cases a DDP includes the first two sec-
              onds of a CD, so that the cue/bin image also includes them,  and
              many  burning  applications  seem  to add another two seconds of
              silence when creating CDs. Thus for burning it's recommended  to
              use the "-w" option to create a separate cue/wav image from this
              DDP, which will copy the DDP's audio excluding the first pre-gap
              if any to a wave file.

       -t DIRECTORY, --wave-tracks=DIRECTORY
              Export  one  Broadcast Wave file per track into given DIRECTORY,
              named "Track-01.wav", "Track-02.wav", etc.  Each  file  includes
              the  pause  before the following track if there is one. A proper
              time stamp is written into the Broadcast Wave extension in order
              to preserve the file's original position within the CD's program
              area.

       -u DIRECTORY, --wave-tracks-with-pause=DIRECTORY
              Export one Broadcast Wave file per track into  DIRECTORY,  named
              "Track-01.wav", "Track-02.wav", etc. No pauses between track are
              included in the files. A time stamp is written into  the  Broad-
              cast  Wave  extension  in  order to preserve the file's original
              position within the CD's program area.

       -w FILE, --wave=FILE
              Export the DDP as cue/wav image.  In  detail:  write  one  large
              Broadcast  Wave  file  named  FILE containing the complete audio
              program including all pauses between tracks. Note that the first
              two seconds of the program data will not be included in the Wave
              file, because most burning applications seem to add these manda-
              tory  two  seconds  of silence when creating a CD-R from cue/wav
              images.  An appropriate time stamp is written into the Broadcast
              Wave  extension  to preserve the file's original position. Addi-
              tionally a CDRWin cue sheet is written  in  the  same  directory
              named  as  the  Wave file but with the file extension changed to
              ".cue". If the DDP includes CD text  ddpinfo  will  include  the
              "title",  "performer",  and  "song  writer"  fields into the cue
              sheet. If other fields are set in the  DDP,  i.e.  fields  which
              can't  be  specified  by  the cue sheer format, a binary CD text
              file is written and linked into the cue sheet. It will be  named
              like  the  Wave  file  but  with  the  file extension changed to
              ".cdt". Both the Wave file and the  optinal  CD  text  file  are
              linked  from the cue sheet simply by their file name not includ-
              ing a directory. This option is you're best choice if  you  want
              to burn a DDP image, as there are many burning applications ava-
              iable which accept cue/wav image.

       -f, --fix-upc
              Copy UPC/EAN field from DDPID to PQ descriptor.   This  fixes  a
              flaw  found  in some DDP masters, where the UPC/EAN code is only
              written into the DDPID file, but not into the  subcode  descrip-
              tor,  and  which  may  lead  to a pressed CD without the EAN/UPC
              embedded in it's subcode stream.

       -v LEVEL, --verbose=LEVEL
              Set verbose level. Higher values yield more output,  default  is
              1,  silent  is 0, greater than 3 are debug messages. Please note
              that this only affects progress reporting and similar  messages,
              not the actual display of the DDP content.

       --help Print short help and exit.

       --version
              Print version information and exit.

DISC DESCRIPTION PROTOCOL (DDP)
       The  DDP  format  was invented by Doug Carson (DCA, Inc.) as a complete
       description of the input media for glass mastering of CD and DVD.   The
       program  and the follwoing notes only refer to DDP as used for Red Book
       audio CD.

       DDP is used  by  many  audio  mastering  engineers  for  sending  their
       projects out to CD manufacturers.  For a long time 8mm Exabyte tape has
       been the preferred media, but hard disk, DVD-R, and FTP dominate todays
       workflow.   Some  people  in the audio world refer to DDP as DDPi, when
       it's written to random-access media.

       DDP for Red Book audio CD is available in version 1.00, 1.01, and  2.00
       with  the  only relevant difference being that version 2.00 can include
       CD text, which earlier version can not.

SEE ALSO
       cue2ddp(1), cdtinfo(1).

AUTHOR
       Written by Andreas Ruge.

COPYRIGHT
       Copyright 2006-2014 Andreas Ruge

       DDP(R) is a trademark of DCA, Inc.
       Copyright 1989-2008 DCA, Inc.,
       Licensed from DCA, Inc.


ddptools 0.8.8                    2014-08-03                        DDPINFO(1)