Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  MP3CD (1)

.ds Aq ’


mp3cd - Burns normalized audio CDs from lists of MP3s/WAVs/Oggs/FLACs



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     Dont actually burn a disc but do everything else.
 -E, --no-eject     Dont eject drive after the burn.
 -L, --no-log       Dont redirect output to "tool-output.txt"
 -T, --no-cd-text   Dont 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.


<B>-s STAGEB>, <B>--stage STAGEB> 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 <B>--quitB> to abort after the stage you request with <B>--stageB>. Also see <B>--skipB>.
<B>cleanB> This is the default starting stage. The temp directory is cleared out. A playlist is required, since we expect to move to the <B>buildB> stage next, which requires it.
<B>buildB> 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.
<B>decodeB> 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.)
<B>correctB> The WAV files are corrected to have the correct bitrate and number of channels, as required for an audio CD.
<B>normB> The WAV files’ volumes are normalized so any large differences in volume between records will be less noticeable.
<B>tocB> Generates a Table of Contents for the audio CD.
<B>toc_okB> Validates the TOC, just in case something went really wrong with the WAV files.
<B>cdr_okB> Verifies that there is a CDR ready for burning.
<B>burnB> Actually performs the burn of all the WAV files to the waiting CDR.
<B>-qB>, <B>--quitB> Aborts after one stage of processing. See <B>--stageB>.
<B>-t DIRB>, <B>--tempdir DIRB> Use a working directory other than "/tmp/mp3cd-<B>usernameB>". 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).
<B>-d PATHB>, <B>--device PATHB> Use a device path other than /dev/cdrecorder.
<B>-r TYPEB>, <B>--driver TYPEB> 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.
<B>-c ARGSB>, <B>--cdrdao ARGSB> Pass the given option string of ARGS to cdrdao during each command.
<B>-nB>, <B>--simulateB> Do not actually write to the disc but simulate the process instead.
<B>-EB>, <B>--no-ejectB> Don’t eject drive after the burn.
<B>-LB>, <B>--no-logB> 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.
<B>-TB>, <B>--no-cd-textB> Don’t attempt to write CD-TEXT tags to the audio CD. Some devices and drivers do not support this mode. See <B>--driverB> for more details.
<B>-S STAGESB>, <B>--skip STAGESB> 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 <B>--stageB> and <B>--quitB>.
<B>-VB>, <B>--versionB> Report which version of mp3cd this is.
<B>-vB>, <B>--verboseB> Shows commands as they are executed.
<B>-hB>, <B>--usageB> Show brief usage summary.
<B>--helpB> Show detailed help summary.
<B>--longhelpB> Shows the full command line instructions.


This script implements the suggested methods outlined in the Linux MP3 CD Burning mini-HOWTO:

This will burn a playlist (.m3u, XMLPlaylist or command line list) of MP3s, Oggs, FLACs, and/or WAVs to an audio CD. The .m3u format is really nothing more than a list of fully qualified filenames. The script handles making the WAVs sane by resampling if needed, and normalizing the volume across all tracks.

If a failure happens, earlier stages can be skipped with the ’-s’ flag. The file tool-output.txt in the temp directory can be examined to see what went wrong during the stage. Some things are time-consuming (like decoding the audio into WAVs) and if the CD burn fails, it’s much nicer not to have to start over from scratch. When doing this, you will not need the m3u file any more, since the files have already been built. See the list of stages using ’-h’.


Requires cdrdao, and that /dev/cdrecorder is a valid symlink to the /dev/sg device that cdrdao will use. Use .cdrdao to edit driver options. (See man cdrdao for details.)

Requires sox to decode MP3 and check/correct WAV formats.

Requires normalize to process the audio.

Optionally requires oggdec to decode Ogg to WAV files.

Optionally requires flac to decode flac to WAV files.

Optionally requires Config::Simple Perl module if you want to use the .mp3cdrc file.


<B>~/.mp3cdrcB> Default options can be recorded in this file. The option names are the same as their command line long-name. Command line options will override these values. All options are run through perl’s eval. For example:
tempdir: /scratch/mp3cd/$ENV{’USER’}
device: /dev/burner


 Kees Cook <>


 J. Katz (Ogg support)
 Alex Rhomberg (XMLPlaylist support)
 Kevin C. Krinke (filelist inspiration, and countless many patches)
 James Greenhalgh (flac support)


perl(1), cdrdao(1), sox(1), oggdec(1), flac(1), sox(1), normalize(1).


 Copyright (C) 2003-2011 Kees Cook,

 This program is free software; you can redistribute it and/or
 modify it under the terms of the GNU General Public License
 as published by the Free Software Foundation; either version 2
 of the License, or (at your option) any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

Search for    or go to Top of page |  Section 1 |  Main Index

perl v5.20.3 MP3CD (1) 2016-03-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.