]> Shamusworld >> Repos - ardour-manual-diverged/blob - include/video-timeline-setup.html
Move content from _manual/ to include/.
[ardour-manual-diverged] / include / video-timeline-setup.html
1
2 <p>
3   No configuration is required if you intend to run everything on a single 
4   machine, and if you acquired Ardour from 
5   <a href="http://www.ardour.org"
6   title="http://www.ardour.org">http://www.ardour.org</a>.
7   Everything is pre-configured and included with the download/install.
8 </p>
9
10 <h2>Single Machine</h2>
11 <p>
12   If you compile Ardour from source, or have installed it from a 3rd party 
13   repository, three additional tools will need to be installed manually,
14   which are used by Ardour to provide video features:
15 </p> 
16 <ul> 
17   <li>xjadeo (the video monitor application): <a href="http://xjadeo.sourceforge.net/"
18   title="http://xjadeo.sourceforge.net/" rel="nofollow">http://xjadeo.sf.net</a></li>
19   <li>harvid (a video decoder used for the thumbnail timeline): <a
20   href="http://x42.github.io/harvid/" title="http://x42.github.io/harvid/"
21   rel="nofollow">http://x42.github.com/harvid/</a></li> 
22   <li>ffmpeg, ffprobe (used to import/export video, extract soundtracks and 
23   query video information): <a href="http://ffmpeg.org" title="http://ffmpeg.org"
24   rel="nofollow">http://ffmpeg.org</a></li> 
25 </ul>
26 <p>
27   Ardour requires xjadeo &ge; version 0.6.4, harvid &ge; version 0.7.0 and ffmpeg (known to work versions: 1.2, 2.8.2)
28 </p>
29
30 <p>
31   The Ardour development team is in control of the first two applications. ffmpeg
32   however can be a bit of a problem. To avoid conflicts with distribution packages, 
33   Ardour looks for <code>ffmpeg_harvid</code> and <code>ffprobe_harvid</code>.
34 </p>
35 <p>
36   All four applications need to be found in <code>$PATH</code> (e.g. 
37   <code>$HOME/bin</code> or <code>/usr/local/bin</code>). For convenience the 
38   binary releases of harvid include ffmpeg_harvid and ffprobe_harvid, but if 
39   your distribution provides suitable ffmpeg commands you can also just create 
40   symbolic links:
41 </p>
42 <kbd class="cmd lin">sudo ln -s /usr/bin/ffmpeg /usr/bin/ffmpeg_harvid</kbd>
43 <kbd class="cmd lin">sudo ln -s /usr/bin/ffprobe /usr/bin/ffprobe_harvid</kbd>   
44 <p>
45   Binary releases are available from ardour.org as well as an installer script: 
46   <a href="https://github.com/Ardour/ardour/blob/master/tools/videotimeline/install_video_tools.sh" 
47   title="https://github.com/Ardour/ardour/blob/master/tools/videotimeline/install_video_tools.sh"  
48   rel="nofollow">install_video_tools.sh</a>.
49 </p>
50 <p>
51   The easiest way to install the video-utilities is by running the following 
52   line in a terminal:
53 </p>
54 <kbd class="cmd lin">sh -c &quot;$(curl -s -L http://git.io/tVUCkw)&quot;</kbd>
55
56 <h2>Studio Setup</h2>
57 <p>
58   Please read the info in the previous section to familiarize yourself with 
59   the tools involved first. Setting up a proper A/V post-production studio 
60   can be a complicated task. As much as we streamline and simplify the 
61   <em>single machine</em> setup, the <dfn>studio setup</dfn> is focused on modularity.
62 </p>
63
64 <ul class="fixme">
65  <li>TODO:</li>
66  <li>Synchronization ardour → video-display-box should be accomplished by external 
67  means jack-transport(netjack), MTC, LTC 
68  (<abbr title="Open Sound Control - &quot;postmodern MIDI&quot;">OSC</abbr> and/or 
69  ssh-pipe work but introduce additional latency + jitter)</li>
70 <li>Ardour launches <code>XJREMOTE</code> (environment variable, default &#039;xjremote&#039; which comes with xjadeo).
71 </li>
72 <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).
73 </li>
74 <li>..or override xjremote&#039;s behavior – instead of  IPC with a local running xjadeo-process, using <abbr title="Open Sound Control - &quot;postmodern MIDI&quot;">OSC</abbr> 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.
75 </li>
76 <li>If the video server runs remotely, Ardour needs to be configured in Ardour &gt; Preference &gt; Video (hostname of the video-server).
77 </li>
78 <li>
79 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's video-import transcodes the file into a suitable proxy-format that allows reliable seeking to any frame…
80 </li>
81 </ul>
82