SYNOPSIS

mp3roaster [\s-1OPTION\s0]... \*(C`MP3/OGG/FLAC/WAV files\*(C'

DESCRIPTION

mp3roaster A Perl hack for burning audio CDs out of \s-1MP3\s0, \s-1OGG\s0 \s-1VORBIS\s0 and \s-1FLAC\s0 files. The main highlights of this application are an easy to use command line syntax and automatic volume leveling support for best audio \s-1CD\s0 quality.

ENVIRONMENT

MP3Roaster should run on all Unix like operating systems which have Perl and wodim installed. It has been developed on Debian GNU/Linux.

OPTIONS

All options have been imported, now we should add specific descriptions for each option.

-D, --dev

\s-1CDR\s0 device to use

-s, --speed

Burn speed

-d, --dummy

Burn with laser off

-a, --dao

Burn in disk-at-once (\s-1DAO\s0) mode for gapless recording

-b, --burnfree

Turn on Buffer Underrun Free writing

-t, --temp

Temporary directory

-m, --mp3dec

\s-1MP3\s0 decoder to use

-l, --lowercase

Convert filenames to lowercase

-S, --spaces

Replace spaces with underscores

-B, --brackets

Replace brackets with underscores

-q, --quotes

Replace quotes with underscores

-Q, --questions

Replace questionmarks with underscores

-n, --normalize

Normalize \s-1WAV\s0 files before burning

-N, --no-normalize

Don't normalize \s-1WAV\s0 files, even if --normalize is specified (either as a command line argument or in the configuratino file)

-y, --no-confirm

Don't prompt for confirmation.

-w, --wodim-opts

Specify options to pass to Wodim for \s-1CD\s0 recording

-v, --verbose

Enable verbose output

-h, --help

Show the help screen

-V, --version

Show version and infos

RETURN VALUE

mp3roaster returns 0 on success, 1 on error.

DIAGNOSTICS

This has to be written yet.

EXAMPLES

Once correctly configured MP3Roaster is very easy to use, just launch it from the command line with a bunch of compressed audio files, here is a short example:

    % mp3roaster "Root Dance.mp3" Free\ Software.flac bar.ogg Decoded.wav

This will burn Root\ Dance.mp3, Free\ Software.flac bar.ogg and Decoded.wav on your audio \s-1CD\s0 preserving the song order as specified on the command line.

Here is another example showing the usage of command line options like the dummy option:

% mp3roaster -d "Root Dance.mp3" Free\ Software.flac bar.ogg Decoded.wav

This will do the same job as above but with the laser of your CD writer turned off, so no data will be really written.

You see MP3Roaster is really easy to use, this was one of my main goals while I've written the code: Keep it simple ;)

FILES

MP3Roaster can be configured through a system wide and a personal configuration file. When you run MP3Roaster it will first check for your personal configuration file in your home directory, if no one is found it will fall-back to the system wide configuration files placed in /etc.

By default MP3Roaster installs the configuration files in /etc/mp3roaster, but there are other possible file locations for the configuration file:

. System wide configuration in /etc

. /etc/mp3roaster/mp3roasterrc (DEFAULT) . /etc/mp3roasterrc

. Personal configuration in your home

. ~/.mp3roaster/mp3roasterrc . ~/.mp3roasterrc

So if you want to have personal MP3Roaster configuration file just copy the system wide configuration file to your home directory and edit it.

CAVEHEATS

None actually.

BUGS

There may be some minor troubles regarding file names, feel free to report any bugs you may encounter (In fact you shouldn't).

NOTES

There are currrently no special notes.

RELATED TO mp3roaster…

wodim.

AUTHOR

Ivo Marino <[email protected]>
Lorenzo Taylor <[email protected]>

HISTORY

Take a look at the ChangeLog for now.