# &k9copy; Handbook

## k9copy shell

### The Main Window

Main Window Screenshot

The main goal of k9copy is to be an easy to use and powerfull DVD backup app.

Once oppened, the DVD structure is shown in a treeview (the central widget).

The selection is made by checkboxes. You can select the entire DVD, a Titleset or just a specific language or subtitle from a DVD title.

For DVD backup there are two possibilities :

- backup with orginal menus. In this case, k9copy reproduces the orginial structure of the DVD without the unselected parts.

- backup without menus. In this case, k9copy makes a reauthoring of the DVD. K9copy uses libdvdnav from xine to ensure that the DVD will be copied as it were played with xine.

### Making a dvd backup

#### Open the dvd

Select a dvd device from the list or click on buttons on right of the list to select a directory or a dvd image file.

Click on the button Open from the main toolbar or File->Open from the main menu.

The treeview will be filled with the DVD structure

#### Selection of titles to copy

DVD structure Screenshot

Use the checkbox at the top of the treeview to make a copy of the entire DVD.

Use the checkbox beside the titleset to make a copy of an entire titleset.

A title must have a video stream : if you select an audio language or a subtitle language, the video stream will be automatically selected. If you deselect the video stream, the title will not be backuped.

#### Playback options of the new DVD

If the DVD you want to backup has interactive menus, you can keep them on your backup. On some DVDs, menus are very big and keeping them will increase the shrink factor and reduce the quality of the video stream.

If you have choosen to not keep original menus, it's possible to define some playback options :

When a title is selected, it appears in the Selected Titles list. Use buttons on the right of this list to define in which order the titles will be played.

You can define the default audio language or the default subtitle for each title. Hilite a title in the title list and the two comboboxes will be filled with the available languages (those which where selected in the treeview).

#### Executing the copy

Once you have selected the titles, you can proceed with copy :

### DVD backup settings

DVD backup settings Screenshot

- Temporary files will be placed in the output directory

- Define the max size of the backup

- By default, &k9copy; uses its own burning method. Since the burning options are limited, you can use the a powerfull burning software: k3b.

- AutoBurn allows to run the DVD burning without confirmation.

- When using quickscan, &k9copy; will not analyze the dvd title to estimate the sizes of each stream. The DVD analyze can take a long time if DVD contains many features.

### Encoding MPEG-4

&k9copy; offers the possibility to encode DVD titles in MPEG-4 by using MEncoder.

Just select an audio stream from a title in the treeview and click on the button

### MPEG-4 settings

MPEG-4 settings Screenshot

- Select the codec used to encode mp4. Default codecs are XViD and lavc MP4, but you can add other codecs supported by MEncoder.

- Choose the max size of an avi file an the number of files wanted.

- Enter the width of the mpeg4 video.

- Enter the height of the mpeg4 video.

- Audio will be encoded in mp3 using lame. You can choose the bitrate of the mp3 audio stream.

## Command Line Options

Usage:

    k9copy

    f
    pw
    ax
    d

    --fullscreen
    --play
    --audiodriver
    --videodriver
    --device
    --verbose
    --wizard
    file

`-f,--fullscreen` | Starts &k9copy; in fullscreen mode.
`-p,--play` | Starts with last played track.
`-a,--audiodriver (argument)` | Sets the audio driver. Arguments can be: alsa, arts, oss, ...
`-x,--videodriver (argument)` | Sets the video driver. Arguments can be: xv, xshm, dxr3 ,...
`-d,--device (argument)` | Sets the Audio-CD/VCD/DVD path to (argument).
`--verbose` | Outputs more debug messages.
`-w,--wizard` | Runs installation wizard.
`file...` | Files to play. Can be local files, a directory, an URL or "AudioCD", "VCD", "DVD".

## Questions and Answers

Kaffeine-FAQ

xine-FAQ

For Questions use the k9copy-user mailinglist. (First check the archive if the question is still answered.)

## Reporting BUGS

Before you report a bug, please first make sure the bug has not been reported yet in the bug tracking system at http://www.sourceforge.net/projects/k9copy. Also have a look into the mailinglist archive.

Please use only the tracking system on sourceforge for reporting bugs and log in before submitting (if you've a sourceforge account).

When you submit a bug, please include all of the following information:

- versions of Kaffeine, xine, KDE, X11

- the backtrace from KDE's Crash Manager

- console output (you can use --verbose to get more)

## Copyright and License

Program copyright 2003-2005, The Kaffeine Authors

Documentation copyright 2003-2005, Jürgen Kofler k9copy@gmx.net, Christophe Thommeret hftom@free.fr

&underFDL; &underGPL;
&documentation.index;