CUE2DDP(1) cue2ddp Manual CUE2DDP(1)
NAME
cue2ddp — create a DDP 2.00 master from an audio CD cue sheet
SYNOPSIS
cue2ddp [-ct] [-m master-id] cuesheet [ddpdirectory]
cue2ddp [ --help | --version ]
DESCRIPTION
The cue2ddp command acts as an audio CD image converter, parsing a
cuesheet and writing a DDP 2.0 fileset to ddpdirectory. This directory
must exist and files therin will be overwritten whithout further
notice, if necessary. With no ddpdirectory specified, the program exits
after parsing the cue sheet and printing a summary of the infromation
found, this can be used as syntax check. When cuesheet is set to "-"
cue2ddp reads from standard input.
Parsing is done with the intention to rather exit with an error than
end up with a DDP that's based on guesses about the exact meaning of
the input file. Parser warnings will be isseud in non-fatal situations
to give as detailed a feedback as possible.
CD text is supported with the standard TITLE, PERFORMER, and SONGWRITER
cue sheet commands. In that case all CD Text fields are expected to be
encoded as IS0 8859-1 (Latin1), and the language will be set to Eng-
lish. When using the CDTEXTFILE cue sheet command to link a binary CD
Text file cue2ddp will uses the CD Text data exactly as found.
Although not part of the DDP format cue2ddp will also add MD5 and CRC32
checksum files, which can be used to verify data integrity, e.g. after
the DDP fileset has been transferred to a different location or media.
OPTIONS
-c, --add-cuesheet
Embedd a cue sheet within the DDP fileset. The DDP specification
allows for inclusion of text files with arbitrary content, which
will not affect the disc replication but can be used to store
commentary notes on a project. Cue2ddp uses such a file to embed
a cue sheet in the DDP fileset; together with the main data file
(IMAGE.DAT) it makes up a cue/bin image, which can be read by a
variety of software to write CDs or play back the audio content.
-m master-id, --master-id=master-id
Set the master identifier, an ASCII string of 48 characters max-
imum, which can be used to give the master a unique name, but
does not end up on the manufactured CD. Note that this is the
only way to reliably name a DDP fileset, since the file names of
all DDP files are fix.
-t, --add-cdtext
Include CD Text in the DDP fileset; cue2ddp will place a binary
CD text file within the DDP fileset, which will result in a
replicated CD with CD text information written into the R
through W subcode of the lead-in ("Sony style" CD text). When
this flag is set but no CD text fields and no binary CD text
file are found in the cue sheet, a warning will be issued. By
default cue2ddp does not write CD text, because the cuesheet's
TITLE command is often simply used to name tracks without the
intention to actually include CD text.
--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 following 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 versions can not.
A DDP 2.0 written by cue2ddp includes the following files:
DDPID, DDPMS
Some general metadata and a list of files making up this DDP.
SD PQ subcode data, i.e. track and index positions, ISRCs, UPC/EAN,
and track flags.
IMAGE.DAT
Audio data in raw format, 44.1 kHz, 16 bit little endian, stereo
with interleaved samples.
CDTEXT.BIN (optional)
CD text information in a pre-encoded binary format with embedded
checksums.
IMAGE.CUE (optional)
A cue sheet to accompany the data file.
CHECKSUM.MD5
MD5 checksums of all DDP files, while not part of the DDP
itself, this can be used to verify data integrity later.
CHECKSUM.TXT
CRC32 checksums of all DDP files, while not part of the DDP
itself, this can be used to verify data integrity later.
CUE SHEET COMMANDS
Cue sheets were introduced by Golden Hawk Technology for their CDRwin
CD burning software, the "official" description is found in the appen-
dix of CDRwin's user manual ("CDRwin.pdf"). Cue2ddp supports the fol-
lowing commands:
REM A comment, the rest of the line will be ignored.
CDTEXTFILE
Specifies a binary CD text file. If the filename includes spaces
it must be enclosed in double quotes. If this file is given all
other CD text commands like TITLE, PERFORMER, etc. are ignored.
Cue2ddp will only roughly check the format of the file and copy
it verbatim into the DDP. The correctness of the resulting DDP
will thus not depend on cue2ddp but the software which created
the binary CD text file.
CATALOG
Only in the global section, assigns the catalog number. This is
a European Aricle Number (EAN13), which 13 digits. In the U.S.
the Unified Prodcut Code (UPC-A) with 12 digits is used, and you
need to add a leading Zero to make 13 digits. Both codes use the
last digit as checksum and cue2ddp will always validate them.
FILE Cue2ddp only supports one audio file per cue sheet, which must
contain the whole audio program, including pre-gaps. It may or
may not include the first pre-gap at the start of track 1; if
this pre-gap is not included the the mandatory two seconds of
silence will be added when writing the DDP. Cue2ddp only sup-
ports file types 'WAVE', 'BINARY' and 'MOTOROLA'. In all cases
the audio must be 44.1 kHz, 16 bit, little endian, stereo with
interleaved channels. The length of the audio file determines
the end of the CD. If it does not end at a CD sector boundary
(1/75th of a second i.e. 2352 bytes) cue2ddp fills up the last
sector with digital silence.
File names may include relative or absolute paths, where rela-
tive paths will be resolved relative to the cue sheet's loca-
tion, not the current directory. If file names include space
characters they must be enclosed in double quotes.
TRACK Start a track section, the only track type supported is "AUDIO".
ISRC The International Standard Recording Code.
FLAGS Track flags supported are: 'PRE', 'DCP', '4CH', 'SCMS'. Use
flags only if you know exactly, what you are doing, they are
very rarely used these days. 'DCP' and 'SCMS' are mutually
exclusive.
INDEX Set the position of a pre-gap start (INDEX 00), a track start
(INDEX 01), or further sub-indexes (INDEX 01-99). INDEX 01 is
required for each track.
TITLE, PERFORMER, SONGWRITER
Set a CD text field, either in the global section for the whole
disc or within a track section. When the text contains spaces it
has to be enclosed in double quotes. Cue2ddp stops reading a CD
text field at the last double quote in that line, so the text
iteslf can contain (unsecaped) double qotes. The encoding is
assumed to be IS0\ 8859-1 (Latin1), multi-byte character sets
are not supported.
PRE-GAP, POST-GAP
These commands are not supported.
SEE ALSO
ddpinfo(1), cdtinfo(1), dvdtape(1)
AUTHOR
Written by Andreas Ruge.
COPYRIGHT AND DISCLAIMER
Copyright 2006-2018 Andreas Ruge
DDP(R) is a trademark of DCA, Inc.
Copyright 1989-2008 DCA, Inc.
Licensed from DCA, Inc.
ddptools 1.0 2018-02-20 CUE2DDP(1)