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 and Chapters.

As a minimum you need Version 0.4.2.


1) Download of the Original Version of dvdwizard

http://www.wershofen.de/downloads/dvdwizard.tar.gz


2) Installation

2a) Scripts

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

Make Scripts executable:

# chmod 660 *

Copy Scripts in a Directory of the Path for Executables, i. E.:

# cp * /usr/local/bin


2b) Config File

In the dvdwizard Archive you find a sample Config File "dvdwizard.conf.sample". 
Copy this File to "~/.dvdwizard/dvdwizard.conf".

You must not change Settings, but the List of Languages for Audio Tracks should be
enhanced.

Standard:
--------------------
DVDAUDIO="de,en"
--------------------

This List could be enhanced with Languages you want to rip:
-------------------------
DVDAUDIO="de,en,fr,it,es"
--------------------------


2c) DVD-Menu in your Language

The original Version of dvdwizard creates an English DVD-Menu.

If you want a DVD-Menu in your Language, you have to copy the 3 Files

- mk_vmgm
- mk_vtsm
- mk_vtsm_audio

from Subdir dvdwizard over the Original Files from dvdwizard 0.4.2 and
the Config File from Subdir dvdwizard to ~/.dvdwizard.

At the End of the Config File are some Parameters you have to Edit, for 
more take a look at that File.

The Changes are submitted to Author of dvdwizzard and will be included
in an next Version.


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/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 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

- Menu for Subpicture

There is no Menu for the Subtitles, but dvdwizard/dvdauthor is called 
with the Languages of Subpicture Tracks for Switch with Remote Control of the Player.

- 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.

- Background of Menu Font

If the Background of the Menu isnt transparent, you have a Problem with Image Magick 6.x.
Please read "README" of dvdwizard, there is a 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.