Vamps Documentation
Software Requirements
The following software needs to be installed to run Vamps:
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, 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, qVamps is developed using
Perl 5.8.5.
-
PerlQt, you should have
Version 3.008. If you want tooltips to work in qVamps, you have to
apply a patch.
-
Swig, required if you are
installing qVamps from source. Swig is used to generate the Perl
binding to libdvdread. Swig version 1.3.25 is used for development of
qVamps. Swig 1.1.x is reported not to work for qVamps
installation. Starting with swig 1.3.28 you need to override a make
variable to get rid of a warning during build: make SWIGFLAGS="-perl
-Wall -nodefaultctor -nodefaultdtor"
-
Dvdauthor, 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
available for dvdauthor-0.6.12-alpha-2992,
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, 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, ppmtoy4m,
mpeg2enc and mplex are used for menu generation.
-
Xine or some derivative
like Kaffeine 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
has been successfully used with qVamps. Growisofs, which is part of
the DVD+RW-Tools,
also works fine for burning.
Installation
Just the simple way (both Vamps and qVamps):
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.
Default base prefix for installation is /usr/local. If you don't like
that, edit the Makefile (PREFIX=).
Localization
qVamps supports the Qt standard flow for translating messages to your
preferred language. If you like to do localization yourself, copy
xx.ts to a file named according to the ISO639 code of the language
(e.g. fr.ts for french, cs.ts for Czech, etc.) and load it into
linguist (comes with Qt development environment). After translation of
the ~220 messages save the file and extend the Makefile according to
the rules for the (non-existing) language xx. The generated .qm file
will be loaded by qVamps if run with the LANG environment variable set
appropriately.
It is not necessary to complete each and every term in
linguist. Non-translatable strings like names (e.g. qVamps) may be
left empty. This also saves a bit of file space.
Usage
Anything to say here? Ok, more content to come. Please don't ask when…