]> Shamusworld >> Repos - ardour-manual/blob - include/generic-midi-learn.html
a1e8f8071f319599470260ecd64cfc7eb7f6260a
[ardour-manual] / include / generic-midi-learn.html
1
2 <h2>Philosophy</h2>
3 <p>
4 There are no "best" ways to map an arbitrary MIDI controller for
5 controlling Ardour. There may be very legitimate reasons for different
6 users to prefer quite different mappings.
7 </p>
8 <p>
9 On every platform that Ardour runs on, there are excellent
10 free-of-charge tools for making connections between MIDI hardware and
11 "virtual" MIDI ports like the ones that Ardour creates and
12 uses. Rather than waste precious developer time replicating these
13 connection/patch managers, we prefer to leverage their existence by
14 having users rely on them to actually connect Ardour to other MIDI
15 devices and software. On OS X, we recommend Pete Yandell's MIDI
16 Patchbay. On Linux, a wide variety of tools are available including
17 QJackCtl, aconnect, Patchage, and more.
18 </p>
19
20 <h2>Basics</h2>
21
22 <ol>
23   <li>Enable Generic MIDI control: <kbd class="menu">Edit &gt; Preferences
24   &gt; Control Surfaces &gt; Generic MIDI</kbd></li>
25   <li>Connect Ardour's MIDI port named <samp>control</samp> to whatever
26   hardware or software you want (using a MIDI patchbay app)</li>
27   <li><kbd class="mod1 mouse">Middle</kbd>-click on whatever on-screen
28   fader, plugin parameter control, button etc. you want to control</li>
29   <li>A small window appears that says "Operate Controller now"</li>
30   <li>Move the hardware knob or fader, or press the note/key.</li>
31   <li>The binding is complete. Moving the hardware should control the Ardour fader etc. </li>
32 </ol>
33
34 <h2>Cancelling a Learned MIDI Binding</h2>
35
36 <p>
37   To unlearn a learned MIDI binding, <kbd class="mod1 mouse">Middle</kbd>-click
38   on the control in the same way as you did to learn it in the first place, but
39   click on the popup to cancel it.
40 </p>
41
42 <h2>Avoiding work in the future</h2>
43 <p>
44 If you want the bindings you set up to be used automatically in every
45 session, the simplest thing to do is to use <kbd class="menu">Session &gt; Save
46 Template</kbd>. Then, when creating new sessions, select that template and
47 all the bindings will be automatically set up for you.
48 </p>
49