klvemkdvd - a KDE GUI replacement for lvemkdvd
==============================================

1. Purposes
-----------

klvemkdvd is able to build (and burn) DVD filesystems from 
various mpeg media files using lve tools and some other 
programs. 

the main intention of klvemkdvd is to build DVDs from 
project files (edit lists) created with lve editor. 
But it can use other kind of mpegs (VOB, TS, PS, PVA, ...)
as input also.

At all it's a GUI replacement for the command line tool
lvemkdvd (much easier to handle) and is a extension to the
lve package.

please beware: this is a preview release ...


2. Requirements
---------------

klvemkdvd is developed with kdevelop 3.0b2 and therefore needs
a proper installed KDE (>= 3.1.4) including development libs and
QT relase (>= 3.2.3). it's deliverd as source only. 

klvemkdvd invokes following programs

- from "lve" package:
    lvemkidx
    lvedump
    lvemux

- from "dvdauthor" package:
    dvdauthor

- from "dvd+rw-tools" package:
    dvd+rw-format
    growisofs

- MPlayer (only for preview issues)

therefore the named packaged should be installed on your system,
how all programs should be reachable through the binary path.

IMPORTANT: Please read also all information (Readme, DVD-Authoring.txt, ...) 
delivered with the lve package to get the stuff installed.


3. Compilation / Installation
-----------------------------   

use following commands to build the binaries 
(building with kdevelop is optional):
 
  ./configure; make

installing is done by:

  make install


4. Usage 
--------

the main window of klvemkdvd is didvided in several sections:

- "DVD Filesystem" section (top left)
- "DVD Writer" section (top right)
- "DVD project files (new title)" section (middle left)
- "Filebrowser" section (middle right)
- "Details and message line" (bottom)
  
Start your work on the "Filebrowser" to select media files whished
to import into the "DVD Project ..." section . One or more selected 
file(s) can be imported using the import "<-" button left beside 
the Browser.

Importing may run a while, because of creating an index for every 
selected media file, except for "plain lve edit list files (.prj)", 
which doesn't need any import processing.

The list of imported files will be collected inside the "DVD Project ..."
section. Details of a list item will be displayed below while selected. 
You can remove items from this list using the "<X" button below the 
import button.

You can repeat the step above to import media files from different source
folders. This list will act as a workspace for a new DVD title:
all items together  will represent one complete DVD title, 
how  each item will represents itself a single chapter. the estimated 
total size of the title will be displayed in field "new Title" of the 
"DVD Filesystem" section.  

In this section you can select the destination directory of your 
DVD filesystem and observe its status. The selected directory 
may contain already one or more DVD titles. There are also some
information about size and free spaces.

To add a new Title defined by the items of the "DVD project files 
(new title)" section, you can use the "blue arrow" in top direction
this will build the title into the selected DVD Filesystem.
After processing all items the count of Titles will be incremented 
by 1 and all space information will be adjusted to the real space used, 
but the total estimated size of "new Title" will be reset to 0, because 
there are no more outstanding items ...

If there rests some space in the DVD filesystem a further title can be
added doing the same steps like discribed above. 
To remove last (or all) titles from a DVD Filesystem you can use
The "rubber" button.

The last step is the burning of the selected DVD-Filesystem. Therfore 
you  should press the "Burn" button in the "DVD Writer" section.

Befor creating any title or burning a DVD filesystem, you may select 
an appropriate destination directory and setup the right DVD writer
parameters like "Device", "Capacity"  and "Speed". RW Media needs to be
formatted before first use. This can be done with the "Format" Button.

klvemkdvd remembers all settings and selections you have made during
a session also if you restart the program.  

A log window with some additional infos can be opened  after or during 
imports or title creations by pressing the "[+]" button in the upper right 
corner (beside the message line).


5. Restrictions
---------------

- At the moment items in "DVD project files (new title)" will be sorted
  automatically by name. the sorting order will imply the order of the
  chapters of the DVD title also. 

- The estimated sizes aren't very accurate at the moment.

- klvemkdvd doesn't use all features of dvdauthor like menus, subtitles,
  ...

- it can create DVDs with one video and one audio track only