xjadeo - X Jack Video Monitor

http://xjadeo.sourceforge.net

Abstract

xjadeo is a program that displays a video clip in sync with an external time source, which comes quite handy when you want to create a soundtrack for a movie.

It has applications in soundtrack composition, video monitoring or any task that requires to associate movie frames with audio events.

xjadeo supports different video file formats, display libraries and sync sources. It includes an optional GUI qjadeo that provides file-history and allows to modify settings of a running xjadeo instance.

xjadeo is being developed on the GNU/Linux operating system, but not limited to it.


Table of Contents

Introduction and Copyrights
NEWS
DOWNLOAD
LICENSE
FEATURES
CREDITS AND ACKNOWLEDGMENTS
PROSPECTS
Build and Install Instructions
System Requirements
Binaries and Sources
Build Dependencies
Building xjadeo
Using xjadeo
Video Formats
Invoking xjadeo
Interacting with xjadeo
Setups
Troubleshoot
Known Issues
Remote Control Interface
General Commands
Video File Commands
Synchronization Commands
Monitor Window Commands
Notify Commands
On Screen Display Commands
Response Format
Internals
Behind the Scenes
Synchronization Accuracy
Frame Transformation
Midi Clock Conversion
A. Manual Pages
xjadeo — displays a video clip in sync with an external timing source
qjadeo — GUI front-end to xjadeo
xjremote — CLI front-end to xjadeo
xjinfo — Display A/V file info in XML format.

Introduction and Copyrights

NEWS

xjadeo v0.4

As you might have noticed by the logo, we will need an upgrade from Super-16 to 35mm! XPMs are welcome.

DOWNLOAD

xjadeo is available at Sourceforge. Read Build and Install Instructions for further information.

LICENSE

xjadeo is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should receive a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

FEATURES

xjadeo - video Monitor

  • Display modes:

    • XV (hardware accelerated)

    • SDL (hardware accelerated) - probably deprecated soon.

    • imlib2/X11

    • imlib/X11

  • Video stream decoding via FFMPEG, xjadeo supports MPEG/VOB, AVI, ASF/WMA/WMV, RM, QT/MOV/MP4, Ogg/OGM, MKV, VIVO, FLI, yuv4mpeg films, provided they use a seekable encoding.

  • Sync source:

    • jack transport.

    • MTC using either ALSA midi or portmidi.

  • Remote control interface allows to query and modify all of xjadeo's settings and parameters via standard I/O.

  • LASH - session management.

  • Optional Qt Graphical User interface via remote control interface.

CREDITS AND ACKNOWLEDGMENTS

xjadeo was designed and written by Luis Garrido and Robin Gareus.

Fortunately we stand on the GNU giants' shoulders (both of em). See header and comments in the source files for more detailed information.

PROSPECTS

Future releases of xjadeo will be more comprehensive. xjadeo will settle for X11/Xv, support VSync and buffered video. see the TODO file in the source or contact the developers if you are interested.

It's a thighrope walk between audio-helper-application (low profile) and pro-A/V-tool (exact video sync).

xjadeo started as a collection of example code end is being used as that. People use it as code repository to spin-off c based video installations.. Parts of xjadeo have been re-used for various VJ purposes, mainly to synchronize playback on multiple screens (using netjack and/or xjadeo remote-ctrl see xjadeo sync. commands ). check http://svn.sourceforge.net/viewcvs.cgi/xjadeo/trunk/contrib/ for further additions.

With minor modifications xjadeo can read video-frame-offset lists (EDL) and do the editing during playback. It is unlikely for this to be merged in the main distribution. video editing, although sometimes handy, is clearly beyond xjadeo's scope. check out: Open Movie Editor or use the EDL capabilities of mplayer/mencoder, go cinelarra or explore lives.