Installation and Usage of dvdwizard
===================================

Since Version 1.40 lxdvdrip uses "dvdwizard" to make a Backup with a
Menu for Selection of Titles, Audio Tracks, Subtitles and Chapters.

As a minimum you need Version 0.5.0.


1) Download of the Original Version of dvdwizard

http://dvdwizard.wershofen.net/


2) Installation

2a) Unzip archive

# su root
# tar zxvf dvdwizard.tar.gz
# cd dvdwizard*

For the Installation look in the README in the archive.


2b) Config File

In the dvdwizard Archive you find a sample Config File "dvdwizard.conf.sample". 
Copy this File to "~/.dvdwizard/dvdwizard.conf" (or "/etc/dvdwizard.conf"
systemwide).


2c) DVD-Menu in your Language

Change the Parameter in the dvdwizard-Configurationfile
to get an english Menu:

-----------------------
MENU="EN"
-----------------------


3) Install additional Software

dvdwizard needs some Tools. Please read the Documentation in the File
"README" or "README.DE" (german).

Please read this Page, too:

http://udrecsuite.sourceforge.net/doku_dvdwizard.html

You need the following True Type Font for the Creation of Menus:

/usr/share/fonts/default/TrueType/arial.ttf
(on other distributions /usr/share/fonts/TrueType/arial.ttf)

Create the Directory, if it doesnt exist. The Font File you can 
copy from your Windows Partition. 

Else you can download the Font from:

http://www.mplayerhq.hu/homepage/design7/dload.html

Or:

http://sourceforge.net/projects/corefonts/

This Font is a Windows ".exe", you can extract it with WINE. The Font will be
installed to "c:\windows\fonts" of your Fake Windows.


4) First Test

You need a VOB-File to test this. 

Please call "lxdvdrip -t=l -dw=0 -file=test.vob". This lists all Titles, choose the
shortest and then lxdvdrip creates a VOB-File "test.vob".

Now call: "dvdwizard test.vob"

In the Directory where you are a DVD Structure is created in the Subdir "dvd".
Please test this DVD-Structure with a Player (xine, ogle, vlc) and see, 
if there is a Menu. You must call it for the Structure with the Path as Device,
not with the Files in this Directory direct.

Before continueing with Step 5), this must!! work.


5) Activation of dvdwizard in lxdvdrip

In the Config File "lxdvdrip.conf" there are Parameters to activate "dvdwizard".


5a) Install Pictures for Background

dvdwizard could integrate your own Pictures into the Menu.

The first is the Background of the Main menu, the second the Background for the 
Title Menu. The Pictures could be any bmp, png, jpeg or other Picture, you have to 
test this for yourself to see the best Result.

dvdwizard works without these Pictures, too. In this Case the Main Background is blue,
in the Menu for every Title is a Screenshot of the Background of the Beginning of the Title.

Example with Picture Files:

---------------------------------------------
dvdwizard_bild1=/path/to/picture/picture1.bmp
dvdwizard_bild2=/path/to/picture/picture1.bmp
---------------------------------------------

"dvdwizard_bild1" is the main Background, "dvdwizard_bild2" for the Title. If you dont want
the Pictures, then choose the following Config:

---------------------------------------------
dvdwizard_bild1=
dvdwizard_bild2=
---------------------------------------------


5b) Activation 

The Parameter "dvdwizard=1" activates dvdwizard, with "dvdwizard=0" a DVD without Menu
is created. The Parameter "dvdwizard_name=..." is for the Filename of dvdwizard, optional
with full Path.


5c) (De-) Activation on the fly

You can overwrite the Config-Parameter "dvwizard=" at the Command Line with "-dw=", 
if you sometimes want another Setting without change the Configfile 
("-dw=0" => off, "-dw=1" => on).


5d) Full Config Example

---------------------------------------------
dvdwizard_bild1=~/picture1.bmp
dvdwizard_bild2=~/picture2.bmp
dvdwizard=1
dvdwizard_name=/usr/local/bin/dvdwizard
---------------------------------------------


6) Known Problems

- Title count (only in (part-)copy Mode)

If there are more than 6 Titles, the Menu is bigger then the Screen.
There are 9 Titles possible. At this Time there is no Solution.

- dvdwizard fails

In the Directory where you are calling lxdvdrip there will be a Logfile "dvdwizard.log".
lxdvdrip only deletes this file, if dvdwizard return OK. Here you find a Description 
of the Problem you have.
