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 DIRECTORY. The files will be named "Track-01.wav", "Track-02.wav", etc. Pauses between tracks are not included in the audio file. 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. A good DAW will read time stamps and correctly align audio files on import, thus preserving the original pauses between tracks. -u DIRECTORY, --wave-tracks-with-pause=DIRECTORY Export one Broadcast Wave file per track into DIRECTORY. The files will be named "Track-01.wav", "Track-02.wav", etc. Pauses between tracks are included at the end of a track's file, so each file will cover the range between the track's start posi- tion (index 01) and the next track's start position. A time stamp is written into the Broadcast 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 add "title", "performer", and "songwriter" fields to the cue sheet. If other CD text fields are set in the DDP, i.e. fields which can't be specified by the cue sheet 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 including a directory. This option is you're best choice if you want to burn a DDP image, as there are many burning applications avaiable 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-2018 Andreas Ruge DDP(R) is a trademark of DCA, Inc. Copyright 1989-2008 DCA, Inc., Licensed from DCA, Inc.
ddptools 1.1 2018-03-16 DDPINFO(1)