SYNOPSIS
cue2toc [-hnqv] [-o tocfile] [-w wavefile] [cuefile]
DESCRIPTION
Cue2toc converts cuefile from CUE to TOC format and writes the result
to tocfile. If either cuefile or tocfile is omitted or a single dash
"-" cue2toc reads from standard input and writes to standard ouput
respectively.
CUE files are text files describing the layout of a CD-Rom and typi-
cally carry the extension ".cue".
Cdrdao is a CD-burning application which has its own native TOC format
to describe the disc layout. Although cdrdao has direct support for
reading CUE files, it is currently limited to data tracks only. So
cue2toc's main usefulness lies in converting CUE files containing audio
tracks.
Output of CD-Text data can be disabled with the -n option.
CUE files often come with MP3 files but since cdrdao doesnt support
decoding them on the fly they probably must be decoded by other means
prior to writing the CD (e.g. using lame). For this reason you can
specify a filename with the -w option to be used for all audio tracks
instead of the one in the CUE file. Of course this is only really use-
ful if all the tracks are based on the same file. This seems to be the
case quite often however.
Cue2toc normally displays warning messages for unsupported commands and
constructs. The -q option disables these warnings.
OPTIONS
-h print a short help message
-n no CD-Text; disable output of CD-Text information
-o tocfile
write result to tocfile instead of standard ouput
-q quiet mode; do not print warnings
-v print version number
-w wavefile
tive. CD-Text data can be at most 80 characters per item.
Timecode values are accepted in the forms "X:X:X", "X:X" and "X" where
each "X" must consist of at most two digits and may be zero padded to
the left. They are interpreted as "M:S:F", "S:F" and "F" respectively
where "M" means "minutes" and must be in the range 0 <= M <= 99, "S"
means "seconds" and must be in the range 0 <= S <= 59, and "F" means
"frames" and must be in the range 0 <= F <= 74.
CUE files are logically divided into a global section and one to 99
track sections. Inside these sections the following commands are
allowed:
Global Section
REM anything_to_newline
CATALOG string
CDTEXTFILE string
TITLE string
PERFORMER string
SONGWRITER string
FILE string BINARY|MOTOROLA|AIFF|WAVE|MP3
REM Optional. Introduces a comment. Anything from there on up to
and including the next newline character is ignored. Comments
can appear anywhere in the file but not between a command and
its arguments.
CATALOG
Optional. The Media Catalog Number of the disc. Must be exactly
13 characters.
CDTEXTFILE
Optional. Specifies an external file containing CD-Text data.
Ignored.
TITLE Optional. The CD-Text title of the disc.
PERFORMER
Optional. The CD-Text performer of the disc.
SONGWRITER
Optional. The CD-Text songwriter of the disc.
TRACK number mode
REM anything_to_newline
FLAGS [DCP] [4CH] [PRE] [SCMS]
ISRC string
TITLE string
PERFORMER string
SONGWRITER string
PREGAP timecode
INDEX number timecode
POSTGAP timecode
FILE string BINARY|MOTOROLA|AIFF|WAVE|MP3
TRACK Required. Starts a new track definition. The number is ignored.
The mode must be one of AUDIO, MODE1/2048, MODE1/2352,
MODE2/2336 or MODE2/2352.
FLAGS Optional. Defines the flags for this track. Must be followed by
one or more of the following commands: DCP (digital copy permit-
ted), 4CH (four channel audio), PRE (pre-emphasis enabled) and
SCMS (serial copy management system). SCMS is ignored because
there is no corresponding option in the TOC format.
ISRC Optional. The International Standard Recording Code for this
track. Must be exactly 12 characters long.
TITLE Optional. The CD-Text title of this track.
PERFORMER
Optional. The CD-Text performer of this track.
SONWRITER
Optional. The CD-Text songwriter of this track.
PREGAP Optional. The length of the track pregap to be filled with zero
data. Mutually exclusive with INDEX 0.
POSTGAP
Optional. The length of the track postgap to be filled with
zero data.
INDEX Optional. The number must be in the range 0 <= number <= 99.
Index number 1 specifies the start of the track. Index number 0
format and are ignored.
CUE files containing data tracks which specify a starting time greater
than zero cannot be converted by cue2toc because the TOC format does
not provide a way to specify a starting time at all for data tracks.
However if the CUE file does not contain any audio tracks you can try
to use the CUE file directly with cdrdao.
EXAMPLE
Suppose we have the following CUE file "uwe.froehn.cue" describing an
audio CD with CD-Text data:
REM Example CUE file with audio tracks
CATALOG 1234567890123
TITLE "Der Berg ruft"
PERFORMER "Uwe Froehn"
FILE "uwe.froehn.mp3" MP3
TRACK 01 AUDIO
TITLE "Meine Mama ist die Beste"
PERFORMER "Uwe Froehn"
SONGWRITER "Hansi Klabuster"
REM two seconds pregap filled with audio data
INDEX 00 00:00:00
INDEX 01 00:02:00
REM subindexes
INDEX 02 00:35:17
INDEX 03 01:12:44
TRACK 02 AUDIO
TITLE "Hoch oben im Tal"
SONGWRITER "Gabi Geil"
REM no pregap
INDEX 01 02:45:38
TRACK 03 AUDIO
REM pregap with zero data
PREGAP 00:4:47
INDEX 01 07:58:74
REM postgap with zero data
POSTGAP 00:35:00
Since cdrdao cannot decode the MP3 file on the fly this step must be
carried out by hand, e.g. using lame:
lame --decode uwe.froehn.mp3 uwe.froehn.wav
Although the filename appears only once in the example CUE file it gets
written for every track in the TOC file so you would need to edit lots
of occurences of the filename in the TOC file by hand. For this reason
TITLE "Der Berg ruft"
PERFORMER "Uwe Froehn"
}
}
TRACK AUDIO
CD_TEXT {
LANGUAGE 0 {
TITLE "Meine Mama ist die Beste"
PERFORMER "Uwe Froehn"
SONGWRITER "Hansi Klabuster"
}
}
AUDIOFILE "uwe.froehn.wav" 00:00:00 02:45:38
START 00:02:00
INDEX 00:35:17
INDEX 01:12:44
TRACK AUDIO
CD_TEXT {
LANGUAGE 0 {
TITLE "Hoch oben im Tal"
SONGWRITER "Gabi Geil"
}
}
AUDIOFILE "uwe.froehn.wav" 02:45:38 05:13:36
TRACK AUDIO
PREGAP 00:04:47
AUDIOFILE "uwe.froehn.wav" 07:58:74
SILENCE 00:35:00
SEE ALSO
cdrdao(1), lame(1)
BUGS
Since cue2toc's definition of the CUE format is entirely based on a
number of different CUE files the author came across there is a very
high probability that it will not work correctly with all the other CUE
files you might encounter. If this is the case for you please send the
problematic CUE file along with the version number of cue2toc to <der-
matsch@gmx.de>.
AUTHOR
Matthias Czapla <dermatsch@gmx.de>
Man(1) output converted with
man2html