BURNCD(1) - General Commands Manual

NAME

burncd - burn audio files to a blank CD

SYNOPSIS

burncd [-dhnNvV] [-c config ...] [-C binary] [-e format ...] [-f format ...] [-F binary] [-M binary] [-o path] [-p playlist ...] [-S binary] [-z device] [file ...]

DESCRIPTION

burncd is a portable POSIX shell script that uses cdrecord(1) to burn audio files to a blank CD. It currently supports flac(1), wav, mp3 and Sun/NeXT audio files which will be automatically detected from the command line, current directory or playlist.

AUDIO FORMATS

By default burncd will prefer wav and Sun/NeXT audio formats as cdrecord(1) supports these files natively. It will then select other lossless and lossy audio formats. Lossy audio formats will always be the least prefered. If any files exist in multiple audio formats it will use only the first.

Currently supported audio formats by burncd:

wav

WAVE

Sun/NeXT

flac

FLAC

mp3

MPEG Audio Layer III

AUDIO FILES

Audio files will be detected from the current directory using the sanitized output of file(1). This avoids issues related to filenames that do not have a correct filename extension.

NON-NATIVE CD AUDIO FILES

Audio files must be 44.1 kHz, 16-bit and stereo to be correctly work on blank audio CDs. If sox(1) is found in the user's $PATH then it will be used to convert any audio files that are not properly supported. If sox(1) is not found then burncd will exit early when any such files are detected.

PLAYLISTS

Audio files can be read from plaintext playlist files containing a list of files separated by newline characters. Relative paths will be read from the current directory. If the file or playlist is missing, can not be read or the playlist is not a text file a warning will be printed. Comment lines are not supported.

CDRECORD PERMISSIONS

Some distributions will install cdrecord(1) without suid permissions for security concerns which will require burncd to be run as root. Alternatively the user can add suid permissions to cdrecord(1).

For example the following commands can be used.

# chown root:somegroup /usr/bin/cdrecord
# chmod 4710 /usr/bin/cdrecord

The user should then make sure they belong to 'somegroup'.

ENVIRONMENT VARIABLES

burncd supports the following environment variables.

XDG_CONFIG_HOME

XDG base directory.

XDG_CONFIG_DIRS

List of colon-separated directories.

XDG_CONFIG_HOME defaults to $HOME/.config/burncd/burncd.conf. XDG_CONFIG_DIRS defaults to /etc/xdg/burncd/burncd.conf.

CONFIGURATION FILES

burncd looks for configuration files in the following order.

$XDG_CONFIG_HOME/burncd/burncd.conf
$HOME/.burncd.conf
$XDG_CONFIG_DIRS/burncd/burncd.conf
/etc/burncd.conf
./burncd.conf

Configuration files are written in plain text. Comments begin with a #. Variables are split by whitespace and a =. All other whitespace is ignored. Variables can be set to either a file path or enabled with 1. Any unset variables will be set to the default.

burncd will ignore any unlisted variables.

CDRECORD

Path of the cdrecord(1) binary.

DEBUG

Enable debug output from external programs.

DEVICE

Path of the CD drive.

DRYRUN

Enable a test run without burning to a CD.

FLAC

Path of the flac(1) binary.

MPG123

Path of the mpg123(1) binary.

OUTPUT

Path of the output directory.

SOX

Path of the sox(1) binary.

VERBOSE

Enable verbose logging.

When loading configuration files with --config variables will be set only once and then ignored in any additional config files.

OPTIONS

A summary of the options is included below.

-c, --config config ...

Path of the configuration files.

-C, --cdrecord binary

Path of the cdrecord(1) binary.

-d, --debug

Show the debug output from external programs.

-e, --exclude format ...

Configure the excluded audio formats.

-f, --format format ...

Configure the default audio formats.

-F, --flac binary

Path of the flac(1) binary.

-h, --help

Show basic usage and a list of all options.

-M, --mpg123 binary

Path of the mpg123(1) binary.

-n, --dry-run

Enable a test run without burning to a CD. burncd will not check for a blank CD under this mode.

-N, --no-conf

Do not load default configuration files.

-o, --output path

Configure the output directory path. Defaults to /tmp/CD.

-p, --playlist playlist ...

Read audio files from a playlist.

-S, --sox binary

Path of the sox(1) binary.

-v, --verbose

Show the verbose burncd output.

-V, --version

Show the burncd version number.

-z, --device device

Configure the CD drive path. Defaults to /dev/sr0.

EXAMPLES

burncd

Burn audio files from the current directory to a blank CD.

burncd file ...

Burn audio files from the command line to a blank CD.

burncd -c burncd.conf.1 burncd.conf.2

Load the burncd.conf.1 and burncd.conf.2 configuration files from the command line.

burncd -C /usr/bin/cdrecord

Use the /usr/bin/cdrecord binary.

burncd -e wav mp3

Exclude all wav and mp3 audio files.

burncd -f flac mp3

Prefer flac(1) and then mp3 audio files.

burncd -F /usr/bin/flac

Use the /usr/bin/flac binary.

burncd -M /usr/bin/mpg123

Use the /usr/bin/mpg123 binary.

burncd -o /tmp

Set the output directory path to /tmp.

burncd -p foo bar

Read audio files from plaintext playlists titled foo and bar.

burncd -S /usr/bin/sox

Use the /usr/bin/sox binary.

burncd -z /dev/sr1

Set the CD drive path to /dev/sr1.

Example burncd configuration file.

# Set the cdrecord binary path
CDRECORD = /usr/bin/cdrecord

# Set the output directory
OUTPUT = /tmp

# Enable verbose logging
VERBOSE = 1

AUTHORS

orbea <orbea@riseup.net>

BUGS

Not all mp3 audio files are detected by burncd.

Issue tracker