mp3cd --version (return code: 0)
mp3cd version 1.27.0
Copyright 2003-2011 Kees Cook <kees@outflux.net>
This program is free software; you may redistribute it under the terms of
the GNU General Public License. This program has absolutely no warranty.
mp3cd --help (return code: 0)
Usage:
mp3cd [OPTIONS] [playlist|files...]
-s, --stage STAGE Start at a certain stage of processing:
clean Start fresh (default, requires playlist)
build Does not clean (requires playlist)
decode Turns MP3s/Oggs/FLACs into WAVs
correct Fix up any WAV formats
norm Normalizes WAV volumes
toc Builds a Table of Contents from WAVs
toc_ok Checks TOC validity
cdr_ok Checks for a CDR
burn Burns from the TOC
-q Quits after one stage of processing
-t, --tempdir DIR Set working dir (default "/tmp/mp3cd-$USER")
-d, --device PATH Look for CDR at "PATH" (default "/dev/cdrecorder")
-r, --driver TYPE Use CDR driver TYPE (default up to cdrdao)
-n, --simulate Don't actually burn a disc but do everything else.
-E, --no-eject Don't eject drive after the burn.
-L, --no-log Don't redirect output to "tool-output.txt"
-T, --no-cd-text Don't attempt to write CD-TEXT tags to the audio CD
-c, --cdrdao ARGS Pass the option string ARGS to cdrdao.
-S, --skip STAGES Skip the comma-separated list of stages in STAGES.
-V, --version Report which version of the script this is.
-v, --verbose Shows commands as they are executed.
-h, --usage Shows brief usage summary.
--help Shows detailed help summary.
--longhelp Shows complete help.
Options:
-s STAGE, --stage STAGE
Starts processing at a given stage. This is used in case you had
to stop processing, or a file was missing, or things generally
blew up. It is especially useful if a burn fails because then
you don't have to start totally over and re-WAV the files. If
you just want to perform a single step, use --quit to abort
after the stage you request with --stage. Also see --skip.
clean This is the default starting stage. The temp directory
is cleared out. A playlist is required, since we expect
to move to the build stage next, which requires it.
build This stage examines the playlist from the command line,
and tries to create a list of symlinks from the given
playlist. So far, "mp3cd" can understand ".m3u" files,
XMLPlaylist files, and lists of files.
decode All the files are converted into WAVs. So far, "mp3cd"
knows how to decode MP3, Ogg, and FLAC files. (WAVs will
be left as they are during this stage.)
correct The WAV files are corrected to have the correct bitrate
and number of channels, as required for an audio CD.
norm The WAV files' volumes are normalized so any large
differences in volume between records will be less
noticeable.
toc Generates a Table of Contents for the audio CD.
toc_ok Validates the TOC, just in case something went really
wrong with the WAV files.
cdr_ok Verifies that there is a CDR ready for burning.
burn Actually performs the burn of all the WAV files to the
waiting CDR.
-q, --quit
Aborts after one stage of processing. See --stage.
-t DIR, --tempdir DIR
Use a working directory other than "/tmp/mp3cd-username". This
is where all the file processing occurs. You will generally need
at least 650M free here (or more depending on the recording
length of your destination CD).
-d PATH, --device PATH
Use a device path other than "/dev/cdrecorder".
-r TYPE, --driver TYPE
Use a CDRDAO driver other than what cdrdao automatically
detects. Note that some drivers may not support CD-TEXT mode. In
this case, try "generic-mmc-raw".
-c ARGS, --cdrdao ARGS
Pass the given option string of ARGS to cdrdao during each
command.
-n, --simulate
Do not actually write to the disc but simulate the process
instead.
-E, --no-eject
Don't eject drive after the burn.
-L, --no-log
Don't redirect output to "tool-output.txt". All information will
instead be redirected to the terminal via standard output
(STDOUT). This will cause a lot of low-level detail to be
displayed.
-T, --no-cd-text
Don't attempt to write CD-TEXT tags to the audio CD. Some
devices and drivers do not support this mode. See --driver for
more details.
-S STAGES, --skip STAGES
While processing, skips the stages listed in the comma-separated
list of stages given in STAGES. This would only be used if you
really know what you're doing. For example, if the audio is
already normalized and you didn't want to burn a CD, you could
skip the normalizing and burning stages by giving "--skip
norm,burn". See --stage and --quit.
-V, --version
Report which version of mp3cd this is.
-v, --verbose
Shows commands as they are executed.
-h, --usage
Show brief usage summary.
--help Show detailed help summary.
--longhelp
Shows the full command line instructions.