# XJADEO - The X Jack Video Monitor

http://xjadeo.sf.net/

Xjadeo is a software video player that displays a video-clip in sync with an external time source (MTC, LTC, JACK-transport). Xjadeo is useful in soundtrack composition, video monitoring or any task that requires to synchronizing movie frames with external events.

## About

Xjadeo is the de-facto standard for video-monitoring with the Ardour Digital Audio Workstation and used by a variety of projects, predominantly on the GNU/Linux platform.

Xjadeo supports all standard A/V synchronization methods that are feasible to implement in software without dedicated hardware support.

It features frame-accurate seeking for a large variety of video formats and codecs, only limited by CPU and graphics hardware. For professional use, xjadeo honors presentation timecode stamps (PTS) and offsets.

Since monitoring a video is usually an indirect non-interactive task, xjadeo is designed for with remote-control in mind. An Audio Workstation can launch and control the video-monitor. A standalone appliance, for example a projector, can hide xjadeo under the hood, exposing only relevant controls to the user. Nonetheless, direct user-interaction is quite elaborate, but can be disabled or overridden dynamically by a controlling application.

## Getting XJadeo

To acquire xjadeo, please go over to the Download Section.

## Screenshots

Not much to see, really. Xjadeo is at its best when you don't see it! A full-screen display of your movie, or a window with nothing but the asset that you're working with.

## Features

- Full-screen or windowed video-display:

  The default on all platforms is openGL hardware-accelerated display which is screen vertical refresh synchronous. Various fall-back video drivers exist: Xvideo/X11, imlib2/X11, SDL, carbon/quartz.

- Video decoding via FFMPEG:

  Thanks to ffmpeg, xjadeo supports a multitude of file-formats, video codecs and protocols. It is possible to directly read remote files (e.g. via http or rtmp) and supported formats include avi, mpeg, mpegts, mov, mp4, ogg, webm (and at least 200 more). Among the 300+ supported codecs there are mjpeg, mpeg2, mpeg4, h264, vpx8 and theora.

- Sync sources:
  - JACK Transport
  - Midi Timecode (MTC) via ALSA-MIDI, JACK-MIDI or portmidi
  - Linear (or Longitudinal) Timecode (LTC) using JACK-audio

- Frame accuracy:

  Tested with 23.976, 24, 24.976, 25, 29.97df, 30, 59.94 and 60 fps video-files, xjadeo provides for frame accurate playback and random access seeking. Xjadeo also features optional timecode conversion and offset calculation mechanisms.

- Remote-control interface:

  This allows for seamless integration into larger projects and custom artistic use-cases. It is possible to query and modify all settings and parameters of a running instance and override user-interaction.

Xjadeo does not play any audio, nor display more than one file at a given time.

## Using XJadeo

Just launch xjadeo the same way as any other application on your system (double-click or choose from 'applications' menu).

By default it comes up without a video-file and only connects to jack (sync-source) if jackd is already running. To interact with xjadeo, right-click on the window (Windows, Linux) or use the system-wide menu-bar (OSX). For details see section «User Interaction» in the manual.

From the commandline you can simply launch `xjadeo`, optionally specify a video-file as argument. The complete set of options is documented on the man page.

## Made With XJadeo (and Ardour)

- «Marzipan» was the first project ever realized using xjadeo. The movie won a special jury award at the Venice Film Festival in 2006 and the 1st price at the NOFF 2007, in Utrecht, Netherlands.
- «Cronopios and Famas» by Juan Pablo Bouza is the first full feature movie that we know about which used and credited xjadeo.
- Harrison used xjadeo as part of a large-format audio/video playback system for trade show setup.
- Xjadeo played an essential role in the making of Sugartown and Henry John and the Little Bug. Both movies won awards at the HollyShorts festival, Sugartown for Best Music and Sound for Ian Young.
- xjadeo was used for a 8 screen cave performance/installation at the Fondazione Cosso by Autistici.org.
- Kris Limbach from E-19 Studios uses xjadeo exclusively for Postproduction. The portfolio includes a wide variety of exhibitions, movies and commercials.
- xjadeo is the engine behind the Frontera Project.
- ...

Various Post-Prod Houses and Studio use xjadeo as part of their workflow, mainly via integration in the Ardour Video Timeline.

## Community

Xjadeo is under the umbrella of the linux audio consortium. The easiest way to get in touch with fellow users is the LAU (Linux Audio Users) email list. A lot of people with experience including developers are also online on the #ardour and #jack IRC live chat on freenode.org.

You can email the developers personally, but note that the chances of getting a reply quickly is greater if you ask the community at large.

Feature request and bug reports belong on the Issue Tracker which is hosted on github.

## Troubleshoot & Support

In case Xjadeo does not work out of the box..

- Try to play the video-file with another video-player. Check if you can seek that file
- run `xjadeo -v filename` - look for warning and error messages, verify that the detected duration and offset (override with `-I` is correct. In verbose-more (`-v`) xjadeo also prints information about the displayed frame and the timecode-source which might provide a clue to what is going on.
- Try the example video from source-code/contrib/xjadeo-example.avi or validate time-accuracy using time-stamped test videos:
  - HTTP
  - Bittorrent
- Ask for help and share your experience: report the issue that you are having. Please don't hesitate and don't be shy! We do require your feedback to improve xjadeo. Please include the output of xjadeo --version. You can find the issue-tracker at https://github.com/x42/xjadeo/issues.

Some video codecs are known not to work properly on some systems. This is mostly due to different ffmpeg versions, available codecs, etc usually caused by 3rd party builds that have not been rigorously tested. There is little we can do about it. You might be able to work around by transcoding the video into a different format/codec (avi/mjpeg is a good candidate).

To mitigate this issue we provide binary versions with a good, known to work, version of ffmpeg.org. Prefer one of these to distribution provided packages where we can take no responsibility for. (In case you are worried about running untrusted binaries: the source-code includes the complete built-chain to create those binaries in a clean-room (pbuilder) environment from scratch.)

## Developer Information

- Remote Control Interface Documentation
- Open Sound Control Interface Documentation
- Building Xjadeo From Source
- Advanced Features and Artistic Add-ons
- Man page for the remote-control tool

## License

Xjadeo is licensed in terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

© 2006−2014 Robin Gareus <robin@gareus.org>
© 2006−2011 Luis Garrido <luisgarrido@users.sourceforge.net>

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.

The Windows, Apple and Linux names and logos visible on this site are trademarks or registered trademarks in the USA and other countries, respectively of Microsoft, Inc., Apple, Inc., and Linus Torvalds.