Shamusworld >> Repos - ardour-manual/blob - _manual/23_video-timeline/01_setup.html

   1 ---
   2 layout: default
   3 title: Video Timeline Setup
   4 ---
   5
   6 <p>
   7 Ardour 3.x requires no configuration if you intend to run everything on a single machine, and if you acquired Ardour 3.x from <a href="http://www.ardour.org" title="http://www.ardour.org"  rel="nofollow">http://www.ardour.org</a>, everything is pre-configured and included with the download/install.
   8 </p>
   9
  10
  11 <h2>Single Machine</h2>
  12
  13 <p>
  14 If you compile Ardour 3.x from source, or have installed it from a 3rd party, additional tools will need to be installed.
  15 </p>
  16
  17 <p>
  18 There are three separate standalone tools involved which are used by Ardour 3.x to provide video facilities.
  19 </p>
  20 <ul>
  21 <li>xjadeo – the video monitor window<a href="http://xjadeo.sf.net" title="http://xjadeo.sf.net"  rel="nofollow">http://xjadeo.sf.net</a>
  22 </li>
  23 <li>harvid – a video decoder used for the thumbnail timeline <a href="http://x42.github.com/harvid/" title="http://x42.github.com/harvid/"  rel="nofollow">http://x42.github.com/harvid/</a>
  24 </li>
  25 <li>ffmpeg, ffprobe – used to import/export video, extract soundtracks and query video information <a href="http://ffmpeg.org" title="http://ffmpeg.org"  rel="nofollow">http://ffmpeg.org</a>
  26 </li>
  27 </ul>
  28
  29 <p>
  30 Ardour 3.x requires xjadeo &gt;= version 0.6.4, harvid &gt;= version 0.7.0 and ffmpeg == 1.2.
  31 </p>
  32
  33 <p>
  34 The ardour-dev team is <em>in control</em> of the first two applications. ffmpeg can be a bit of a problem.
  35 To avoid conflicts with distribution packages, ardour looks for <code>ffmpeg_harvid</code> and <code>ffprobe_harvid</code>.
  36 </p>
  37
  38 <p>
  39 All four applications need to be found in <code>$PATH</code> (e.g. <code>$HOME/bin</code> or <code>/usr/local/bin</code>). For convenience the binary releases of harvid include ffmpeg_harvid and ffprobe_harvid, but if your distribution provides suitable ffmpeg commands you can also just create a symbolic link from ffmpeg → ffmpeg_harvid and ffprobe → ffprobe_harvid.
  40 </p>
  41
  42 <p>
  43 Binary releases are available from ardour.org as well as an installer script: <a href="https://github.com/Ardour/ardour/blob/master/tools/videotimeline/install_video_tools.sh" title="https://github.com/Ardour/ardour/blob/master/tools/videotimeline/install_video_tools.sh"  rel="nofollow">install_video_tools.sh</a>.
  44 </p>
  45
  46 <p>
  47 You can run it directly as:
  48 </p>
  49 <pre class="code">sh -c &quot;$(curl -s -L http://git.io/tVUCkw)&quot;</pre>
  50
  51
  52 <h2>Studio Setup</h2>
  53
  54 <p>
  55 Please read the info in the previous section to familiarize yourself with the tools involved.
  56 Setting up a proper A/V post-production studio can be a complicated task. As much as we streamline and simply the <em>single machine</em> setup, the studio-setup is focused on modularity.
  57 </p>
  58
  59 <p>
  60 <em>TODO</em>
  61 </p>
  62 <ul>
  63 <li>Synchronization ardour → video-display-box should be accomplished by external means jack-transport(netjack), MTC, LTC (<acronym title="Open Sound Control - &quot;postmodern MIDI&quot;">OSC</acronym> and/or ssh-pipe work but introduce additional latency + jitter)
  64 </li>
  65 </ul>
  66 <ul>
  67 <li>Ardour launches <code>XJREMOTE</code> (environment variable, default &#039;xjremote&#039; which comes with xjadeo also on OSX).
  68 </li>
  69 </ul>
  70 <ul>
  71 <li>Either use a custom shell script that ssh&#039;es into the remote box and launches/controls xjadeo there, selects the sync-source and passes though communication between ardour ⇔ xjadeo via ssh (xjadeo is launched stopped with the session).
  72 </li>
  73 </ul>
  74 <ul>
  75 <li>..or override xjremote&#039;s behavior – instead of  IPC with a local running xjadeo-process, using <acronym title="Open Sound Control - &quot;postmodern MIDI&quot;">OSC</acronym> for example. xjadeo would run permanently and ardour will just tell it to load files and set offsets via <acronym title="Open Sound Control - &quot;postmodern MIDI&quot;">OSC</acronym>. see <a href="http://xjadeo.git.sourceforge.net/git/gitweb.cgi?p=xjadeo/xjadeo;a=blob_plain;f=contrib/xjremote-osc" title="http://xjadeo.git.sourceforge.net/git/gitweb.cgi?p=xjadeo/xjadeo;a=blob_plain;f=contrib/xjremote-osc"  rel="nofollow">xjremote-osc</a> example script.
  76 </li>
  77 </ul>
  78 <ul>
  79 <li>If the video server runs remotely, Ardour needs to be configured in Ardour &gt; Preference &gt; Video (hostname of the video-server).
  80 </li>
  81 </ul>
  82
  83 <p>
  84 Ideally the machines have a common shared folder (NFS or similar).  Ardour&#039;s import (audio-extract) and export (mux) functionality depends on having access to the video file.  Also ardour video-import transcodes the file into a suitable proxy-format that allows reliable seeking to any frame…
  85 </p>