From murray@builder.freebsdmall.com  Sun Apr 20 18:58:42 2003
Return-Path: <murray@builder.freebsdmall.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id A98E537B404
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 20 Apr 2003 18:58:42 -0700 (PDT)
Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E140943FEA
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 20 Apr 2003 18:58:41 -0700 (PDT)
	(envelope-from murray@builder.freebsdmall.com)
Received: by builder.freebsdmall.com (Postfix, from userid 2074)
	id 617BF1489; Sun, 20 Apr 2003 18:58:41 -0700 (PDT)
Message-Id: <20030421015841.617BF1489@builder.freebsdmall.com>
Date: Sun, 20 Apr 2003 18:58:41 -0700 (PDT)
From: murray@FreeBSD.org
Reply-To: murray@FreeBSD.org
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Improvements to burncd section of Handbook (12.5.3)
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         51203
>Category:       docs
>Synopsis:       Improvements to burncd section of Handbook (12.5.3)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    murray
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Apr 20 19:00:22 PDT 2003
>Closed-Date:    Sun May 04 21:48:20 PDT 2003
>Last-Modified:  Sun May 04 21:48:20 PDT 2003
>Originator:     
>Release:        FreeBSD 5.0-RC i386
>Organization:
FreeBSD Mall, Inc.
>Environment:
System: FreeBSD builder.freebsdmall.com 5.0-RC FreeBSD 5.0-RC #21: Sat Dec 7 19:41:45 PST 2002 murray@builder.freebsdmall.com:/usr/obj/usr/src/sys/BUILDER i386

>Description:

Additions to this section ..

>How-To-Repeat:

>Fix:

This should be proofread and sgmlified.  This was submitted to me by
Benoit Mussche <benoit.mussche@pandora.be> so he should be credited
when it is committed.  I don't have the time now so maybe someone else
can get to this before me.

	- Murray

----
12.5.3 burncd

If you have an ATAPI CD burner, you can use the burncd command to burn
an ISO image, various data files, or audio tracks onto a CD. burncd is
part of the base system, installed as /usr/sbin/burncd. Usage is very
simple, as it has few options:

    # burncd -f cddevice -s 20 data imagefile.iso fixate

will burn a copy of imagefile.iso on cddevice at speed 20. The default
device is /dev/acd0c. See burncd(8) for options to eject the CD after
burning, write audio data without gaps between tracks, etc.

Follows a series of example command lines and tricks.

To create a data CD from files, just cook up an ISO file from their
directory, such as /tmp/kitchen, and burn it:

    # rm /tmp/cd.iso ; mkisofs -d -N -D -R -L -l -J -T -o /tmp/cd.iso /tmp/kitchen && burncd -f /dev/acd0c -s 20 data /tmp/cd.iso fixate
    
Note: mkisofs "i won't read that man page" parameters-stuffed command
line courtesy of http://www.mostgraveconcern.com/freebsd. Don't forget
not to exceed your maximum CD size indicated in Megabytes. Use "du -h"
in the temporary directory for that purpose.

If you would like to let the full directory appear upfront on the CD,
move that directory into wherever you store your files to be burnt
from.

