.. Mktoc // (c) 2008, Patrick C. McGinty
.. mktoc[@]tuxcoder[dot]com
Mktoc simplifies the steps needed to create audio CD TOC files for the
cdrdao CD burning program. For users familiar with ExactAudioCopy or
CdrWin, TOC files are synonymous with CUE sheets. The primary goal of
mktoc is to create TOC files using a previously generated CUE sheet.
Features
========
* Create a TOC file from a list of WAV files
* Convert an ExactAudioCopy (EAC) CUE file to the TOC format that
is usable by cdrdao.
* Non-compliant CUE sheet support.
* Support for various pregap methods.
* Can create offset corrected WAV files for true 'bit-for-bit'
accurate copies.
* Fuzzy file name logic can correct common file name spelling
variations.
* Workaround known TOC file parsing bugs in cdrdao.
Usage
=====
::
mktoc [OPTIONS] < CUE_FILE
mktoc [OPTIONS] [[-f] CUE_FILE] [[-o] TOC_FILE]
mktoc [OPTIONS] -w WAV_FILES [[-o] TOC_FILE]
``CUE_FILE`` must contain a valid CUE format. When ``*_FILE`` is not
provided, the program will read from ``STDIN``. All output will be sent
to ``STDOUT``.
All attempts will be made to preserve any and all information from
the input file. For any case where the CUE file contains unknown or
bad values, the user will be notified on ``STDERR``.
Options
=======
--version
show program's version number and exit
-h show help message and exit
--help
show detailed usage instructions and exit
-a, --allow-missing-wav
do not abort when WAV file(s) are missing, (experts only). It
is possible when using this option that a bug in cdrdao will
create a CD that ignores the pregap definitions in the TOC
file. Only use this option if the CUE file does not contain
pregaps, or if you do not wish to retain the pregap
information.
-c WAV_OFFSET, --offset-correction=WAV_OFFSET
correct reader/writer offset by creating WAV file(s) shifted
by WAV_OFFSET samples (original data is not modified)
-f CUE_FILE, --file=CUE_FILE
specify the input CUE file to read
-o TOC_FILE, --output=TOC_FILE
specify the output TOC file to write
-t, --use-temp
write offset corrected WAV files to /tmp directory
-w, --wave
write a TOC file using list of WAV files
Examples
========
1. Create a TOC file from a set of WAV files::
mktoc -w *.wav
2. Write a TOC file to :file:`toc_file.toc`, from a set of WAV files::
mktoc -w *.wav toc_file.toc
mktoc -w *.wav > toc_file.toc
mktoc -w *.wav -o toc_file.toc
3. Create a TOC file from a valid CUE file::
mktoc cue_file.cue
mktoc < cue_file.cue
mktoc -f cue_file.cue
4. Write a TOC file to :file:`toc_file.toc`, given an input CUE file::
mktoc cue_file.cue toc_file.toc
mktoc < cue_file.cue > toc_file.toc
mktoc -f cue_file.cue -o toc_file.toc
5. Tell mktoc to ignore missing WAV file errors. There is a
potential that the result TOC file will cause cdrdao to loose
pregap information during the burn process (see above)::
mktoc -a cue_file.cue
6. Adjust WAV files for a CD writer offset value. For example, if
your CD writer has a -30 sample write offset, it can be
corrected by offsetting the input WAV files by +30 samples. New
WAV files will be placed in the working directory in a new dir
called ``wav+30``::
mktoc -c 30 < cue_file.cue
7. Adjust WAV files for a CD writer offset value, but create new
files in the :file:`/tmp directory`::
mktoc -c 30 -t < cue_file.cue
Contact
=======
E-mail
-------
| mktoc[@]tuxcoder[dot]com
Info
----
| http://mktoc.googlecode.com
| http://blog.tuxcoder.com