---
name: "burn"
section: "1"
platform: "linux"
package: "burn"
version: "0.4.6-2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/burn"
---

# burn(1)

record from various sources to optical media (CD, DVD)

## 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

- **-n, --name**

  image name

## 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.
