qVamps Installation
===================

1. Software Requirements

The following software needs to be installed to run qVamps:

Vamps. You need version 0.99.1. The tiny add-on play_cell which comes
with vamps is also important for qVamps to work.

Qt http://www.trolltech.com/, qVamps is developed using Version
3.3.4. On most Linux distributions you will need the Qt development
package(s) for installation from source. If you are going to install a
localized version, you will also need lupdate and lrelease, which may
be hidden in some other Qt development package.

Perl http://www.perl.org/, qVamps is developed using Perl 5.8.5.

PerlQt http://perlqt.sourceforge.net/, you should have Version
3.008. If you want tooltips to work in qVamps, you have to apply a
patch http://vamps.sourceforge.net/files/perlqt-3.008-tooltip.patch

Swig http://www.swig.org/, required if you are installing qVamps from
source. Swig is used to generate the Perl binding to libdvdread. Swig
version 1.3.21 is used for development of qVamps. Swig 1.1.x is
reported NOT to work for qVamps installation.

Dvdauthor http://dvdauthor.sourceforge.net/, qVamps generates an XML
control file for dvdauthor. When dvdauthor is run, it creates a DVD
image on hard disk directly from the source DVD.

There is a patch http://vamps.sourceforge.net/files/dvdauthor-spucmd7.patch
available for dvdauthor-0.6.12-alpha-2992
http://dvdauthor.sourceforge.net/alpha/dvdauthor-0.6.12-alpha-2992.tar.gz,
which fixes a problem with some subtitle streams. You should try the
patched alpha version, if you encounter the following error:

ERR: procremap encountered unknown subtitle command: 7

The patch may also work if applied against other versions of
dvdauthor, but this has not been tested.

Optional:

Mplayer http://www.mplayerhq.hu/, used for title/chapter preview. You
may try a different player. The commands to launch the player may be
adjusted in ~/.qvamps/qvampsrc or even in the system wide file
/usr/local/share/qvamps/etc/qvampsrc. I did not find another player
capable of selecting DVD device, DVD title, angle, audio and subtitle
stream from the command line. Mplayer works fine.

The MJPEG Tools http://mjpeg.sourceforge.net/, ppmtoy4m, mpeg2enc and
mplex are used for menu generation.

Xine http://xine.sourceforge.net/ or some derivative like Kaffeine
http://kaffeine.sourceforge.net/ is helpful to preview the final DVD
image before burning. Kaffeine allows for specifying the image
directory in the command line using the -d option. Mplayer
unfortunately does not support DVD navigation, i.e. menus.

Some program to finally burn the image to a blank DVD. CDrecord-ProDVD
http://ftp.berlios.de/pub/cdrecord/ProDVD/ has been successfully used
with qVamps. Growisofs, which is part of the DVD+RW-Tools
http://fy.chalmers.se/~appro/linux/DVD+RW/, also works fine for
burning.

2. Installation

Just the simple way:

make
su
make install

You should not encounter any warnings or errors. If you however have
problems, try your best. If you think, Vamps or qVamps need
improvement, file a bug report
http://sourceforge.net/tracker/?func=add&group_id=130986&atid=719578

Default base prefix for installation is /usr/local. If you don't like
that, edit the Makefile (PREFIX=).
