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)