--- mp3burn-0.4.2.orig/mp3burn.1 +++ mp3burn-0.4.2/mp3burn.1 @@ -0,0 +1,417 @@ +.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" Set up some character translations and predefined strings. \*(-- will +.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. ds R" '' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is turned on, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.ie \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. nr % 0 +. rr F +.\} +.el \{\ +. de IX +.. +.\} +.\" +.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). +.\" Fear. Run. Save yourself. No user-serviceable parts. +. \" fudge factors for nroff and troff +.if n \{\ +. ds #H 0 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ======================================================================== +.\" +.IX Title "MP3BURN 1" +.TH MP3BURN 1 "2010-10-25" "perl v5.10.1" "User Contributed Perl Documentation" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SH "NAME" +mp3burn \- burn audio CDs from MP3, Ogg Vorbis, or FLAC files +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +\&\fBmp3burn\fR [\s-1OPTION\s0] [mp3,ogg, and flac files] +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +\&\fBmp3burn\fR +is a simple command line tool for making audio CDs from +MP3s without filling up your disk with .wav files. It uses +\&\fIPerl\fR\|(1), \fIogg123\fR\|(1), \fImpg321\fR\|(1) or \fImpg123\fR\|(1), \fIcdrecord\fR\|(1), +\&\fIflac\fR\|(1), and the \fIMP3::Info\fR\|(3) Perl module. +.SH "OPTIONS" +.IX Header "OPTIONS" +.IP "\fB\-h, \-\-help\fR" 4 +.IX Item "-h, --help" +Prints out a brief help +.IP "\fB\-m, \-\-swap\fR" 4 +.IX Item "-m, --swap" +Manual \f(CW\*(C`cdrecord \-swab\*(C'\fR option mode. +Use this to disable the automatic detection for swab mode in case it is +not working correctly on your system. (Also, please send email to + or file a bug against the mp3burn package if you +encounter this problem.) +.ie n .IP "\fB\-p, \-\-playlist\fR "".m3u playlist""" 4 +.el .IP "\fB\-p, \-\-playlist\fR ``.m3u playlist''" 4 +.IX Item "-p, --playlist .m3u playlist" +Use a playlist to specify audio files to burn. +Instead of (or in addition to) listing mp3/ogg/flac files, +supply a .m3u playlist (e.g., from xmms) that contains the +audio files for your \s-1CD\s0. +.Sp +Note: If you specify both a playlist and audio files, the +files specified on the command-line will be appended to the list +of audio files listed in the playlist. If a file referenced +in a playlist cannot be read, it will be skipped. Be wary of +playlist editors that use relative paths \- mp3burn cannot know +what path the playlist editor assumed. +.ie n .IP "\fB\-t, \-\-tmpdir\fR ""tmpdir""" 4 +.el .IP "\fB\-t, \-\-tmpdir\fR ``tmpdir''" 4 +.IX Item "-t, --tmpdir tmpdir" +Put temporary files in \fItmpdir\fR. +Default is to use the current directory. +.ie n .IP "\fB\-c, \-\-check\fR ""\s-1MMM:SS\s0"" | \s-1ATIP\s0" 4 +.el .IP "\fB\-c, \-\-check\fR ``\s-1MMM:SS\s0'' | \s-1ATIP\s0" 4 +.IX Item "-c, --check MMM:SS | ATIP" +Time check: compute the total length of files to be burned +and warn if greater than \fI\s-1MMM:SS\s0\fR minutes and seconds. If +the value \s-1ATIP\s0 is supplied, the total length is checked +against the length available on the CDR[W] as reported by +\&\s-1ATIP\s0. +.Sp +Note that FLAC-encoded files are assumed to be 1 second long +(until there is an easy way to get the file duration). You +will need to calculate burn-length on your own with \s-1FLAC\s0 files. +.IP "\fB\-d, \-\-dummy\fR" 4 +.IX Item "-d, --dummy" +Perform a \*(L"dummy\*(R" run: do everything except actually burn the \s-1CD\s0 +(uses \fIcdrecord\fR\|(1) \f(CW\*(C`\-dummy\*(C'\fR option). +.ie n .IP "\fB\-o, \-\-cdrecord\fR ""cdrecord_opts""" 4 +.el .IP "\fB\-o, \-\-cdrecord\fR ``cdrecord_opts''" 4 +.IX Item "-o, --cdrecord cdrecord_opts" +Specify the command line options for cdrecord. +The quotes are required to prevent \fBmp3burn\fR from parsing \fIcdrecord\fR\|(1) options. +Overrides options specified in \fI~/.mp3burnrc\fR. +.Sp +Example: \fB\-o\fR \*(L"\-v dev=1,0 speed=4 \-swab\*(R" +.IP "\fBNote:\fR" 4 +.IX Item "Note:" +The options \fI\-pad\fR and \fI\-audio\fR are added automatically, since they are +always necessary. The script also tries to detect if \fI\-swab\fR is needed (for +example on x86 and other little-Endian platforms). cdrecord is supposed +to take care of any byte-ordering requirements specific to your burner. +(If you end up with a \s-1CD\s0 that merely sounds like static, you most likely +need to toggle use of \fI\-swab\fR.) You should also consider using \fI\-v\fR so +that you can watch the burn in progress. This goes for \fI~/.mp3burnrc\fR also. +.IP "\fB\-a, \-\-atip\fR" 4 +.IX Item "-a, --atip" +Lookup the \s-1ATIP\s0 info for the device in the cdburner +(using \fIcdrecord\fR\|(1) \f(CW\*(C`\-atip\*(C'\fR) and then exits. This +option can only be used (successfully) in conjuction with \fB\-o\fR. +.ie n .IP "\fB\-M, \-\-encoder\fR ""\s-1MP3\s0 decoder""" 4 +.el .IP "\fB\-M, \-\-encoder\fR ``\s-1MP3\s0 decoder''" 4 +.IX Item "-M, --encoder MP3 decoder" +Use an \s-1MP3\s0 decoder other than the default, which is mpg321. This is +imperative when burning tracks that have sample rates other than 44.1kHz, +and the current version of mpg321 will not decode these files. Specify +the name of the decoder to be used, e.g. \fImpg123\-oss\-3dnow\fR; you can +also specify this in your .mp3burnrc file with \fB\f(CB$mp3decoder\fB +=\fR \fImp3decoder\fR. \fI(Note: Currently, the \s-1MP3\s0 decoder must be +able to accept mpg123\-style command-line arguments.)\fR +.SH "RETURN VALUE" +.IX Header "RETURN VALUE" +\&\fBmp3burn\fR returns 0 on success. +.SH "DIAGNOSTICS" +.IX Header "DIAGNOSTICS" +.IP "Error in .mp3burnrc:" 4 +.IX Item "Error in .mp3burnrc:" +\&\fIPerl\fR\|(1) cannot parse the \fI.mp3burnrc\fR file. +The following example occurs when a double quote is not terminated: +.Sp +.Vb 6 +\& bash\-2.05$ sudo mp3burn \-d ~/bell.ogg +\& String found where operator expected at (eval 10) line 7, at end of line +\& (Missing operator before ?) +\& Error in .mp3burnrc: +\& Can\*(Aqt find string terminator \*(Aq"\*(Aq anywhere before EOF at (eval 10) line 7. +\& bash\-2.05$ +.Ve +.Sp +You will experience this error if you define both \f(CW$cdrecord_opts\fR and +\&\f(CW$mp3decoder\fR without terminating the variable assignments with the ';' +character: +.Sp +.Vb 8 +\& $ mp3burn \-d \-t /tmp Theodor_Storm_Aquis_submersus_1.mp3 +\& Scalar found where operator expected at (eval 10) line 2, near ""\-v speed=2 dev=0,3,0" +\& $mp3decoder" +\& (Missing operator before +\& $mp3decoder?) +\& Error in .mp3burnrc: +\& syntax error at (eval 10) line 2, near ""\-v speed=2 dev=0,3,0" +\& $mp3decoder" +.Ve +.SH "EXAMPLES" +.IX Header "EXAMPLES" +Write an Ogg Vorbis file from a CD-R drive, \fI/dev/scd0\fR, +mounted at \fI/mnt/scd0/\fR to a +CD-RW drive, \fI/dev/scd1\fR, called \f(CW\*(C`0,1,0\*(C'\fR in \fIcdrecord\fR\|(1) \s-1SCSI\s0 notation. +Ensure that file is no longer than 50 minutes. +\&\fIsudo\fR\|(1) is used to get root permissions for \fIcdrecord\fR\|(1). +.PP +.Vb 1 +\& % sudo mp3burn \-c 050:00 \-o "\-v speed=2 dev=0,1,0" /mnt/scd0/bell.ogg +.Ve +.PP +Create a \fI~/.mp3burnrc\fR that prints a message before writing and uses +a different \s-1MP3\s0 decoder than the default of mpg321. +.PP +.Vb 3 +\& # This is an example. +\& $cdrecord_opts="\-v speed=2 dev=0,1,0"; +\& $mp3decoder = "mpg123\-oss\-3dnow"; +\& +\& print "Nine seconds to slap a CD\-R in the drive!\en" ; +\& +\& # +\& # See mp3burn(3). +\& # +.Ve +.PP +Specify an mp3decoder other than mpg321. +.PP +.Vb 1 +\& $ sudo mp3burn \-M mpg123\-esd ./rush/*mp3 +.Ve +.SH "FILES" +.IX Header "FILES" +.IP "\fI~/.mp3burnrc\fR" 4 +.IX Item "~/.mp3burnrc" +In this file, you may permanently specify the cdrecord options and +\&\s-1MP3\s0 decoder you want to use. The format is: +.Sp +.Vb 2 +\& $cdrecord_opts = "cdrecord options"; +\& $mp3decoder = "some mp3 decoder"; +.Ve +.Sp +You may place comments in this file by beginning a line with \f(CW\*(C`#\*(C'\fR. +.IP "\fBNote:\fR" 4 +.IX Item "Note:" +The values of \f(CW$cdrecord_opts\fR and \f(CW$mp3decoder\fR in \fI~/.mp3burnrc\fR are ignored +if the \f(CW\*(C`\-o\*(C'\fR or \f(CW\*(C`\-<\*(C'\fRcommand-line options are used, respectively. +.SH "CAVEATS" +.IX Header "CAVEATS" +Has not been tested extensively with Ogg Vorbis files. +Ogg Vorbis files must be in CD-DA format: +i.e. 44100 samples/channel x 16 bits/sample x 2 channels. +.SH "BUGS" +.IX Header "BUGS" +If you execute \fBmp3burn\fR with root permissions, +the \fI~/.mp3burnrc\fR will also be executed with root permissions. +.SH "NOTES" +.IX Header "NOTES" +There are a number of \s-1GUI\s0 frontends for \fBmp3burn\fR: +.IP "Xmp3Burn" 4 +.IX Item "Xmp3Burn" +http://perso.wanadoo.es/ja_recio/xmp3burn/xmp3burn.html +.IP "Kmp3burn" 4 +.IX Item "Kmp3burn" +http://computer.freepage.de/kmp3burn/index.htm +.IP "GtkMp3Burn" 4 +.IX Item "GtkMp3Burn" +http://gtkmp3burn.sourceforge.net/ +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIcdrecord\fR\|(1), \fImpg321\fR\|(1), \fIogg123\fR\|(1), \fIogginfo\fR\|(1), \fIflac\fR\|(1), \fIMP3::Info\fR\|(3) +The \fBmp3burn\fR web page is http://mp3burn.sourceforge.net/. +The Ogg Vorbis web page is http://www.xiph.org/ogg/vorbis/. +The \s-1FLAC\s0 web page is http://flac.sourceforge.net/. +.SH "AUTHOR" +.IX Header "AUTHOR" +Copyright (c) 2000 Ryan Richter. +Copyright (c) 2003 Alexander Wirt +.PP +This script was written by Ryan Richter with much code +contributed by Dan Lark . +.PP +I would like to thank Dan Lark for +contributing the ideas and code for most of the new features, +and Tony Mancill for making Debian packages +and helping with debugging. +.PP +Later in 2003 Alexander Wirt continued to write this program. +.PP +This program is licensed under the \s-1GNU\s0 General Public License. +You may fold, spindle, and mutilate this software under the terms of the \s-1GPL\s0. +.SH "HISTORY" +.IX Header "HISTORY" +.IP "20031014 " 4 +.IX Item "20031014 " +Switches from standard getopt to GetOpts::Long +.Sp +Updated Manpage for the new option format +.IP "20031012 " 4 +.IX Item "20031012 " +Updated mp3burn to use pod2usage +.Sp +Added \-h switch for getting help +.Sp +Fixed a bug with the output of file in conduction with \s-1FLAC\s0 files +.Sp +Added a gracefully exit if there are no valid files left +.Sp +Use String::Shellquote to avoid problems with the shell +.IP "20030203 " 4 +.IX Item "20030203 " +hacked in support for \s-1FLAC\s0, as per suggested by +.IP "20021110 " 4 +.IX Item "20021110 " +updated to work with new ogginfo output format in vorbis-tools 1.0; +modified slightly to not create FIFOs for invalid \s-1MP3/OGG\s0 files +.IP "20020728 " 4 +.IX Item "20020728 " +added \fI\-M \f(CI$mp3decoder\fI\fR switch to support \s-1MP3\s0 decoders other than +mpg321 and mpg123\-oss +.IP "20010917 " 4 +.IX Item "20010917 " +added check to automatically add \-swab on ia32 platform +.Sp +\&\fIMP3::Info\fR\|(3) replaces MPEG::MP3Info +.IP "\fBmp3burn\fR 0.02 10/28/00" 4 +.IX Item "mp3burn 0.02 10/28/00" +Changes since 0.01: +.Sp +Bugfixes: +.Sp +Spaces, quotes, and other shell metacharacters in filenames +should no longer problematic, since we use Shell:QuoteString +to avoid problems with that (Feedback for that is wished). +.Sp +Mono MP3s and MP3s not sampled at 44.1kHz are no longer +problematic. +.Sp +New Features: +.Sp +Editing the executable is no longer necessary; cdrecord +options can be specified on the command line or in \fI~/.mp3burnrc\fR. +.Sp +Temp dir for FIFOs may be set to other than the current dir. +.Sp +Dummy runs now supported from the command line. +.Sp +A time check is now available: \fBmp3burn\fR can abort if total +time exceeds a threshold. Requires MPEG::MP3Info. +.Sp +Playlist support. +.SH "POD ERRORS" +.IX Header "POD ERRORS" +Hey! \fBThe above document had some coding errors, which are explained below:\fR +.IP "Around line 583:" 4 +.IX Item "Around line 583:" +You forgot a '=back' before '=head1' +.IP "Around line 589:" 4 +.IX Item "Around line 589:" +\&'=item' outside of any '=over' --- mp3burn-0.4.2.orig/mp3burn.html +++ mp3burn-0.4.2/mp3burn.html @@ -0,0 +1,420 @@ + + + + +mp3burn - burn audio CDs from MP3, Ogg Vorbis, or FLAC files + + + + + + +

+ + + + + +
+

+

+

NAME

+

mp3burn - burn audio CDs from MP3, Ogg Vorbis, or FLAC files

+

+

+
+

SYNOPSIS

+

mp3burn [OPTION] [mp3,ogg, and flac files]

+

+

+
+

DESCRIPTION

+

mp3burn +is a simple command line tool for making audio CDs from +MP3s without filling up your disk with .wav files. It uses +Perl(1), ogg123(1), mpg321(1) or mpg123(1), cdrecord(1), +flac(1), and the the MP3::Info(3) manpage Perl module.

+

+

+
+

OPTIONS

+
+
-h, --help + +
+

Prints out a brief help

+
+ +
-m, --swap + +
+

Manual cdrecord -swab option mode. +Use this to disable the automatic detection for swab mode in case it is +not working correctly on your system. (Also, please send email to +<formorer@formorer.de> or file a bug against the mp3burn package if you +encounter this problem.)

+
+ +
-p, --playlist ``.m3u playlist'' + +
+

Use a playlist to specify audio files to burn. +Instead of (or in addition to) listing mp3/ogg/flac files, +supply a .m3u playlist (e.g., from xmms) that contains the +audio files for your CD.

+
+
+

Note: If you specify both a playlist and audio files, the +files specified on the command-line will be appended to the list +of audio files listed in the playlist. If a file referenced +in a playlist cannot be read, it will be skipped. Be wary of +playlist editors that use relative paths - mp3burn cannot know +what path the playlist editor assumed. +

+
+
+
+
+=cut
+
+ +
-t, --tmpdir ``tmpdir'' + +
+

Put temporary files in tmpdir. +Default is to use the current directory.

+
+ +
-c, --check ``MMM:SS'' | ATIP + +
+

Time check: compute the total length of files to be burned +and warn if greater than MMM:SS minutes and seconds. If +the value ATIP is supplied, the total length is checked +against the length available on the CDR[W] as reported by +ATIP.

+
+
+

Note that FLAC-encoded files are assumed to be 1 second long +(until there is an easy way to get the file duration). You +will need to calculate burn-length on your own with FLAC files.

+
+ +
-d, --dummy + +
+

Perform a ``dummy'' run: do everything except actually burn the CD +(uses cdrecord(1) -dummy option).

+
+ +
-o, --cdrecord ``cdrecord_opts'' + +
+

Specify the command line options for cdrecord. +The quotes are required to prevent mp3burn from parsing cdrecord(1) options. +Overrides options specified in ~/.mp3burnrc.

+
+
+

Example: -o ``-v dev=1,0 speed=4 -swab''

+
+ +
Note: + +
+

The options -pad and -audio are added automatically, since they are +always necessary. The script also tries to detect if -swab is needed (for +example on x86 and other little-Endian platforms). cdrecord is supposed +to take care of any byte-ordering requirements specific to your burner. +(If you end up with a CD that merely sounds like static, you most likely +need to toggle use of -swab.) You should also consider using -v so +that you can watch the burn in progress. This goes for ~/.mp3burnrc also.

+
+ +
-a, --atip + +
+

Lookup the ATIP info for the device in the cdburner +(using cdrecord(1) -atip) and then exits. This +option can only be used (successfully) in conjuction with -o.

+
+ +
-M, --encoder ``MP3 decoder'' + +
+

Use an MP3 decoder other than the default, which is mpg321. This is +imperative when burning tracks that have sample rates other than 44.1kHz, +and the current version of mpg321 will not decode these files. Specify +the name of the decoder to be used, e.g. mpg123-oss-3dnow; you can +also specify this in your .mp3burnrc file with $mp3decoder += mp3decoder. (Note: Currently, the MP3 decoder must be +able to accept mpg123-style command-line arguments.)

+
+ +
+

+

+
+

RETURN VALUE

+

mp3burn returns 0 on success.

+

+

+
+

DIAGNOSTICS

+
+
Error in .mp3burnrc: + +
+

Perl(1) cannot parse the .mp3burnrc file. +The following example occurs when a double quote is not terminated:

+
+
+
+  bash-2.05$ sudo mp3burn -d ~/bell.ogg 
+  String found where operator expected at (eval 10) line 7, at end of line
+          (Missing operator before ?)
+  Error in .mp3burnrc:
+  Can't find string terminator '"' anywhere before EOF at (eval 10) line 7.
+  bash-2.05$ 
+  
+You will experience this error if you define both $cdrecord_opts and
+$mp3decoder without terminating the variable assignments with the ';' 
+character:
+
+
+
+  $ mp3burn -d -t /tmp Theodor_Storm_Aquis_submersus_1.mp3 
+  Scalar found where operator expected at (eval 10) line 2, near ""-v speed=2 dev=0,3,0"
+  $mp3decoder"
+        (Missing operator before 
+  $mp3decoder?)
+  Error in .mp3burnrc:
+  syntax error at (eval 10) line 2, near ""-v speed=2 dev=0,3,0"
+  $mp3decoder"
+
+ +
+

+

+
+

EXAMPLES

+

Write an Ogg Vorbis file from a CD-R drive, /dev/scd0, +mounted at /mnt/scd0/ to a +CD-RW drive, /dev/scd1, called 0,1,0 in cdrecord(1) SCSI notation. +Ensure that file is no longer than 50 minutes. +sudo(1) is used to get root permissions for cdrecord(1).

+
+  % sudo mp3burn -c 050:00 -o "-v speed=2 dev=0,1,0" /mnt/scd0/bell.ogg
+

Create a ~/.mp3burnrc that prints a message before writing and uses +a different MP3 decoder than the default of mpg321.

+
+  # This is an example.
+  $cdrecord_opts="-v speed=2 dev=0,1,0";
+  $mp3decoder = "mpg123-oss-3dnow";
+
+  print "Nine seconds to slap a CD-R in the drive!\n" ;
+
+  #
+  # See mp3burn(3).
+  #
+

Specify an mp3decoder other than mpg321.

+
+  $ sudo mp3burn -M mpg123-esd ./rush/*mp3
+  
+=head1 FILES
+
+
~/.mp3burnrc + +
+

In this file, you may permanently specify the cdrecord options and +MP3 decoder you want to use. The format is:

+
+
+
+  $cdrecord_opts = "cdrecord options";
+  $mp3decoder = "some mp3 decoder";
+
+
+

You may place comments in this file by beginning a line with #.

+
+ +
Note: + +
+

The values of $cdrecord_opts and $mp3decoder in ~/.mp3burnrc are ignored +if the -o or -<command-line options are used, respectively.

+
+ +
+

+

+
+

CAVEATS

+

Has not been tested extensively with Ogg Vorbis files. +Ogg Vorbis files must be in CD-DA format: +i.e. 44100 samples/channel x 16 bits/sample x 2 channels.

+

+

+
+

BUGS

+

If you execute mp3burn with root permissions, +the ~/.mp3burnrc will also be executed with root permissions.

+

+

+
+

NOTES

+

There are a number of GUI frontends for mp3burn:

+
+
Xmp3Burn + +
+
+
+http://perso.wanadoo.es/ja_recio/xmp3burn/xmp3burn.html
+
+
Kmp3burn + +
+

http://computer.freepage.de/kmp3burn/index.htm

+
+ +
GtkMp3Burn + +
+

http://gtkmp3burn.sourceforge.net/

+
+ +
+

+

+
+

SEE ALSO

+

cdrecord(1), mpg321(1), ogg123(1), ogginfo(1), flac(1), the MP3::Info(3) manpage +The mp3burn web page is http://mp3burn.sourceforge.net/. +The Ogg Vorbis web page is http://www.xiph.org/ogg/vorbis/. +The FLAC web page is http://flac.sourceforge.net/.

+

+

+
+

AUTHOR

+

Copyright (c) 2000 Ryan Richter. +Copyright (c) 2003 Alexander Wirt

+

This script was written by Ryan Richter <bobort@bigfoot.com> with much code +contributed by Dan Lark <dlark@spinn.net>.

+

I would like to thank Dan Lark <dlark@spinn.net> for +contributing the ideas and code for most of the new features, +and Tony Mancill <tony@mancill.com> for making Debian packages +and helping with debugging.

+

Later in 2003 Alexander Wirt continued to write this program.

+

This program is licensed under the GNU General Public License. +You may fold, spindle, and mutilate this software under the terms of the GPL.

+

+

+
+

HISTORY

+
    +
  1. <formorer@formorer.de> + +

    Switches from standard getopt to GetOpts::Long

    +

    Updated Manpage for the new option format

    +
    2. +
  2. <formorer@formorer.de> + +

    Updated mp3burn to use pod2usage

    +

    Added -h switch for getting help

    +

    Fixed a bug with the output of file in conduction with FLAC files

    +

    Added a gracefully exit if there are no valid files left

    +

    Use String::Shellquote to avoid problems with the shell

    +
    3. +
  3. <tmancill@debian.org> + +

    hacked in support for FLAC, as per suggested by <ldm@apartia.org>

    +
    4. +
  4. <tmancill@debian.org> + +

    updated to work with new ogginfo output format in vorbis-tools 1.0; +modified slightly to not create FIFOs for invalid MP3/OGG files

    +
    5. +
  5. <tmancill@debian.org> + +

    added -M $mp3decoder switch to support MP3 decoders other than +mpg321 and mpg123-oss

    +
    6. +
  6. <tmancill@debian.org> + +

    added check to automatically add -swab on ia32 platform

    +

    the MP3::Info(3) manpage replaces MPEG::MP3Info

    +
    7. +
    mp3burn 0.02 10/28/00 + +
    +

    Changes since 0.01:

    +
    +
    +

    Bugfixes:

    +
    +
    +

    Spaces, quotes, and other shell metacharacters in filenames +should no longer problematic, since we use Shell:QuoteString +to avoid problems with that (Feedback for that is wished). + +

    +
    +
    +

    Mono MP3s and MP3s not sampled at 44.1kHz are no longer +problematic. + +

    +
    +
    +

    New Features: + +

    +
    +
    +

    Editing the executable is no longer necessary; cdrecord +options can be specified on the command line or in ~/.mp3burnrc. + +

    +
    +
    +

    Temp dir for FIFOs may be set to other than the current dir. + +

    +
    +
    +

    Dummy runs now supported from the command line. + +

    +
    +
    +

    A time check is now available: mp3burn can abort if total +time exceeds a threshold. Requires the MPEG::MP3Info manpage. + +

    +
    +
    +

    Playlist support. + +

    +
    + +
+ + + + --- mp3burn-0.4.2.orig/Makefile +++ mp3burn-0.4.2/Makefile @@ -1,3 +1,3 @@ -%.1: % ; pod2man $< >$@ +%.1: % ; pod2man --center $< $< >$@ all: mp3burn.1 --- mp3burn-0.4.2.orig/mp3burn +++ mp3burn-0.4.2/mp3burn @@ -134,8 +134,8 @@ $atipoptions = $cdrecord_opts; $atipoptions =~ s/-eject//; - if ($DEBUG) { print "Call cdrecord with: cdrecord -atip $atipoptions. \n"; } - open(CDINFO,"cdrecord -atip $atipoptions 2>&1 |"); #Use cdrecord -atip to get ATIP info + if ($DEBUG) { print "Call wodim with: wodim -atip $atipoptions. \n"; } + open(CDINFO,"wodim -atip $atipoptions 2>&1 |"); #Use cdrecord -atip to get ATIP info while () { if (/cdrecord: No CD\/DVD-Recorder device specified/) { print "No CDR device specified. It must be specified via on of the following:\n"; @@ -559,7 +559,7 @@ # prepare the command line # We use now the shellquote module for escaping the filenames -$cdrecordcmd = "cdrecord " . join (" ", split(/\s+/, $cdrecord_opts)) . " " . shell_quote @fifo; +$cdrecordcmd = "wodim " . join (" ", split(/\s+/, $cdrecord_opts)) . " " . shell_quote @fifo; if ($DEBUG) { print "invoking cdrecord with:\n"; --- mp3burn-0.4.2.orig/debian/compat +++ mp3burn-0.4.2/debian/compat @@ -0,0 +1 @@ +5 --- mp3burn-0.4.2.orig/debian/changelog +++ mp3burn-0.4.2/debian/changelog @@ -0,0 +1,192 @@ +mp3burn (0.4.2-2) unstable; urgency=low + + * Remove dependency on cdrecord (Closes: #405644) + * Really use wodim instead of cdrecord + * Bump standards version + * Update copyright + * Add ${misc:Depends} to binary deps + + -- Alexander Wirt Mon, 25 Oct 2010 09:05:07 +0200 + +mp3burn (0.4.2-1) unstable; urgency=low + + * New upstream release + - Fix swap detection (Closes: #450865, #289822, #450865) + * Add dependency on cdrecord dummy package (Closes: #501388) + * Bump standards version (no changes) + + -- Alexander Wirt Tue, 14 Oct 2008 07:56:06 +0200 + +mp3burn (0.4.1-3) unstable; urgency=low + + * Replace cdrecord with wodim (Closes: #405644) + * Move dh compat to debian/compat + + -- Alexander Wirt Thu, 25 Oct 2007 16:41:45 +0200 + +mp3burn (0.4.1-2) unstable; urgency=low + + * Add swab support for ppc + * Bumped standards version + * Updated debhelper compat version + + -- Alexander Wirt Sun, 24 Sep 2006 11:44:55 +0200 + +mp3burn (0.4.1-1) unstable; urgency=low + + * New upstream release + - Detects swab on x86_64 correctly + + -- Alexander Wirt Wed, 9 Feb 2005 22:15:37 +0100 + +mp3burn (0.4.0-1) unstable; urgency=low + + * New upstream release + - Don't longer uses ogginfo directly (Closes: #250834) + - Fixed the detection of the mp3 decoder (Closes: #252434) + + -- Alexander Wirt Sun, 18 Jul 2004 15:58:00 +0200 + +mp3burn (0.3.3-1) unstable; urgency=low + + * New upstream release + - Fixed detection of the flac decoder (Closes: #246279) + + -- Alexander Wirt Wed, 28 Apr 2004 10:34:06 +0200 + +mp3burn (0.3.2-1) unstable; urgency=low + + * New upstream release + + -- Alexander Wirt Wed, 14 Apr 2004 14:09:53 +0200 + +mp3burn (0.3.1-2) unstable; urgency=low + + * Fixed manpage (closes #222393) + + -- Alexander Wirt Fri, 2 Jan 2004 10:35:38 +0100 + +mp3burn (0.3.1-1) unstable; urgency=low + + * New upstream release (fixed swap detection) + * Updated Standardsversion + + -- Alexander Wirt Sun, 16 Nov 2003 21:59:10 +0100 + +mp3burn (0.3-1) unstable; urgency=low + + * New upstream release + + -- Alexander Wirt Fri, 14 Nov 2003 23:44:21 +0100 + +mp3burn (0.02-15) unstable; urgency=low + + * switches from standard getopt to GetOpts::Long + * updated Manpage for the new option format + * Changed Maintainerfield + + -- Alexander Wirt Fri, 14 Nov 2003 16:13:47 +0100 + +mp3burn (0.02-14) unstable; urgency=low + + * New Maintainer (closes: #202329) + * mp3burn now uses pod2usage for generating help output + * added -h switch for help + * Updated manpage + * Removed flac dependency and add flac check + * Exit gracefully if there are no valid files to burn + * Use Shell::StringQuote to avoid problems with spaces and metacharacters in + filenames. + + -- Alexander Wirt Sun, 12 Oct 2003 19:02:55 +0200 + +mp3burn (0.02-13) unstable; urgency=low + + * command-line arguments summary (thx to Kevin C. Krinke for the patch) + * orphaned; maintainer set to packages@qa.debian.org + + -- tony mancill Mon, 21 Jul 2003 16:11:02 -0700 + +mp3burn (0.02-12) unstable; urgency=low + + * added ATIP support from upstream's mp3burn-0.1 package + + -- tony mancill Tue, 11 Feb 2003 19:27:29 -0800 + +mp3burn (0.02-11) unstable; urgency=low + + * playlist support (thanks to for the patch) + + -- tony mancill Thu, 6 Feb 2003 20:37:13 -0800 + +mp3burn (0.02-10) unstable; urgency=low + + * initial support for FLAC audio files (closes: #173349) + + -- tony mancill Mon, 03 Feb 2003 21:52:55 -0800 + +mp3burn (0.02-9) unstable; urgency=low + + * now handles vorbis-tools 1.0 ogginfo output (closes: #163451) + * slight tweaks to handle non-audio files + + -- tony mancill Sun, 10 Nov 2002 21:41:52 -0800 + +mp3burn (0.02-8) unstable; urgency=low + + * -M or $mp3decoder in .mp3burnrc will now override + mpg321 as the MP3 decoder; mpg123-oss is no longer used automatically + if present (closes: #150903) + * slight tweak to manpage formatting (closes: #154407) + + -- tony mancill Sun, 28 Jul 2002 11:37:17 -0700 + +mp3burn (0.02-7) unstable; urgency=low + + * prints error on MP3s <> 44.1kHz when using mpg321 (closes: #118545) + * uses mpg123 if it is installed (as per multiple user complaints) + + -- tony mancill Mon, 21 Jan 2002 23:40:52 -0800 + +mp3burn (0.02-6) unstable; urgency=low + + * applied Vorbis Ogg support + manpage patch (closes: #116959) + * now quote fifos to prevent shell expansion/confusion (closes: #116007) + + -- tony mancill Thu, 25 Oct 2001 13:36:56 -0700 + +mp3burn (0.02-5) unstable; urgency=low + + * added code to set -swab for cdrecord when needed (closes: #111275) + * added the -m option (for overriding the auto -swab code) + * added dependency on version of mpg321 that can handle mono files + + -- tony mancill Tue, 18 Sep 2001 23:54:11 -0700 + +mp3burn (0.02-4) unstable; urgency=low + + * package moved to main (now depends on mpg321) - closes: #90084 + * changed dependency from libmpeg-mp3info-perl to libmp3-info-perl + * minor hack (padded time output) + + -- tony mancill Sun, 1 Jul 2001 22:07:20 -0700 + +mp3burn (0.02-3) unstable; urgency=low + + * Closes: #79182 get_mp3info Perl problem + * added info to README/manpage about -swab on little-Endian systems + + -- tony mancill Sun, 10 Dec 2000 15:50:32 -0700 + +mp3burn (0.02-2) unstable; urgency=low + + * set section to "contrib/sound" due to dependency on mpg123 + + -- tony mancill Sun, 26 Nov 2000 19:56:44 -0700 + +mp3burn (0.02-1) unstable; urgency=low + + * Initial Release. + + -- tony mancill Mon, 20 Nov 2000 23:12:00 -0700 + --- mp3burn-0.4.2.orig/debian/dirs +++ mp3burn-0.4.2/debian/dirs @@ -0,0 +1 @@ +usr/bin --- mp3burn-0.4.2.orig/debian/docs +++ mp3burn-0.4.2/debian/docs @@ -0,0 +1 @@ +README --- mp3burn-0.4.2.orig/debian/rules +++ mp3burn-0.4.2/debian/rules @@ -0,0 +1,78 @@ +#!/usr/bin/make -f +# Sample debian/rules that uses debhelper. +# GNU copyright 1997 to 1999 by Joey Hess. +# +# modified for mp3burn package by + +# Uncomment this to turn on verbose mode. +#export DH_VERBOSE=1 + + +configure: + dh_testdir + touch configure-stamp + +build: configure + dh_testdir + $(MAKE) + +clean: + dh_testdir + dh_testroot + rm -f build-stamp configure-stamp + + # Add here commands to clean up after the build process. + #-$(MAKE) clean + + dh_clean + +install: build + dh_testdir + dh_testroot + dh_clean -k + dh_installdirs + + # Add here commands to install the package into debian/tmp. + #$(MAKE) install DESTDIR=`pwd`/debian/mp3burn + cp -p mp3burn `pwd`/debian/mp3burn/usr/bin + + # create manpage + pod2man mp3burn mp3burn.1 + +# Build architecture-independent files here. +binary-indep: build install +# dh_testversion + dh_testdir + dh_testroot +# dh_installdebconf + dh_installdocs + dh_installexamples +# dh_installmenu +# dh_installemacsen +# dh_installpam +# dh_installinit +# dh_installcron + dh_installman mp3burn.1 +# dh_installinfo +# dh_undocumented + dh_installchangelogs Changelog + dh_link +# dh_strip + dh_compress + dh_fixperms + # You may want to make some executables suid here. +# dh_suidregister +# dh_makeshlibs + dh_installdeb + dh_perl +# dh_shlibdeps + dh_gencontrol + dh_md5sums + dh_builddeb + +# Build architecture-dependent files here. +binary-arch: build install +# We have nothing to do for arch "all" package + +binary: binary-indep binary-arch +.PHONY: build clean binary-indep binary-arch binary install configure --- mp3burn-0.4.2.orig/debian/copyright +++ mp3burn-0.4.2/debian/copyright @@ -0,0 +1,22 @@ +This package was debianized by tony mancill on +Mon, 20 Nov 2000 23:12:00 -0700. + +Later (Sun, 14 Okt 2003) Alexander Wirt gets new +maintainer of this package. + +It can be downloaded from + +Copyright holders and authors: + © -2003 Ryan Richter + © 2003-2010 Alexander Wirt + +Copyright: GPL + file:///usr/share/common-licenses/GPL + +Additonal Informations: + +Since it seems that development of mp3burn is dead and Tony Mancill and I +did some improvements of the program, I will become new upstream unless +the original author screams. Source packages of this package could then +be available at http://www.formorer.de/code/mp3burn/. + --- mp3burn-0.4.2.orig/debian/README.Debian +++ mp3burn-0.4.2/debian/README.Debian @@ -0,0 +1,63 @@ +mp3burn for Debian +------------------ + +mp3burn is really a very simple script, but it's handy enough that I +thought it should be available as a package. + +The script differs from the upstream version in a couple of ways: + + * it has support for .m3u playlist files + + * it has support for FLAC files + + * it tries to detect invalid/non-present MP3 and OGG files *before* + burning two seconds of silence to your CD-R... :) + + * it uses mpg321 by default for mp3s instead of mpg123 (because + mpg123 is non-free). Because mpg321 cannot handle sample rates + other than 44.1kHz, an option -M has been added. + + * it can use ogg123 for Ogg Vorbis files + (thanks to Peter Muir for the excellent patch) + Note that OGG files with sample rates other than 44.1kHz will + sound slow/fast (normally 2x fast). There's not much to do about + this until ogginfo supports more options. + + * it tries to detect if "-swab" is needed and add it automatically + (use -m to override this functionality, and please send me email + so that I can update the script for platforms other than x86) + +You can set cdrecord parameters via the the ~/.mp3burnrc file or pass +parameters to cdrecord via the command line (-o). You may also set +the value of $mp3decoder (instead of using -M on the command line) to +use a decoder other than mpg321. The format for the .mp3burnrc file is +simply any valid Perl: + +# comments allowed +$cdrecord_opts = "dev=0,3,0 speed=2 -v -swab"; +# let's use a different mp3decoder because mpg321 can't handle sample +# rates other than 44.1kHz. There is no need for the full path because +# mp3burn will `which $mp3decoder` before invoking it +$mp3decoder = "mpg123-oss"; + +Alternately, you can put info about your CDR[W] in /etc/cdrecord.conf +(which used to be /etc/default/cdrecord). See the file and cdrecord +documentation for the syntax for that file. + +Finally, you should consider running this program as root, since +cdrecord really likes to be run as root, and the default Debian +install of cdrecord will not be setuid. If you get a screen full +of messages from cdrecord, this is probably the problem. + +*** IMPORTANT *** +mp3burn will hang with older versions of mpg321 (specifically, +versions < 0.1.5.2) if you try to burn an mp3 that is mono encoded. +If you're backporting this script to an older system and don't +want to also backport mpg321, you can install and use mpg123 +(if you don't mind installing non-free software). + +Finally, I am aware that mp3burn-0.1 is out (actually, has been out for +a while). I'll be merging the new features from that release into this +package soon. + + -- tony mancill - Sun, 10 Nov 2002 21:49:18 -0800 --- mp3burn-0.4.2.orig/debian/TODO +++ mp3burn-0.4.2/debian/TODO @@ -0,0 +1,11 @@ +-----TODO for mp3burn----- + +Since upstream seems to be dead, I want +to add some functions on my own. If you +want to see something in mp3burn, drop me +a mail to formorer@formorer.de. + +- Add support for sorting files after the + Tracknumbertag. +- Use internal Perl Modules for getting informations about oggfiles. +- Write a perl Perl Module for working with flac files (if I have too much time :)) --- mp3burn-0.4.2.orig/debian/control +++ mp3burn-0.4.2/debian/control @@ -0,0 +1,17 @@ +Source: mp3burn +Section: sound +Priority: extra +Maintainer: Alexander Wirt +Build-Depends: debhelper (>= 5) +Standards-Version: 3.9.1 + +Package: mp3burn +Architecture: all +Depends: ${perl:Depends}, mpg321 (>= 0.1.5.2) | mpg123, wodim, libmp3-info-perl, vorbis-tools (>= 1.0), file, libstring-shellquote-perl, libogg-vorbis-header-perl, ${misc:Depends} +Suggests: flac, libaudio-flac-perl +Description: burn audio CDs directly from MP3, Ogg Vorbis, or FLAC files + mp3burn is a Perl script that allows you to burn audio CDs composed + of MP3, Ogg Vorbis, or FLAC tracks without an intermediate file conversion + to .cdr or .wav. + The .mp3/.ogg/.flac files *are* converted using a decoder, but are + written to FIFOs so they don't consume filesystem space during the burn.