]> Shamusworld >> Repos - ardour-manual/blob - include/generic-midi-learn.html
update supported format page
[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
9 <h2>Basics</h2>
10
11 <ol>
12   <li>Enable Generic MIDI control: <kbd class="menu">Edit &gt; Preferences
13   &gt; Control Surfaces &gt; Generic MIDI</kbd></li>
14   <li>Connect Ardour's MIDI port named <samp>control</samp> to whatever
15   hardware or software you want (using a MIDI patchbay app)</li>
16   <li><kbd class="mod1 mouse">Middle</kbd>-click on whatever on-screen
17   fader, plugin parameter control, button etc. you want to control</li>
18   <li>A small window appears that says "Operate Controller now"</li>
19   <li>Move the hardware knob or fader, or press the note/key.</li>
20   <li>The binding is complete. Moving the hardware should control the Ardour fader etc. </li>
21 </ol>
22
23 <p>
24 There's a complication to this story, however. You cannot use MIDI
25 learn with the GUI provided by the plugin. This is true no matter what
26 the plugin format or platform is. When we refer to "whatever on-screen
27 fader ..." above, we are referring to an “Ardour-owned” control of
28 some sort. You can get access to that in one of 3 ways:
29
30 <ul>
31   <li>right click on the processor element in the mixer strip, and choose “Edit with Generic GUI”</li>
32   <li>right click on the processor element in the mixer strip, and from “Controls”, make the desired parameter visible inline in the mixer strip</li>
33   <li>in the editor, click on the “A” (automation) button for the
34   track, find the desired parameter. This will make the automation
35   lane for that parameter visible, and it comes with a fader you can
36     use for MIDI learn.</li>
37 </ul>
38
39 You can’t just “click the GUI” because the plugin owns the GUI, and
40 cannot (and should not) be a part of the MIDI learn process.
41 </p>
42
43 <h2>Cancelling a Learned MIDI Binding</h2>
44
45 <p>
46   To unlearn a learned MIDI binding, <kbd class="mod1 mouse">Middle</kbd>-click
47   on the control in the same way as you did to learn it in the first place, but
48   click on the popup to cancel it.
49 </p>
50
51 <h2>Avoiding work in the future</h2>
52 <p>
53 If you want the bindings you set up to be used automatically in every
54 session, the simplest thing to do is to use <kbd class="menu">Session &gt; Save
55 Template</kbd>. Then, when creating new sessions, select that template and
56 all the bindings will be automatically set up for you.
57 </p>
58