NAME¶
burn - record from various sources to optical media (CD, DVD)
SYNOPSIS¶
burn  MAIN_MODE [OPTIONS]... [FILE/S]...
burn --help
 
DESCRIPTION¶
CD-writing program/script. Features Data-CD, Audio-CD, Copy on the fly, Iso-CD.
CONFIGURATION¶
Configuration files for burn are: 
~/.burnrc or 
/etc/burn.conf. You
  can edit them to change values.
 
If you don't have these files you can:
  - 1.
 
  - use burn-configure utility
 
  - 2.
 
  - take the configuration template, edit and copy it as
      ~/.burnrc or /etc/burn.conf
 
 
MAIN MODES¶
  - -D, --data-cd
 
  - To create Data-CD
 
  - -I, --iso-cd
 
  - To create ISO-CD
 
  - -C, --copy-cd
 
  - To copy CDs
 
  - -A, --audio-cd
 
  - To create an audio CD from WAV, MP3 and ogg files
 
 
EXAMPLES¶
# burn -D -p /etc/
 
Creates a CD with /etc/ contents. (you will find files and directories contained
  in /etc in CD's root.)
 
# burn -D -p /home/bigpaul/video/summer_2003/spain.tar.gz
 
Creates a CD with spain.tar.gz in CD's root
 
# burn -D -r /etc/
 
Creates a CD containing the whole /etc/ directory. (-r preserves path)
 
# burn -D -c /mail_2003 /home/bigpaul/Mail -p /boot/vmli*
 
Creates a CD containing the whole /home/bigpaul/Mail renamed into /mail_2003.
  (-c changes path name). This command also adds in CD's root every vmli* file
  in /boot/ directory
 
# burn -I -n image.iso
 
Burns image.iso
 
# burn -C
 
Copy CDs (disk at once).
 
# burn -A -a *.wav
 
Creates an Audio CD. Tracks come from wav files
 
# burn -A -a *.mp3
 
Creates an Audio CD. Tracks come from mp3 files
 
# burn -A -a *.ogg
 
Creates an Audio CD. Tracks come from Ogg Vorbis files
 
# burn -A -a *.mp3 file.ogg track01.wav
 
Creates an Audio CD preserving input order. In this example the first audio
  tracks will come from mp3 files, than we will find the one from
  
file.ogg and finally the one from 
track01.wav
GENERAL OPTIONS¶
  - -s, --simulate
 
  - to perform a burn simulation
 
 
DATA-CD OPTIONS¶
  - -p, --path
 
  - add file/s or path's content to CD-ROM's root. e.g.:
      -p /cvs/myproj/. In this example we will find CD-ROM's root
      filled with /cvs/myproj/ contents, but no /cvs/myproj/ will
      be created
 
  - -r, --preserve-path
 
  - add file/s or path's content to CD-ROM preserving original
      path. e.g.: -r /cvs/myproj/. In this example we will find
      /cvs/myproj/ in CD-ROM's root
 
  - -x, --exclude-path
 
  - every file or directory matching this string will not be
      included
 
  - -c, --change-path
 
  - old_path will be named new_path in CD-ROM. e.g.: -c
      /my_home/2004_Jan/ /home/bigpaul/. Thus /home/bigpaul/ will
      be named /my_home/2004_Jan/ in CD-ROM.
 
  - -l, --follow-symlink
 
  - this option allows burn to follow symbolic link
    directories
 
  - -m, --multisession
 
  - this option allows multisession CDs
 
 
ISO-CD OPTIONS¶
AUDIO-CD OPTIONS¶
  - -a, --audio-file
 
  - mp3, ogg or wav file/s
 
 
AUTHOR¶
Ben Finney <ben+python@benfinney.id.au>, Gaetano Paolone
  <bigpaul@hacknight.org>
COPYRIGHT¶
This is free software: you may copy, modify, and/or distribute this work under
  the terms of the GNU General Public License, version 2 or later as published
  by the Free Software Foundation. No warranty expressed or implied. See the
  source for details.