Xtheater User's Guide
Table of Contents Introduction Basic Usage


Installation of Xtheater is not the easiest install in the world. But it is also far from the hardest install. First you must install the following packages: Avifile can be compiled without qt, so don't worry if you do not have qt, it will just not build some of the sample applications, sych as aviplay.

If you wish to install as much from binary packages, in general, the following package names will indicate binary packages of requirements listed above: For AVI/ASF playback, you will have to get it from CVS, no binary packages are available. Note also that to get libaviplay to work properly it needs to be linked with libXxf86vm on some systems. do this by adding -lXxf86vm to the LIBS line of the lib/Makefile from the avifile tree.

ROX Application Directory

Xtheater as downloaded is an application directory. After meeting all the requirements listed above, you can just click on the Xtheater directory under ROX and it will automatically configure and compile itself as a relocatable application directory for use with ROX. If you do not use ROX or want to keep the install of Xtheater standard with other installs, continue. Otherwise, clicking on the Xtheater directory should be enough to get it ready to run with ROX.

Standard Installation

After you have installed all prerequisite pacakges, you run ./configure. Before running configure, you may wish to read up on GL support. It can be enabled at this stage, but is not configured by default, for reasons explained in the GL section linked to previously.

After you have ran ./configure in the Xtheater directory to your liking, make install will put all the files in the right place. By default, the configuration is stored at /usr/local/Xtheater/config. the binary is placed at /usr/local/bin/xtheater, player plugins are in /usr/local/Xtheater/player/, and ui plugins are in /usr/local/Xtheater/ui/. None of this needs to be known for install, but is provided for reference here.

You should now be ready to run xtheater and have fun. Basic operation will be described in the next section, but this is very straightforward, so no instruction is needed, just provided for completeness.

Table of Contents Introduction Basic Usage