
Installation
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:
- X11 - Required for everything. All modern *nix include this
- Glib/GTK - Required for everything, 1.2.x
- SDL - Required for everything, 1.2.x
- SMPEG -
Required for MP3/MPG/VCD playback, 0.4.3 or higher.
- avifile - Required for AVI/ASF playback,
from CVS repository
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:
- glib
- glib-devel
- gtk+
- gtk+-devel
- SDL
- SDL-devel
- smpeg
- smpeg-devel
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.