To make "backups" of your audio CD's for your *cough* personal use,
you need to grab the audio tracks first. Install dagrab and sox from
ports and create a script going on like this:

    echo "removing old junk"
    rm /tmp/juke/*
    dagrab -d /dev/acd0c -a -f /tmp/juke/track%02d && cd /tmp/juke/
    echo "starting convertion into raws"
    sox -V -t wav -r 44100 -w -s -c 2 track01 track01.raw
    sox -V -t wav -r 44100 -w -s -c 2 track02 track02.raw
    sox -V -t wav -r 44100 -w -s -c 2 track03 track03.raw
    ...
    sox -V -t wav -r 44100 -w -s -c 2 trackXX trackXX.raw
    echo "insert new disc in drive and burn"

Feel free to replace the repeated lines with an automatic
incrementation in some neat code. Using sox to convert the ripped
audio tracks from .wav to .raw format is necessary to avoid an awful
scratch at the beginning of each track. The .raw files are .wav files
stripped from their data header, which produce the forementionned
scratch when burned as audio tracks.

To burn audio tracks ripped into /tmp/juke at writing speed 20, hit:

    # burncd -f /dev/acd0c -s 20 audio /tmp/juke/*.raw fixate

To create audio CD's from midi files, first install timidity++ from
ports then install manually the GUS patches set by Eric A. Welsh,
available at
http://www.stardate.bc.ca/eawpatches/html/default.htm. After you set
up timidity++ to use the patches correctly, create wav's from the midi
files using this command line:

    timidity -Ow -s 44100 -o /tmp/juke/01.wav 01.mid

Repeated as many times as necessary. Then convert the wav's into raw's
as previously described and burn the cd the usual way.

To burn mp3's as audio tracks, install mpg321 from ports and convert
them to the raw format using this command line:

    mpg321 --stdout track01.mp3 > track01.raw

You may also use xmms with the disk writer plugin, but xmms will
produce wav files, which you need to convert to raw before you burn
them.  However, xmms is the only player that can convert .exo module
files, and various other special audio formats working under its
plugins, to wav.

Remember not to burn anything else than raw files as audio tracks, if
necessary converted to 44 kHz stereo from whatever data form they come
from. For example, if you convert a 22 kHz mono mp3 to wav, roll a wav
editor such as mhwaveedit, split the mono file into fake stereo and
convert it to 44 kHz before you convert it to raw. If you don't, you
will experience listening to painful screwed up CD's that will end up
into the trashbin.


>Release-Note:
>Audit-Trail:

From: "Eric Anderson" <anderson@centtech.com>
To: <murray@freebsd.org>
Cc: <FreeBSD-gnats-submit@freebsd.org>
Subject: Re: docs/51203: Improvements to burncd section of Handbook (12.5.3)
Date: Sun, 20 Apr 2003 21:55:40 -0500 (CDT)

 >
 >>Number:         51203
 >>Category:       docs
 >>Synopsis:       Improvements to burncd section of Handbook (12.5.3)
 >> Confidential:   no
 >>Severity:       non-critical
 >>Priority:       low
 >>Responsible:    freebsd-doc
 >>State:          open
 >>Quarter:
 >>Keywords:
 >>Date-Required:
 >>Class:          doc-bug
 >>Submitter-Id:   current-users
 >>Arrival-Date:   Sun Apr 20 19:00:22 PDT 2003
 >>Closed-Date:
 >>Last-Modified:
 >>Originator:
 >>Release:        FreeBSD 5.0-RC i386
 >>Organization:
 > FreeBSD Mall, Inc.
 >>Environment:
 > System: FreeBSD builder.freebsdmall.com 5.0-RC FreeBSD 5.0-RC #21: Sat
 > Dec 7 19:41:45 PST 2002
 > murray@builder.freebsdmall.com:/usr/obj/usr/src/sys/BUILDER i386
 >
 >>Description:
 >
 > Additions to this section ..
 >
 >>How-To-Repeat:
 >
 >>Fix:
 >
 > This should be proofread and sgmlified.  This was submitted to me by
 > Benoit Mussche <benoit.mussche@pandora.be> so he should be credited when
 > it is committed.  I don't have the time now so maybe someone else can
 > get to this before me.
 
 I can proofread and sgmlify this.  I'll post a patch when complete.
 
 Eric
 
 
 
 -------------------------------------------------------------
 Eric Anderson    anderson@centtech.com    Centaur Technology
 You have my continuous partial attention
 -------------------------------------------------------------
 
 
 

From: Marc Fonvieille <blackend@FreeBSD.org>
To: murray@FreeBSD.org
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/51203: Improvements to burncd section of Handbook (12.5.3)
Date: Mon, 21 Apr 2003 12:32:32 +0200

 On Sun, Apr 20, 2003 at 06:58:41PM -0700, murray@FreeBSD.org wrote:
 > 
 > This should be proofread and sgmlified.  This was submitted to me by
 > Benoit Mussche <benoit.mussche@pandora.be> so he should be credited
 > when it is committed.  I don't have the time now so maybe someone else
 > can get to this before me.
 > 
 > 	- Murray
 
 This is redundant with our current docs:
 
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/creating-cds.html
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/sound-mp3.html
 
 I mean I don't see any improvement IMHO, the only *new* things are the
 midi part and the speed/eject option for burncd(8), the remaining is
 already very well documented in the Handbook.
 
 Marc

From: Murray Stokely <murray@FreeBSD.org>
To: Marc Fonvieille <blackend@FreeBSD.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/51203: Improvements to burncd section of Handbook (12.5.3)
Date: Tue, 22 Apr 2003 09:52:43 -0700

 On Mon, Apr 21, 2003 at 12:32:32PM +0200, Marc Fonvieille wrote:
 > This is redundant with our current docs:
 > 
 > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/creating-cds.html
 > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/sound-mp3.html
 > 
 > I mean I don't see any improvement IMHO, the only *new* things are the
 > midi part and the speed/eject option for burncd(8), the remaining is
 > already very well documented in the Handbook.
 
 Ok thanks.  It might be nice to salvage a few sentences about the MIDI
 stuff to incorporate before closing this PR.
 
       - Murray
State-Changed-From-To: open->analyzed 
State-Changed-By: murray 
State-Changed-When: Sun May 4 14:50:13 PDT 2003 
State-Changed-Why:  
I'll salvage the last MIDI bit out of this PR and commit something. 



Responsible-Changed-From-To: freebsd-doc->murray 
Responsible-Changed-By: murray 
Responsible-Changed-When: Sun May 4 14:50:13 PDT 2003 
Responsible-Changed-Why:  
I'll salvage the last MIDI bit out of this PR and commit something. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=51203 
State-Changed-From-To: analyzed->closed 
State-Changed-By: murray 
State-Changed-When: Sun May 4 21:47:51 PDT 2003 
State-Changed-Why:  
MIDI section question added to the FAQ.  The rest of this material is inferior to what we already have in the Handbook. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=51203 
>Unformatted:
