# The &k3b; Handbook

## Introduction

&k3b; is a CD and DVD burning application for Linux systems optimized for &kde;. It provides a comfortable user interface to perform most CD/DVD burning tasks like creating an Audio CD from a set of audio files or copying a CD. While the experienced user can take influence in all steps of the burning process, the beginner may find comfort in the automatic settings and the reasonable &k3b; defaults which allow a quick start. The actual burning in K3b is done by the command line utilities cdrecord, cdrdao, and growisofs.

&k3b-commands;

## HOWTOs for a quickstart to &k3b;

&k3b-audiocd-howto; &k3b-cdcopy-howto;
&k3b-dcop;

## Questions and Answers

&reporting.bugs; &updating.documentation;

Compiling &k3b; fails with undefined type "struct KComboBox".

The QTDesigner tool uic is not able to find the kde widget plugins. To solve this run qtconfig and add `$`KDEDIR`/lib/kde3/plugins` to the plugin search path (replace $`KDEDIR` with your kde base dir).

## Credits and License

&k3b;

Program copyright 1999-2005 Sebastian Trueg trueg@k3b.org and the K3b team

Contributors:

- Thomas Froescher tfroescher@k3b.org

- Christian Kvasny chris@k3b.org

- Klaus-Dieter Krannich kd@k3b.org

Documentation Copyright © 2003-2004 Carsten Niehaus cniehaus@kde.org

&underFDL; &underGPL;

## Installation

### How to obtain &k3b;

The main information site for &k3b; is www.k3b.org. For the most current version of &k3b;, feedback and community help as well as &k3b; news and other information, this is the place to go.

### Requirements

In order to successfully use &k3b;, you need &kde; >= 3.1 and &Qt; >= 3.1.

&cdrdao;: Records audio or data CD-Rs in disk-at-once (DAO) mode based on a textual description of the CD contents (toc-file).

&cdrecord;/&mkisofs;: Records any kind of CD-Rs. &cdrecord; contains all of &cdrdao;'s features and extended functionality and therefore is &k3b;'s standard choice for CD burning. In some cases, &cdrdao; reaches better audio CD burning quality though.

&dvdtools;: The &dvdtools; are used to burn and format DVD+R(W) and DVD-R(W) media.

Optionally &k3b; can make use of all these libraries:

cdparanoia: A Compact Disc Digital Audio (CDDA) extraction tool, commonly known on the net as a 'ripper'.

Ogg Vorbis library: Ogg Vorbis is a completely open, patent-free, professional audio encoding and streaming technology with all the benefits of Open Source, and in direct competition with the MP3 format. Used by the Ogg Vorbis Decoder and Encoder plugins.

MAD (MPEG Audio Decoder) Library: A high-quality MPEG audio decoder, supporting the MPEG-1, MPEG-2 and MPEG 2.5 formats. All three audio layers Layer I, Layer II, and Layer III (i.e. MP3) are fully implemented. Used by the MP3 Decoder plugin.

LAME: A highly evolved MP3 encoder, with quality and speed able to rival state of the art commercial encoders. Used by the MP3 Encoder plugin.

FLAC: A free, open source codec for lossless audio compression and decompression. Used by the FLAC Decoder plugin and the External Audio Encoder plugin, so you can read and write FLAC files.

Libsndfile, FFmpeg, FLAC, Musepack decoders: Other libraries for processing a broad range of audio file formats. For example, with FFmpeg it is possible to decode WMA files in order to burn them onto audio CDs. Used by the respective plugins.

SoX: A utility that can convert between various audio file formats. Used by the SoX Audio Encoder plugin.

transcode: A Linux text-console utility for video stream processing. You need this if you want to rip DVD video.

VCDImager: A full-featured mastering suite for authoring, disassembling and analyzing Video CDs and Super Video CDs.

Normalize: A tool for adjusting the volume of audio files to a standard level. This is useful for things like creating mixed CDs and MP3 collections, where different recording levels on different albums can cause the volume to vary greatly from song to song.

eMovix: A tiny Linux distribution that is burned on CD together with video files. eMovix contains all the software to boot from a CD and automatically play every video file localized in the CD root.

You can find a list of changes to &k3b; at http://www.k3b.org.

### Compilation and Installation

&install.compile.documentation;
&documentation.index;