Build and Install Instructions

System Requirements

xjadeo is currently known to work on gnu/Linux and Mac OS-X. It is compatible with any modern Linux distribution. There are no special hardware requirements.

Binaries and Sources

Source

xjadeo is developed using Subversion repositories at http://svn.sourceforge.net/xjadeo/. In case you are unfamiliar with SVN, Sourceforge provides information on how to access it.

xjadeo is also available for download from Sourceforge as source package.

Debian packages

A Debian package can be found at debian-multimedia edit /etc/apt/sources.list to include

deb http://www.debian-multimedia.org sid main
deb-src http://www.debian-multimedia.org sid main

(replace sid by your distribution name) and run apt-get update followed by apt-get install xjadeo (or use your favorite software package tool).

Note that xjadeo >v0.3 also works with official debian ffmpeg packages, you can dpkg-buildpackage the latest SVN or tar ball (Note: run ./autoconf.sh when using the sources from SVN before building a debian package).

FC5/FC6 RPMs

xjadeo is included in »PlanetCCRMA« (Announce-Email).

SuSE RPMs

»Packman« kindly provides SVN-snapshot xjadeo RPM packages for SuSE Linux.

Build Dependencies

In order to compile the xjadeo from source, you will need the "devel" (-dev) version of these libraries.

Mandatory Libraries:

  • jack-audio-connection-kit

  • ffmpeg (libavcodec, libavformat/libavutil)

    Note that linking against ffmpeg requires all of ffmpeg's dependencies. Depending on the configuration of ffmpeg, these can include development packages of: libxvidcore, liblame, libfaac, libfaad, libvorbis, libogg, libx264, liba52, libdts,...

Video Display Libraries. (you need at least one of the following)

Optional libraries:

  • Freetype 2 (actually libfreetype6_2) - for On Screen Display.

  • portmidi - Midi Clock

  • ALSA (alsa-lib, libasound) - alternate Midi Time Clock

  • QT3 - qjadeo Graphical User Interface

  • QT4 + qt3compat - new qjadeo GUI

  • lash for restoring sessions.

  • librt (from the GNU C Library > 2.3.2(?)) - POSIX message queues (requires kernel support - Linux >= 2.6.6)

QT is only needed to compile and run the qjadeo GUI - not xjadeo itself. qjadeo works with both QT3 or QT4. If both libraries are available QT4 is preferred by the configure script. Override by setting the QTDIR environment variable. You can certainly build and use xjadeo without the GUI.

Other dependencies:

Furthermore you'll need autotools (automake >= 1.7, autoconf) to generate the build environment, and the standard gnu devel system (gcc, make, glibc-devel, etc) to compile it.

We also recommend to install mencoder to convert the video file to a suitable format.

Pay special attention to ffmpeg, since some versions of this package are not compatible with xjadeo.

Building xjadeo

If you are using sources from the subversion repository, you'll first need to generate the configuration script in the xjadeo/trunk/:

cd xjadeo/trunk/
./autogen.sh

Once you have all the build dependencies and uncompressed the xjadeo tar.gz the usual spells apply:

./configure
make 
make install # (requires root privileges) 

The configuration process tries to autodetect and include supported features. However you might want to consider using some of the compilation options. run ./configure --help for a full list of available arguments.

--enable-midi=auto

Choose midi library to use. good values are auto, portmidi, alsamidi, none. The current default is to to use alsa-midi if available and fall back to using portmidi.

--with-fontfile=/path/to/font.ttf

Set the default (hardcoded) true type font file to use for OSD.

--enable-sdl

include the SDL video mode.

--disable-ft

Disables the use of freetype2 for On Screen Display. xjadeo will be build without on screen display support

--disable-qtgui

Do not build the QT Graphical User Interface.