]> Shamusworld >> Repos - ardour-manual/commitdiff
OSC: Reorder chapter to make sense.
authorLen Ovens <len@ovenwerks.net>
Sat, 14 Jan 2017 16:43:09 +0000 (08:43 -0800)
committerLen Ovens <len@ovenwerks.net>
Sat, 14 Jan 2017 16:43:09 +0000 (08:43 -0800)
_manual/23_using-control-surfaces/01_controlling-ardour-with-osc.html
_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/01_osc-control.html [new file with mode: 0644]
_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/02_osc-setup-dialog.html [moved from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/06_osc-setup-dialog.html with 98% similarity]
_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/03_querying-ardour-with-osc.html [moved from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/07_querying-ardour-with-osc.html with 98% similarity]
_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/04_feedback-in-osc.html [moved from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/02_feedback-in-osc.html with 99% similarity]
_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/05_calculating-feedback-and-strip-types-values.html [moved from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html with 96% similarity]
_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/07_parameter-types-in-osc.html [moved from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/04_parameter-types-in-osc.html with 97% similarity]
_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/08_selection-considerations-in-osc.html [moved from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/05_selection-considerations-in-osc.html with 87% similarity]
_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/10_osc-control-in-ardour-4.7-and-prior.html [moved from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/01_osc-control-in-ardour-4.7-and-prior.html with 99% similarity]

index f79afa222f1861c88cd955e401e61d3703e34b76..230b56e2e46fecabff4691171fb2b51eb27daaed 100644 (file)
 ---
 layout: default
 title: Controlling Ardour with OSC
----                        
+---
 
 <p>
-  <abbr title="Open Sound Control"><dfn>OSC</dfn></abbr> lets synthesizers 
-  and other devices communicate with Ardour. OSC devices can send commands 
-  relating to playback (such as play or stop), performance (such as volume, 
+  <abbr title="Open Sound Control"><dfn>OSC</dfn></abbr> lets synthesizers
+  and other devices communicate with Ardour. OSC devices can send commands
+  relating to playback (such as play or stop), performance (such as volume,
   play, stop, and almost any other function (such as Edit, or Undo).
 </p>
 
-<p class="note">
-  <em>Note:</em> OSC control has changed dramatically since Ardour 4.7.
-  The Path structure has been completely redone, Banking has been introduced,
-  The controller is now able to tell Ardour what kind of feedback it can
-  work with (including bank size) and two new math styles have been added
-  to gain controls. If you are using an Ardour version of 4.7 or less,
-  please read <a
-  href="/using-control-surfaces/controlling-ardour-with-osc/osc-control-in-ardour-4.7-and-prior/">
-  Osc control in ardour 4.7 and prior.</a>
-</p>
-
-<p>
-  Ardour is probably one of the most OSC-controllable audio applications 
-  around, but as with all OSC-controllable apps, you can't do much without 
-  knowing what <dfn>messages</dfn> can be sent. This document describes the 
-  various categories of messages that Ardour understands. It is subject to 
-  change, particularly the "Actions" part below, since this relates to the 
-  GTK GUI for Ardour rather than the backend.
-</p>
-
-<h2>Connecting to Ardour via OSC</h2>
-<p>
-  OSC support is not enabled by default, but can be turned on via 
-  <kbd class="menu">Edit &gt; Preferences &gt; Control Surfaces</kbd>. 
-  Once enabled, Ardour will listen on port <code>3819</code> by default. 
-  This port number can be changed by editing <code>$ARDOUR_CONFIG</code> 
-  and adding this line within the <code>&lt;Config&gt;</code> section:
-</p>
-<kbd class="input">&lt;Option name="osc-port" value="<em>Your choice
-here</em>"/&gt;</kbd>
-
-<p>
-  Ardour sends any feedback to the port and address that sent any
-  feedback request. The port does not have to match Ardour's port. In
-  fact it is better not to. This means that Ardour can deal with more
-  than one controller at a time. The two controllers can bank
-  independently and even use different math for faders. This could be
-  used to allow talent to adjust their own monitor mix using a tablet
-  or phone that can run an OSC controller. For a full explanation of
-  how Ardour's feedback works please read <a
-  href="/using-control-surfaces/controlling-ardour-with-osc/feedback-in-osc/">
-  OSC feedback In Ardour.</a>
-</p>
-
-<h2>Control Surface Set Up</h2>
-
-<p>
-  Control surface set up allows the controller to tell Ardour about it's
-  capabilities. The surface can tell Ardour how many control strips it
-  has for banking, if it is capable of setting it's faders or buttons
-  to values set by Ardour's GUI or automation, What kind of math the
-  faders use and more.
-</p>
-<p>
-  Any time the <em>/set_surface</em> command is sent, the current bank
-  is recalculated and if feedback is turned on, the values of each
-  strip's controls are sent (or refreshed) as well. This will also
-  refresh the Master feedback setup.
-</p>
-<p class="note">
-  Surface Port Setting is available in the OSC GUI.
-</p>
-<p>
-  As of Ardour 5.1, There is now a GUI setup in response to those using
-  tablets with applications such as touchOSC or AndrOSC who need to be
-  able to set a port for Ardour to send to. It can also change the
-  default setting for set_surface. For more information about Ardour's
-  OSC configuration GUI please read <a
-  href="/using-control-surfaces/controlling-ardour-with-osc/osc-setup-dialog/">
-  Ardour's Setup Dialog.</a>
-</p>
-<p>If /set_surface is not sent, the default values are used:
-  <ul>
-         <li><em>Bank Size</em>: 0 - No banking (or infinite bank size).</li>
-         <li><em>Strip Types</em>: All strip types except hidden and special.</li>
-         <li><em>Feedback</em>: 0 - All off.</li>
-         <li><em>Fader Mode</em>: 0 - gain in dB (not relevant with feedback off)</li>
-  </ul>
-</p>
-<p>
-  These values give the same behaviour as prior versions of Ardour. (or the closest possible)
-</p>
-<dl class="bindings">
-  <dt><kbd class="osc">/set_surface <em>bank_size</em> <em>strip_types</em>
-  <em>feedback</em> <em>fadermode</em></kbd></dt>
-  <dd>
-         See below for an explanation of each parameter.
-  </dd>
-</dl>
-<h3>bank_size</h3>
-<p>
-  Bank Size is the number of channel strips the controller supports
-  without banking. Setting this to 0 turns banking off by setting the
-  bank size to infinite.
-</p>
-<p class="note">
-       Bank size can also be set with <em>/set_surface/bank_size size.</em>
-</p>
-<h3>strip_types</h3>
-<p>
-  strip_types is an integer made up of bits. The easy way to
-  deal with this is to think of strip_types items being worth a number and
-  then adding all those numbers together for a value to send.
-  Strip Types will determine what kind of strips will be included in
-  bank. This would include: Audio, MIDI, buses, VCAs, Master, Monitor
-  and hidden or selected strips.
-</p>
-<p>
-  Aside from setting the track types for the main mix assignments, using
-  /set_surface/strip_types with more than one surface button will allow
-  switching between modes for example: inputs only, buses only,
-  selected only, hidden only, by having the buttons send values of: 3,
-  12, 256, 512. A full mix button might have a value 31.
-</p>
-<p>
-  While Master and Monitor are listed as possibilities, most surfaces
-  will not use them. Using /master and /monitor makes more sense.
-  However, in the case where there are no master or monitor fader strips
-  on the surface, it may be necessary to include them in the banked
-  strips.
-</p>
-<p>Please see: <a
-  href="/using-control-surfaces/controlling-ardour-with-osc/calculating-feedback-and-strip-types-values/">
-  Calculating Feedback and Strip-types Values.</a>
-</p>
-<p class="note">
-       Strip types can also be set with <em>/set_surface/strip_types types.</em>
-</p>
-<h3>feedback</h3> 
-<p>Feedback is an integer made up of bits. The easy way to
-  deal with this is to think of feedback items being worth a number and
-  then adding all those numbers together for a value to send.
-</p>
-<p>Please see: <a
-  href="/using-control-surfaces/controlling-ardour-with-osc/calculating-feedback-and-strip-types-values/">
-  Calculating Feedback and Strip-types Values.</a></p>
-<p class="note">
-       Feedback can also be set with <em>/set_surface/feedback feedback.</em>
-</p>
-
-<h3>gainmode</h3>
-<p>
-  Gainmode is a an int that acts as a bool:
-  <ul>
-         <li><em>0 (or false)</em> dB value as a float from -193 to +6. Sent as
-         /strip/gain SSID value. (-193 or below are the same as -inf)</li>
-         <li><em>1 (or true)</em> A positional fader based on the same math
-         as Ardour's GUI.  An Float from 0 to 1. Sent as
-         /strip/fader SSID value</li>
-  </ul>
-</p>
-<p>
-  Gainmode applies only to feedback values. The controller can choose
-  which gain math to use by choosing to use the /*/gain or /*/fader path
-  to send to Ardour. This makes sure a controller that doesn't set up
-  Ardour's OSC can still use either math. The gainmode for feedback also
-  determines the path Ardour uses for feedback so that the feedback
-  messages match the control messages.
-</p>
-<p class="note">
-       Gain mode can also be set with <em>/set_surface/gainmode gainmode.</em>
-</p>
-
-<h2>Querying Ardour for information</h2>
-<p>
-  The control Surface may wish to control the type a frequency of
-  updates it receives. It can do this with querying commands. See: <a
-  href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
-  Querying Ardour with OSC.</a>
-</p>
-  
-<h2>List of OSC messages</h2>
-<p class="note">
-       Parameter types show how the value will be used. However, they may
-       be sent as a different type if needed, see: <a
-       href="/using-control-surfaces/controlling-ardour-with-osc/parameter-types-in-osc/">
-       Parameter Types in OSC.</a>
-</p>
-<h3>Master or Global messages</h3>
-
-<h4>Transport Control</h4>
-<dl class="bindings">
-  <dt><kbd class="osc">/transport_stop</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/transport_play</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/toggle_roll</kbd></dt>
-  <dd>Toggles between play and stop</dd>
-  <dt><kbd class="osc">/set_transport_speed <em>s</em></kbd></dt>
-  <dd>where <em>s</em> is a float ranging from -8.0f to 8.0f</dd>
-  <dt><kbd class="osc">/ffwd</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/rewind</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/goto_start</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/goto_end</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/jump_bars <em>bars</em></kbd></dt>
-  <dd>Where <em>bars</em> is a float (+/-) of the number of bars to jump</dd>
-  <dt><kbd class="osc">/jump_seconds <em>seconds</em></kbd></dt>
-  <dd>Where <em>seconds</em> is a float (+/-) of the number of seconds to jump</dd>
-  <dt><kbd class="osc">/add_marker</kbd></dt>
-  <dd>(adds marker to the current transport position)</dd>
-  <dt><kbd class="osc">/remove_marker</kbd></dt>
-  <dd>Removes marker at the current transport position (if there is one)</dd>
-  <dt><kbd class="osc">/mark_in</kbd></dt>
-  <dd>Marks the begining of a range at the current transport position</dd>
-  <dt><kbd class="osc">/mark_out</kbd></dt>
-  <dd>Marks the end of a range at the current transport position</dd>
-  <dt><kbd class="osc">/next_marker</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/prev_marker</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/locate <em>spos</em> <em>roll</em></kbd></dt>
-  <dd>where <em>spos</em> is the target position in samples and
-  <em>roll</em> is a bool/integer defining whether you want transport 
-  to be kept rolling or not</dd>
-  <dt><kbd class="osc">/loop_toggle</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/loop_location <em>start</em> <em>end</em></kbd></dt>
-  <dd><em>start</em> is the beginning of a loop and <em>end</em> is the
-  end of a loop both are integer frame positions.</dd>
-  <dt><kbd class="osc">/set_loop_range</kbd></dt>
-  <dd>Uses edit range as loop range</dd>
-  <dt><kbd class="osc">/set_session_range</kbd></dt>
-  <dd>Uses edit range as session range</dd>
-  <dt><kbd class="osc">/toggle_click</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/midi_panic</kbd></dt>
-  <dd>Ardour will send an all notes off to all midi tracks</dd>
-  <dt><kbd class="osc">/cancel_all_solos</kbd></dt>
-  <dd>Cancel All Solos/PFLs/AFLs</dd>
-</dl>
-
-<h4>Transport Information</h4>
-<dl>
-  <dt><kbd class="osc">/transport_frame</kbd></dt>
-  <dd>Ardour sends /transport_frame <em>current_frame</em></dd>
-  <dt><kbd class="osc">/transport_speed</kbd></dt>
-  <dd>Ardour sends /transport_speed <em>speed</em></dd>
-  <dt><kbd class="osc">/record_enabled</kbd></dt>
-  <dd>Ardour sends /record_enabled <em>recordenable_status</em></dd>
-</dl>
-
-<h4>Editing-related</h4>
-<dl class="bindings">
-  <dt><kbd class="osc">/undo</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/redo</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/save_state</kbd></dt>
-  <dd>(this is the regular <kbd class="menu">Session &gt; Save</kbd>
-  operation)</dd>
-  <dt><kbd class="osc">/quick_snapshot_switch</kbd></dt>
-  <dd>Take a snapshot and switch to new version</dd>
-  <dt><kbd class="osc">/quick_snapshot_stay</kbd></dt>
-  <dd>Take a snapshot and keep working on this version</dd>
-  <dt><kbd class="osc">/fit_*_track(s)</kbd></dt>
-  <dd>Were <em>*</em> is one of 1, 2, 4, 8, 16, 32 or all. Fits this
-  many tracks in editor window. (add s for more than 1)</dd>
-  <dt><kbd class="osc">/zoom_*</kbd></dt>
-  <dd>Zoom editor to include <em>*</em> where <em>*</em> is 100_ms, 1_sec,
-  10_sec, 1_min, 5_min, 10_min or to_session</dd>
-  <dt><kbd class="osc">/temporal_zoom_in</kbd></dt>
-  <dd>Zoom editor in to show less time</dd>
-  <dt><kbd class="osc">/temporal_zoom_out</kbd></dt>
-  <dd>Zoom editor out to show more time</dd>
-  <dt><kbd class="osc">/scroll_up_1_track</kbd></dt>
-  <dd>Scroll the editor pane up 1 track</dd>
-  <dt><kbd class="osc">/scroll_up_1_page</kbd></dt>
-  <dd>Scroll the editor pane up 1 page</dd>
-  <dt><kbd class="osc">/scroll_dn_1_track</kbd></dt>
-  <dd>Scroll the editor pane down 1 track</dd>
-  <dt><kbd class="osc">/scroll_dn_1_page</kbd></dt>
-  <dd>Scroll the editor pane down 1 page</dd>
-</dl>
-
-<h4>Recording control</h4>
-<dl class="bindings">
-  <dt><kbd class="osc">/toggle_punch_in</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/toggle_punch_out</kbd></dt>
-  <dd></dd>
-  <dt><kbd class="osc">/set_punch_range</kbd></dt>
-  <dd>Uses edit range as punch range</dd>
-  <dt><kbd class="osc">/rec_enable_toggle</kbd></dt>
-  <dd></dd>
-  <!--dt><kbd class="osc">/toggle_all_rec_enables</kbd></dt>
-  <dd>(toggles all tracks' recording state)</dd-->
-  <dt><kbd class="osc">/stop_forget</kbd></dt>
-  <dd>Stop transport and delete/forget last take</dd>
-</dl>
-
-<h4>Master and Monitor strip control</h4>
-<dl class="bindings">
-  <dt><kbd class="osc">/master/gain <em>dB</em></kbd></dt>
-  <dd>See gain in strips</dd>
-  <dt><kbd class="osc">/master/fader  <em>position</em></kbd></dt>
-  <dd>See fader in strips</dd>
-  <dt><kbd class="osc">/master/trimdB <em>dB</em></kbd></dt>
-  <dd>see trimdb in strips</dd>
-  <dt><kbd class="osc">/master/pan_stereo_position <em>position</em></kbd></dt>
-  <dd>See pan_stereo_position in strips</dd>
-  <dt><kbd class="osc">/master/mute  <em>yn</em></kbd></dt>
-  <dd>See mute in strips</dd>
-  <dt><kbd class="osc">/monitor/gain <em>dB</em></kbd></dt>
-  <dd>See gain in strips</dd>
-  <dt><kbd class="osc">/monitor/fader  <em>position</em></kbd></dt>
-  <dd>See fader in strips</dd>
-</dl>
-
-<h3>Track specific operations</h3>
-<p>
-  For each of the following, <em>ssid</em> is the Surface Strip ID for the track
-</p>
-<p class="note">
-  SSID has a different meaning than RID in Ardour version 4.7 and before.
-  Effectively, banking is always being used and the SSID is generated on
-  the fly. The SSID is the position of the strip within bank as an int
-  1 to bank size. There are no gaps as there have been in the past.
-  Depending on the value of strip_types sent to Ardour, Master and
-  Monitor, may be included in the list of SSIDs or not as set in
-  <em>/set_surface</em>.
-</p>
-<p class="note">
-  Some Surfaces (many Android applets) are not able to deal with more
-  than one parameter in a command. However, the two parameter commands
-  below can also be sent as /strip/command/ssid param. In this case the
-  param should be a float even if an int is required below.
-</p>
-<dl class="bindings">
-  <dt><kbd class="osc">/bank_up </kbd></dt>
-  <dd>Change bank to the next higher bank.</dd>
-  <dt><kbd class="osc">/bank_down </kbd></dt>
-  <dd>Change bank to the next lower bank.</dd>
-  <dt><kbd class="osc">/strip/mute <em>ssid</em> <em>mute_st</em></kbd></dt>
-  <dd>where <em>mute_st</em> is a bool/int representing the desired mute state of the track</dd>
-  <dt><kbd class="osc">/strip/solo <em>ssid</em> <em>solo_st</em></kbd></dt>
-  <dd>where <em>solo_st</em> is a bool/int representing the desired solo state of the track</dd>
-  <dt><kbd class="osc">/strip/solo_iso <em>ssid</em> <em>state</em></kbd></dt>
-  <dd>where <em>state</em> is a bool/int representing the desired solo isolate state of the track</dd>
-  <dt><kbd class="osc">/strip/solo_safe <em>ssid</em> <em>state</em></kbd></dt>
-  <dd>where <em>state</em> is a bool/int representing the desired solo safe/lock state of the track</dd>
-  <dt><kbd class="osc">/strip/monitor_input <em>ssid</em> <em>monitor_st</em></kbd></dt>
-  <dd>where <em>monitor_st</em> is a bool/int where 1 is forced input monitoring.</dd>
-  <dt><kbd class="osc">/strip/monitor_disk <em>ssid</em> <em>monitor_st</em></kbd></dt>
-  <dd>where <em>monitor_st</em> is a bool/int where 1 is forced disk monitoring. When input and disk are both off, 
-  Auto monitoring is enabled.</dd>
-  <dt><kbd class="osc">/strip/recenable <em>ssid</em> <em>rec_st</em></kbd></dt>
-  <dd>where <em>rec_st</em> is a bool/int representing the desired rec state of the track</dd>
-  <dt><kbd class="osc">/strip/record_safe <em>ssid</em> <em>rec_st</em></kbd></dt>
-  <dd>where <em>rec_st</em> is a bool/int representing the desired record safe state of the track</dd>
-  <dt><kbd class="osc">/strip/polarity <em>ssid</em> <em>invert</em></kbd></dt>
-  <dd>where <em>invert</em> is a bool/int representing the desired polarity of the track</dd>
-  <dt><kbd class="osc">/strip/gain <em>ssid</em>  <em>gain</em></kbd></dt>
-  <dd>where <em>gain</em> is a float ranging from -193 to 6 representing the desired gain of the track in dB.</dd>
-  <dt><kbd class="osc">/strip/fader <em>ssid</em>  <em>position</em></kbd></dt>
-  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the fader control position.</dd>
-  <dt><kbd class="osc">/strip/trimdB <em>ssid</em>  <em>trim_db</em></kbd></dt>
-  <dd>where <em>trim_db</em> is a float ranging from -20 to 20 representing the desired trim of the track in dB.</dd>
-  <dt><kbd class="osc">/strip/pan_stereo_position <em>ssid</em> <em>position</em></kbd></dt>
-  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired pan position of the track</dd>
-  <dt><kbd class="osc">/strip/pan_stereo_width <em>ssid</em> <em>width</em></kbd></dt>
-  <dd>where <em>width</em> is a float ranging from 0 to 1 representing the desired pan width of the track</dd>
-  <dt><kbd class="osc">/strip/send/gain <em>ssid</em> <em>sendid</em> <em>send_gain</em></kbd></dt>
-  <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
-  ranging from -193 to +6 representing the desired gain in dB for the send</dd>
-  <dt><kbd class="osc">/strip/send/fader <em>ssid</em> <em>sendid</em> <em>send_gain</em></kbd></dt>
-  <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
-  ranging from 0 to 1 representing the desired position for the send as a fader</dd>
-  <dt><kbd class="osc">/strip/send/enable <em>ssid</em> <em>sendid</em> <em>state</em></kbd></dt>
-  <dd>where <em>sendid</em> = nth_send, <em>state</em> is 1 for enabled and 0 for disabled</dd>
-  <dt><kbd class="osc">/strip/list </kbd></dt>
-  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
-  Querying Ardour with OSC.</a></dd>
-  <dt><kbd class="osc">/strip/sends <em>ssid</em></kbd></dt>
-  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
-  Querying Ardour with OSC.</a></dd>
-  <dt><kbd class="osc">/strip/receives <em>ssid</em></kbd></dt>
-  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
-  Querying Ardour with OSC.</a></dd>
-  <dt><kbd class="osc">/strip/plugin/list <em>ssid</em></kbd></dt>
-  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
-  Querying Ardour with OSC.</a></dd>
-  <dt><kbd class="osc">/strip/plugin/descriptor <em>ssid</em></kbd></dt>
-  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
-  Querying Ardour with OSC.</a></dd>
-  <dt><kbd class="osc">/strip/plugin/reset <em>ssid</em> <em>piid</em> </kbd></dt>
-  <dd>where <em>piid</em> = nth Plugin, will reset all values to the plugin's original values</dd>
-  <dt><kbd class="osc">/strip/plugin/activate <em>ssid</em> <em>piid</em> </kbd></dt>
-  <dd>where <em>piid</em> = nth Plugin, will set the plugin's state to active</dd>
-  <dt><kbd class="osc">/strip/plugin/deactivate <em>ssid</em> <em>piid</em> </kbd></dt>
-  <dd>where <em>piid</em> = nth Plugin, will set the plugin's state to inactive</dd>
-  <dt><kbd class="osc">/strip/plugin/parameter <em>ssid</em> <em>piid</em> <em>param</em> <em>value</em></kbd></dt>
-  <dd>where <em>piid</em> = nth Plugin, <em>param</em> = nth param, <em>value</em>
-  is a float ranging from 0 to 1 representing the desired parameter value</dd>
-  <dt><kbd class="osc">/strip/name <em>ssid</em> <em>name</em></kbd></dt>
-  <dd>where <em>name</em> is a string for the desired name of the track</dd>
-</dl>
-<h3>Selected Strip Operations</h3>
-<p>
-  New for Ardour 5, A whole set of operations that work on the selected
-  or expanded strip.
-</p>
-<p class="note">
-  Selected strip operations are complex enough for their own page.
-  Please read: <a
-  href="/using-control-surfaces/controlling-ardour-with-osc/selection-considerations-in-osc/">
-  Selection Considerations in OSC.</a> This is most important if more
-  than one OSC surface is being used with Ardour.
-</p>
-<p>
-  There are two kinds of selection in OSC. GUI selection and local
-  expansion. By default expansion follows selection.
-  <ul>
-       <li>
-               GUI selection: Use <em>/strip/select</em> to set.  Selecting
-               a strip in the GUI will set OSC surface select and the surface
-               will set GUI selection as well.
-       </li>
-       <li>
-               Local expansion: Use <em>/strip/expand</em> to expand a strip
-               without changing overall selection. When /strip/expand is set
-               to 0 or false, the select channel will go back to using the
-               strip selected by the GUI. While expand is turned on,
-               selecting a strip on the GUI does not
-               select the OSC strip. Sending a /strip/select message will
-               override the expand as if it had been set to false.
-               Good for more than one OSC controller at a time.
-       </li>
-  </ul>
-</p>
-
-<dl class="bindings">
-  <dt><kbd class="osc">/strip/select <em>ssid</em> <em>y/n</em></kbd></dt>
-  <dd>Where <em>y/n</em> = 1 for select. Sets both GUI select and strip
-  to expanded mode. (0 is ignored)</dd>
-  <dt><kbd class="osc">/strip/expand <em>ssid</em> <em>y/n</em></kbd></dt>
-  <dd>Where <em>y/n</em> = 1 for expanded mode. Sets only local strip to
-  Expanded. Setting to 0 resets the expansion to follow selection.</dd>
-  <dt><kbd class="osc">/select/expand <em>y/n</em></kbd></dt>
-  <dd>Where <em>y/n</em> = 1 for expanded mode, 0 for Select mode.</dd>
-  <dt><kbd class="osc">/select/recenable <em>y/n</em></kbd></dt>
-  <dd>Where <em>y/n</em> is 1 for enabled and 0 for disabled</dd>
-  <dt><kbd class="osc">/select/record_safe <em>y/n</em></kbd></dt>
-  <dd>Where <em>y/n</em> is 1 for safe and 0 for unlocked</dd>
-  <dt><kbd class="osc">/select/mute <em>y/n</em></kbd></dt>
-  <dd>Where <em>y/n</em> is 1 for enabled and 0 for disabled</dd>
-  <dt><kbd class="osc">/select/solo <em>y/n</em></kbd></dt>
-  <dd>Where <em>y/n</em> is 1 for enabled and 0 for disabled</dd>
-  <dt><kbd class="osc">/select/solo_iso <em>state</em></kbd></dt>
-  <dd>where <em>state</em> is a bool/int representing the desired solo isolate state of the track</dd>
-  <dt><kbd class="osc">/select/solo_safe <em>state</em></kbd></dt>
-  <dd>where <em>state</em> is a bool/int representing the desired solo safe/lock state of the track</dd>
-  <dt><kbd class="osc">/select/monitor_input <em>y/n</em></kbd></dt>
-  <dd>Where <em>y/n</em> is 1 for monitor from input and 0 for auto</dd>
-  <dt><kbd class="osc">/select/monitor_disk <em>y/n</em></kbd></dt>
-  <dd>Where <em>y/n</em> is 1 for monitor from disk and 0 for auto</dd>
-  <dt><kbd class="osc">/select/polarity <em>invert</em></kbd></dt>
-  <dd>where <em>invert</em> is a bool/int representing the desired polarity of the track</dd>
-  <dt><kbd class="osc">/select/gain <em>gain</em></kbd></dt>
-  <dd>Where <em>gain</em> is a float ranging from -193 to 6 representing the desired gain of the track in dB.</dd>
-  <dt><kbd class="osc">/select/fader <em>position</em></kbd></dt>
-  <dd>Where <em>position</em> is an float ranging from 0 to 1 representing the fader control position.</dd>
-  <dt><kbd class="osc">/select/trimdB <em>trim_db</em></kbd></dt>
-  <dd>where <em>trim_db</em> is a float ranging from -20 to 20 representing the desired trim of the track in dB.</dd>
-  <dt><kbd class="osc">/select/pan_stereo_position <em>position</em></kbd></dt>
-  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired pan position of the track</dd>
-  <dt><kbd class="osc">/select/pan_stereo_width <em>width</em></kbd></dt>
-  <dd>where <em>width</em> is a float ranging from 0 to 1 representing the desired pan width of the track</dd>
-  <dt><kbd class="osc">/select/pan_elevation_position <em>position</em></kbd></dt>
-  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired pan elevation of the track</dd>
-  <dt><kbd class="osc">/select/pan_frontback_position <em>position</em></kbd></dt>
-  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired front to back position of the track</dd>
-  <dt><kbd class="osc">/select/pan_lfe_control <em>value</em></kbd></dt>
-  <dd>where <em>value</em> is a float ranging from 0 to 1 representing the desired LFE control value for the track</dd>
-  <dt><kbd class="osc">/select/send_gain", <em>sendid</em> <em>send_gain</em></kbd></dt>
-  <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
-  ranging from -193 to +6 representing the desired gain in dB for the send</dd>
-  <dt><kbd class="osc">/select/send_fader", <em>sendid</em> <em>send_gain</em></kbd></dt>
-  <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
-  ranging from 0 to 1 representing the desired position for the send as a fader</dd>
-  <dt><kbd class="osc">/select/send_enable", <em>sendid</em> <em>state</em></kbd></dt>
-  <dd>where <em>sendid</em> = nth_send, <em>state</em> is 1 for enabled and 0 for disabled</dd>
-</dl>
-
-<h3>Menu actions</h3>
-<p>
-  Every single menu item in Ardour's GUI is accessible via OSC. There is
-  a single common syntax to trigger the action as if it was selected
-  with the mouse (or keyboard):</p>
-<kbd class="osc">/access_action <em>action_name</em></kbd>
-<p>
-  The list below shows all available values of <em>action-name</em> as of
-  June 2016 for Ardour 5.0.pre0.1. You can get the current list at any
-  time by running Ardour with the -b flag.
-  </p>
-<dl class="bindings">
-       <dt><strong>Action Name</strong></dt><dd><strong>Menu Name</strong></dd>
-  <!-- ProcessorMenu - ok -->
-  <dt><kbd class="osc">ProcessorMenu/ab_plugins</kbd></dt><dd>A/B Plugins</dd>
-  <dt><kbd class="osc">ProcessorMenu/activate_all</kbd></dt><dd>Activate All</dd>
-  <dt><kbd class="osc">ProcessorMenu/clear</kbd></dt><dd>Clear (all)</dd>
-  <dt><kbd class="osc">ProcessorMenu/clear_post</kbd></dt><dd>Clear (post-fader)</dd>
-  <dt><kbd class="osc">ProcessorMenu/clear_pre</kbd></dt><dd>Clear (pre-fader)</dd>
-  <dt><kbd class="osc">ProcessorMenu/controls</kbd></dt><dd>Controls</dd>
-  <dt><kbd class="osc">ProcessorMenu/copy</kbd></dt><dd>Copy</dd>
-  <dt><kbd class="osc">ProcessorMenu/cut</kbd></dt><dd>Cut</dd>
-  <dt><kbd class="osc">ProcessorMenu/deactivate_all</kbd></dt><dd>Deactivate All</dd>
-  <dt><kbd class="osc">ProcessorMenu/delete</kbd></dt><dd>Delete</dd>
-  <dt><kbd class="osc">ProcessorMenu/deselectall</kbd></dt><dd>Deselect All</dd>
-  <dt><kbd class="osc">ProcessorMenu/edit-generic</kbd></dt><dd>Edit with generic controls...</dd>
-  <dt><kbd class="osc">ProcessorMenu/edit</kbd></dt><dd>Edit...</dd>
-  <dt><kbd class="osc">ProcessorMenu/newaux</kbd></dt><dd>New Aux Send ...</dd>
-  <dt><kbd class="osc">ProcessorMenu/newinsert</kbd></dt><dd>New Insert</dd>
-  <dt><kbd class="osc">ProcessorMenu/newplugin</kbd></dt><dd>New Plugin</dd>
-  <dt><kbd class="osc">ProcessorMenu/newsend</kbd></dt><dd>New External Send ...</dd>
-  <dt><kbd class="osc">ProcessorMenu/paste</kbd></dt><dd>Paste</dd>
-  <dt><kbd class="osc">ProcessorMenu/rename</kbd></dt><dd>Rename</dd>
-  <dt><kbd class="osc">ProcessorMenu/selectall</kbd></dt><dd>Select All</dd>
-  <dt><kbd class="osc">ProcessorMenu/send_options</kbd></dt><dd>Send Options</dd>
-  <!-- Common - updated -->
-  <dt><kbd class="osc">Common/Hide</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/NewMIDITracer</kbd></dt><dd>MIDI Tracer</dd>
-  <dt><kbd class="osc">Common/Quit</kbd></dt><dd>Quit</dd>
-  <dt><kbd class="osc">Common/Save</kbd></dt><dd>Save</dd>
-  <dt><kbd class="osc">Common/ToggleMaximalEditor</kbd></dt><dd>Maximize Editor Space</dd>
-  <dt><kbd class="osc">Common/ToggleMaximalMixer</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/ToggleMixerList</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/ToggleMonitorSection</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack10</kbd></dt><dd>Toggle Record Enable Track 10</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack11</kbd></dt><dd>Toggle Record Enable Track 11</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack12</kbd></dt><dd>Toggle Record Enable Track 12</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack13</kbd></dt><dd>Toggle Record Enable Track 13</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack14</kbd></dt><dd>Toggle Record Enable Track 14</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack15</kbd></dt><dd>Toggle Record Enable Track 15</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack16</kbd></dt><dd>Toggle Record Enable Track 16</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack17</kbd></dt><dd>Toggle Record Enable Track 17</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack18</kbd></dt><dd>Toggle Record Enable Track 18</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack19</kbd></dt><dd>Toggle Record Enable Track 19</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack1</kbd></dt><dd>Toggle Record Enable Track 1</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack20</kbd></dt><dd>Toggle Record Enable Track 20</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack21</kbd></dt><dd>Toggle Record Enable Track 21</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack22</kbd></dt><dd>Toggle Record Enable Track 22</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack23</kbd></dt><dd>Toggle Record Enable Track 23</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack24</kbd></dt><dd>Toggle Record Enable Track 24</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack25</kbd></dt><dd>Toggle Record Enable Track 25</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack26</kbd></dt><dd>Toggle Record Enable Track 26</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack27</kbd></dt><dd>Toggle Record Enable Track 27</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack28</kbd></dt><dd>Toggle Record Enable Track 28</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack29</kbd></dt><dd>Toggle Record Enable Track 29</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack2</kbd></dt><dd>Toggle Record Enable Track 2</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack30</kbd></dt><dd>Toggle Record Enable Track 30</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack31</kbd></dt><dd>Toggle Record Enable Track 31</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack32</kbd></dt><dd>Toggle Record Enable Track 32</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack3</kbd></dt><dd>Toggle Record Enable Track 3</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack4</kbd></dt><dd>Toggle Record Enable Track 4</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack5</kbd></dt><dd>Toggle Record Enable Track 5</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack6</kbd></dt><dd>Toggle Record Enable Track 6</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack7</kbd></dt><dd>Toggle Record Enable Track 7</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack8</kbd></dt><dd>Toggle Record Enable Track 8</dd>
-  <dt><kbd class="osc">Common/ToggleRecordEnableTrack9</kbd></dt><dd>Toggle Record Enable Track 9</dd>
-  <dt><kbd class="osc">Common/attach-editor</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/attach-mixer</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/attach-preferences</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/change-editor-visibility</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/change-mixer-visibility</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/change-preferences-visibility</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/Chat</kbd></dt><dd>Chat</dd>
-  <dt><kbd class="osc">Common/cheat-sheet</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/detach-editor</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/detach-mixer</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/detach-preferences</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/forums</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/hide-editor</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/hide-mixer</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/hide-preferences</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/howto-report</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/key-change-editor-visibility</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/key-change-mixer-visibility</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/key-change-preferences-visibility</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/Manual</kbd></dt><dd>Manual</dd>
-  <dt><kbd class="osc">Common/menu-show-preferences</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/next-tab</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/previous-tab</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/Reference</kbd></dt><dd>Reference</dd>
-  <dt><kbd class="osc">Common/show-editor</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/show-mixer</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/show-preferences</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/toggle-editor-mixer</kbd></dt><dd>Toggle Editor+Mixer</dd>
-  <dt><kbd class="osc">Common/toggle-luawindow</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/toggle-meterbridge</kbd></dt><dd>Meterbridge</dd>
-  <dt><kbd class="osc">Common/tracker</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/website</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Common/website-dev</kbd></dt><dd></dd>
-  <!-- MIDI - updated-->
-  <dt><kbd class="osc">MIDI/panic</kbd></dt><dd>Panic</dd>
-  <!-- Main - updated -->
-  <dt><kbd class="osc">Main/AddLuaScript</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/AddTrackBus</kbd></dt><dd>Add Track or Bus...</dd>
-  <dt><kbd class="osc">Main/CleanupPeakFiles</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/CleanupUnused</kbd></dt><dd>Clean-up Unused Sources...</dd>
-  <dt><kbd class="osc">Main/Close</kbd></dt><dd>Close</dd>
-  <dt><kbd class="osc">Main/CloseVideo</kbd></dt><dd>Remove Video</dd>
-  <dt><kbd class="osc">Main/EditMetadata</kbd></dt><dd>Edit Metadata...</dd>
-  <dt><kbd class="osc">Main/Escape</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/ExportAudio</kbd></dt><dd>Export To Audio File(s)...</dd>
-  <dt><kbd class="osc">Main/Export</kbd></dt><dd>Export</dd>
-  <dt><kbd class="osc">Main/ExportVideo</kbd></dt><dd>Export To Video File</dd>
-  <dt><kbd class="osc">Main/FlushWastebasket</kbd></dt><dd>Flush Wastebasket</dd>
-  <dt><kbd class="osc">Main/ImportMetadata</kbd></dt><dd>Import Metadata...</dd>
-  <dt><kbd class="osc">Main/Metadata</kbd></dt><dd>Metadata</dd>
-  <dt><kbd class="osc">Main/New</kbd></dt><dd>New...</dd>
-  <dt><kbd class="osc">Main/Open</kbd></dt><dd>Open...</dd>
-  <dt><kbd class="osc">Main/OpenVideo</kbd></dt><dd>Open Video</dd>
-  <dt><kbd class="osc">Main/QuickSnapshotStay</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/QuickSnapshotSwitch</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/Recent</kbd></dt><dd>Recent...</dd>
-  <dt><kbd class="osc">Main/RemoveLuaScript</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/Rename</kbd></dt><dd>Rename...</dd>
-  <dt><kbd class="osc">Main/SaveAs</kbd></dt><dd>Save As...</dd>
-  <dt><kbd class="osc">Main/SaveTemplate</kbd></dt><dd>Save Template...</dd>
-  <dt><kbd class="osc">Main/Scripting</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/SnapshotStay</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/SnapshotSwitch</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/StemExport</kbd></dt><dd>Stem export...</dd>
-  <dt><kbd class="osc">Main/cancel-solo</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main/duplicate-routes</kbd></dt><dd></dd>
-  <!-- Main_menu - updated -->
-  <dt><kbd class="osc">Main_menu/AudioFileFormatData</kbd></dt><dd>Sample Format</dd>
-  <dt><kbd class="osc">Main_menu/AudioFileFormatHeader</kbd></dt><dd>File Type</dd>
-  <dt><kbd class="osc">Main_menu/AudioFileFormat</kbd></dt><dd>Audio File Format</dd>
-  <dt><kbd class="osc">Main_menu/Cleanup</kbd></dt><dd>Clean-up</dd>
-  <dt><kbd class="osc">Main_menu/ControlSurfaces</kbd></dt><dd>Control Surfaces</dd>
-  <dt><kbd class="osc">Main_menu/Denormals</kbd></dt><dd>Denormal Handling</dd>
-  <dt><kbd class="osc">Main_menu/Help</kbd></dt><dd>Help</dd>
-  <dt><kbd class="osc">Main_menu/KeyMouseActions</kbd></dt><dd>Misc. Shortcuts</dd>
-  <dt><kbd class="osc">Main_menu/MeteringFallOffRate</kbd></dt><dd>Fall Off Rate</dd>
-  <dt><kbd class="osc">Main_menu/MeteringHoldTime</kbd></dt><dd>Hold Time</dd>
-  <dt><kbd class="osc">Main_menu/Metering</kbd></dt><dd>Metering</dd>
-  <dt><kbd class="osc">Main_menu/MixerMenu</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main_menu/Plugins</kbd></dt><dd>Plugins</dd>
-  <dt><kbd class="osc">Main_menu/PrefsMenu</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Main_menu/Session</kbd></dt><dd>Session</dd>
-  <dt><kbd class="osc">Main_menu/Sync</kbd></dt><dd>Sync</dd>
-  <dt><kbd class="osc">Main_menu/TransportOptions</kbd></dt><dd>Options</dd>
-  <dt><kbd class="osc">Main_menu/WindowMenu</kbd></dt><dd>Window</dd>
-  <!-- Options -->
-  <dt><kbd class="osc">options/SendMidiClock</kbd></dt><dd>Send MIDI Clock</dd>
-  <dt><kbd class="osc">options/SendMIDIfeedback</kbd></dt><dd>Send MIDI Feedback</dd>
-  <dt><kbd class="osc">options/SendMMC</kbd></dt><dd>Send MMC</dd>
-  <dt><kbd class="osc">options/SendMTC</kbd></dt><dd>Send MTC</dd>
-  <dt><kbd class="osc">options/UseMMC</kbd></dt><dd>Use MMC</dd>
-  <!-- Transport -->
-  <dt><kbd class="osc">Transport/ForwardFast</kbd></dt><dd>Forward (Fast)</dd>
-  <dt><kbd class="osc">Transport/Forward</kbd></dt><dd>Forward</dd>
-  <dt><kbd class="osc">Transport/ForwardSlow</kbd></dt><dd>Forward (Slow)</dd>
-  <dt><kbd class="osc">Transport/GotoEnd</kbd></dt><dd>Goto End</dd>
-  <dt><kbd class="osc">Transport/GotoStart</kbd></dt><dd>Goto Start</dd>
-  <dt><kbd class="osc">Transport/GotoWallClock</kbd></dt><dd>Goto Wall Clock</dd>
-  <dt><kbd class="osc">Transport/GotoZero</kbd></dt><dd>Goto Zero</dd>
-  <dt><kbd class="osc">Transport/Loop</kbd></dt><dd>Play Loop Range</dd>
-  <dt><kbd class="osc">Transport/PlayPreroll</kbd></dt><dd>Play Selection w/Preroll</dd>
-  <dt><kbd class="osc">Transport/PlaySelection</kbd></dt><dd>Play Selected Range</dd>
-  <dt><kbd class="osc">Transport/Record</kbd></dt><dd>Enable Record</dd>
-  <dt><kbd class="osc">Transport/RewindFast</kbd></dt><dd>Rewind (Fast)</dd>
-  <dt><kbd class="osc">Transport/Rewind</kbd></dt><dd>Rewind</dd>
-  <dt><kbd class="osc">Transport/RewindSlow</kbd></dt><dd>Rewind (Slow)</dd>
-  <dt><kbd class="osc">Transport/Roll</kbd></dt><dd>Roll</dd>
-  <dt><kbd class="osc">Transport/Stop</kbd></dt><dd>Stop</dd>
-  <dt><kbd class="osc">Transport/ToggleAutoInput</kbd></dt><dd>Auto Input</dd>
-  <dt><kbd class="osc">Transport/ToggleAutoPlay</kbd></dt><dd>Auto Play</dd>
-  <dt><kbd class="osc">Transport/ToggleAutoReturn</kbd></dt><dd>Auto Return</dd>
-  <dt><kbd class="osc">Transport/ToggleClick</kbd></dt><dd>Click</dd>
-  <dt><kbd class="osc">Transport/ToggleExternalSync</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/ToggleFollowEdits</kbd></dt><dd>Follow Edits</dd>
-  <dt><kbd class="osc">Transport/TogglePunchIn</kbd></dt><dd>Punch In</dd>
-  <dt><kbd class="osc">Transport/TogglePunch</kbd></dt><dd>Punch In/Out</dd>
-  <dt><kbd class="osc">Transport/TogglePunchOut</kbd></dt><dd>Punch Out</dd>
-  <dt><kbd class="osc">Transport/ToggleRollForgetCapture</kbd></dt><dd>Stop and Forget Capture</dd>
-  <dt><kbd class="osc">Transport/ToggleRoll</kbd></dt><dd>Start/Stop</dd>
-  <dt><kbd class="osc">Transport/ToggleRollMaybe</kbd></dt><dd>Start/Continue/Stop</dd>
-  <dt><kbd class="osc">Transport/ToggleTimeMaster</kbd></dt><dd>Time Master</dd>
-  <dt><kbd class="osc">Transport/ToggleVideoSync</kbd></dt><dd>Sync Startup to Video</dd>
-  <dt><kbd class="osc">Transport/TransitionToReverse</kbd></dt><dd>Transition To Reverse</dd>
-  <dt><kbd class="osc">Transport/TransitionToRoll</kbd></dt><dd>Transition To Roll</dd>
-  <dt><kbd class="osc">Transport/Transport</kbd></dt><dd>Transport</dd>
-  <dt><kbd class="osc">Transport/alternate-GotoStart</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/alternate-ToggleRoll</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/alternate-numpad-decimal</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/alternate-record-roll</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/focus-on-clock</kbd></dt><dd>Focus On Clock</dd>
-  <dt><kbd class="osc">Transport/numpad-0</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-1</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-2</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-3</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-4</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-5</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-6</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-7</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-8</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-9</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/numpad-decimal</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Transport/primary-clock-bbt</kbd></dt><dd>Bars & Beats</dd>
-  <dt><kbd class="osc">Transport/primary-clock-minsec</kbd></dt><dd>Minutes & Seconds</dd>
-  <dt><kbd class="osc">Transport/primary-clock-samples</kbd></dt><dd>Samples</dd>
-  <dt><kbd class="osc">Transport/primary-clock-timecode</kbd></dt><dd>Timecode</dd>
-  <dt><kbd class="osc">Transport/record-roll</kbd></dt><dd>Start Recording</dd>
-  <dt><kbd class="osc">Transport/secondary-clock-bbt</kbd></dt><dd>Bars & Beats</dd>
-  <dt><kbd class="osc">Transport/secondary-clock-minsec</kbd></dt><dd>Minutes & Seconds</dd>
-  <dt><kbd class="osc">Transport/secondary-clock-samples</kbd></dt><dd>Samples</dd>
-  <dt><kbd class="osc">Transport/secondary-clock-timecode</kbd></dt><dd>Timecode</dd>
-  <!-- WIndow -->
-  <dt><kbd class="osc">Window/toggle-about</kbd></dt><dd>About</dd>
-  <dt><kbd class="osc">Window/toggle-add-routes</kbd></dt><dd>Add Tracks/Busses</dd>
-  <dt><kbd class="osc">Window/toggle-add-video</kbd></dt><dd>Add Tracks/Busses</dd>
-  <dt><kbd class="osc">Window/toggle-audio-connection-manager</kbd></dt><dd>Audio Connections</dd>
-  <dt><kbd class="osc">Window/toggle-audio-midi-setup</kbd></dt><dd>Audio/MIDI Setup</dd>
-  <dt><kbd class="osc">Window/toggle-big-clock</kbd></dt><dd>Big Clock</dd>
-  <dt><kbd class="osc">Window/toggle-bundle-manager</kbd></dt><dd>Bundle Manager</dd>
-  <dt><kbd class="osc">Window/toggle-inspector</kbd></dt><dd>Tracks and Busses</dd>
-  <dt><kbd class="osc">Window/toggle-key-editor</kbd></dt><dd>Key Bindings</dd>
-  <dt><kbd class="osc">Window/toggle-locations</kbd></dt><dd>Locations</dd>
-  <dt><kbd class="osc">Window/toggle-midi-connection-manager</kbd></dt><dd>MIDI Connections</dd>
-  <dt><kbd class="osc">Window/toggle-script-manager</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Window/toggle-session-options-editor</kbd></dt><dd>Properties</dd>
-  <dt><kbd class="osc">Window/toggle-speaker-config</kbd></dt><dd>Speaker Configuration</dd>
-  <dt><kbd class="osc">Window/toggle-video-export</kbd></dt><dd></dd>
-  <!-- Editor -->
-  <dt><kbd class="osc">Editor/SnapMode</kbd></dt><dd>Snap Mode</dd>
-  <dt><kbd class="osc">Editor/SnapTo</kbd></dt><dd>Snap to</dd>
-  <dt><kbd class="osc">Editor/ToggleGroupTabs</kbd></dt><dd>Show Group Tabs</dd>
-  <dt><kbd class="osc">Editor/ToggleJadeo</kbd></dt><dd>Video Monitor</dd>
-  <dt><kbd class="osc">Editor/ToggleMeasureVisibility</kbd></dt><dd>Show Measures</dd>
-  <dt><kbd class="osc">Editor/ToggleSummary</kbd></dt><dd>Show Summary</dd>
-  <dt><kbd class="osc">Editor/add-location-from-playhead</kbd></dt><dd>Add Mark from Playhead</dd>
-  <dt><kbd class="osc">Editor/addExistingAudioFiles</kbd></dt><dd>Import</dd>
-  <dt><kbd class="osc">Editor/addExistingPTFiles</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/addExternalAudioToRegionList</kbd></dt><dd>Import to Region List...</dd>
-  <dt><kbd class="osc">Editor/alt-finish-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alt-start-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-add-location-from-playhead</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-alternate-redo</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-editor-delete</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-jump-backward-to-mark</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-jump-forward-to-mark</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-redo</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-remove-location-from-playhead</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-select-all-after-edit-cursor</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-select-all-before-edit-cursor</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-tab-to-transient-backwards</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/alternate-tab-to-transient-forwards</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/bring-into-session</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/center-edit-cursor</kbd></dt><dd>Center Edit Point</dd>
-  <dt><kbd class="osc">Editor/center-playhead</kbd></dt><dd>Center Playhead</dd>
-  <dt><kbd class="osc">Editor/crop</kbd></dt><dd>Crop</dd>
-  <dt><kbd class="osc">Editor/cycle-edit-point</kbd></dt><dd>Change Edit Point</dd>
-  <dt><kbd class="osc">Editor/cycle-edit-point-with-marker</kbd></dt><dd>Change Edit Point Including Marker</dd>
-  <dt><kbd class="osc">Editor/cycle-snap-mode</kbd></dt><dd>Next Snap Mode</dd>
-  <dt><kbd class="osc">Editor/cycle-zoom-focus</kbd></dt><dd>Next Zoom Focus</dd>
-  <dt><kbd class="osc">Editor/deselect-all</kbd></dt><dd>Deselect All</dd>
-  <dt><kbd class="osc">Editor/duplicate-range</kbd></dt><dd>Duplicate Range</dd>
-  <dt><kbd class="osc">Editor/edit-at-mouse</kbd></dt><dd>Mouse</dd>
-  <dt><kbd class="osc">Editor/edit-at-playhead</kbd></dt><dd>Playhead</dd>
-  <dt><kbd class="osc">Editor/edit-at-selected-marker</kbd></dt><dd>Marker</dd>
-  <dt><kbd class="osc">Editor/edit-cursor-to-next-region-end</kbd></dt><dd>To Next Region End</dd>
-  <dt><kbd class="osc">Editor/edit-cursor-to-next-region-start</kbd></dt><dd>To Next Region Start</dd>
-  <dt><kbd class="osc">Editor/edit-cursor-to-next-region-sync</kbd></dt><dd>To Next Region Sync</dd>
-  <dt><kbd class="osc">Editor/edit-cursor-to-previous-region-end</kbd></dt><dd>To Previous Region End</dd>
-  <dt><kbd class="osc">Editor/edit-cursor-to-previous-region-start</kbd></dt><dd>To Previous Region Start</dd>
-  <dt><kbd class="osc">Editor/edit-cursor-to-previous-region-sync</kbd></dt><dd>To Previous Region Sync</dd>
-  <dt><kbd class="osc">Editor/edit-cursor-to-range-end</kbd></dt><dd>To Range End</dd>
-  <dt><kbd class="osc">Editor/edit-cursor-to-range-start</kbd></dt><dd>To Range Start</dd>
-  <dt><kbd class="osc">Editor/edit-to-playhead</kbd></dt><dd>Active Mark to Playhead</dd>
-  <dt><kbd class="osc">Editor/editor-copy</kbd></dt><dd>Copy</dd>
-  <dt><kbd class="osc">Editor/editor-crop</kbd></dt><dd>Crop</dd>
-  <dt><kbd class="osc">Editor/editor-cut</kbd></dt><dd>Cut</dd>
-  <dt><kbd class="osc">Editor/editor-delete</kbd></dt><dd>Delete</dd>
-  <dt><kbd class="osc">Editor/editor-fade-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/editor-paste</kbd></dt><dd>Paste</dd>
-  <dt><kbd class="osc">Editor/editor-separate</kbd></dt><dd>Separate</dd>
-  <dt><kbd class="osc">Editor/expand-tracks</kbd></dt><dd>Expand Track Height</dd>
-  <dt><kbd class="osc">Editor/export-audio</kbd></dt><dd>Export Audio</dd>
-  <dt><kbd class="osc">Editor/export-range</kbd></dt><dd>Export Range</dd>
-  <dt><kbd class="osc">Editor/finish-loop-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/finish-punch-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/finish-range</kbd></dt><dd>Finish Range</dd>
-  <dt><kbd class="osc">Editor/fit-selection</kbd></dt><dd>Fit Selected Tracks</dd>
-  <dt><kbd class="osc">Editor/fit_16_tracks</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/fit_1_track</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/fit_2_tracks</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/fit_32_tracks</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/fit_4_tracks</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/fit_8_tracks</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/fit_all_tracks</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/goto-mark-1</kbd></dt><dd>Locate to Mark 1</dd>
-  <dt><kbd class="osc">Editor/goto-mark-2</kbd></dt><dd>Locate to Mark 2</dd>
-  <dt><kbd class="osc">Editor/goto-mark-3</kbd></dt><dd>Locate to Mark 3</dd>
-  <dt><kbd class="osc">Editor/goto-mark-4</kbd></dt><dd>Locate to Mark 4</dd>
-  <dt><kbd class="osc">Editor/goto-mark-5</kbd></dt><dd>Locate to Mark 5</dd>
-  <dt><kbd class="osc">Editor/goto-mark-6</kbd></dt><dd>Locate to Mark 6</dd>
-  <dt><kbd class="osc">Editor/goto-mark-7</kbd></dt><dd>Locate to Mark 7</dd>
-  <dt><kbd class="osc">Editor/goto-mark-8</kbd></dt><dd>Locate to Mark 8</dd>
-  <dt><kbd class="osc">Editor/goto-mark-9</kbd></dt><dd>Locate to Mark 9</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-10</kbd></dt><dd>Goto View 10</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-11</kbd></dt><dd>Goto View 11</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-12</kbd></dt><dd>Goto View 12</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-1</kbd></dt><dd>Goto View 1</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-2</kbd></dt><dd>Goto View 2</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-3</kbd></dt><dd>Goto View 3</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-4</kbd></dt><dd>Goto View 4</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-5</kbd></dt><dd>Goto View 5</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-6</kbd></dt><dd>Goto View 6</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-7</kbd></dt><dd>Goto View 7</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-8</kbd></dt><dd>Goto View 8</dd>
-  <dt><kbd class="osc">Editor/goto-visual-state-9</kbd></dt><dd>Goto View 9</dd>
-  <dt><kbd class="osc">Editor/importFromSession</kbd></dt><dd>Import From Session</dd>
-  <dt><kbd class="osc">Editor/insert-time</kbd></dt><dd>Insert Time</dd>
-  <dt><kbd class="osc">Editor/invert-selection</kbd></dt><dd>Invert Selection</dd>
-  <dt><kbd class="osc">Editor/jump-backward-to-mark</kbd></dt><dd>Jump to Previous Mark</dd>
-  <dt><kbd class="osc">Editor/jump-forward-to-mark</kbd></dt><dd>Jump to Next Mark</dd>
-  <dt><kbd class="osc">Editor/lock</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/main-menu-play-selected-regions</kbd></dt><dd>Play Selected Regions</dd>
-  <dt><kbd class="osc">Editor/move-range-end-to-next-region-boundary</kbd></dt><dd>Move Range End to Next Region Boundary</dd>
-  <dt><kbd class="osc">Editor/move-range-end-to-previous-region-boundary</kbd></dt><dd>Move Range End to Previous Region Boundary</dd>
-  <dt><kbd class="osc">Editor/move-range-start-to-next-region-boundary</kbd></dt><dd>Move Range Start to Next Region Boundary</dd>
-  <dt><kbd class="osc">Editor/move-range-start-to-previous-region-boundary</kbd></dt><dd>Move Range Start to Previous Region Boundary</dd>
-  <dt><kbd class="osc">Editor/move-selected-tracks-down</kbd></dt><dd>Move Selected Tracks Down</dd>
-  <dt><kbd class="osc">Editor/move-selected-tracks-up</kbd></dt><dd>Move Selected Tracks Up</dd>
-  <dt><kbd class="osc">Editor/next-snap-choice</kbd></dt><dd>Next Snap Choice</dd>
-  <dt><kbd class="osc">Editor/next-snap-choice-music-only</kbd></dt><dd>Next Musical Snap Choice</dd>
-  <dt><kbd class="osc">Editor/nudge-next-backward</kbd></dt><dd>Nudge Next Earlier</dd>
-  <dt><kbd class="osc">Editor/nudge-next-forward</kbd></dt><dd>Nudge Next Later</dd>
-  <dt><kbd class="osc">Editor/nudge-playhead-backward</kbd></dt><dd>Nudge Playhead Backward</dd>
-  <dt><kbd class="osc">Editor/nudge-playhead-forward</kbd></dt><dd>Nudge Playhead Forward</dd>
-  <dt><kbd class="osc">Editor/play-edit-range</kbd></dt><dd>Play Edit Range</dd>
-  <dt><kbd class="osc">Editor/play-from-edit-point-and-return</kbd></dt><dd>Play from Edit Point and Return</dd>
-  <dt><kbd class="osc">Editor/play-from-edit-point</kbd></dt><dd>Play From Edit Point</dd>
-  <dt><kbd class="osc">Editor/playhead-backward-to-grid</kbd></dt><dd>Playhead To Previous Grid</dd>
-  <dt><kbd class="osc">Editor/playhead-forward-to-grid</kbd></dt><dd>Playhead To Next Grid</dd>
-  <dt><kbd class="osc">Editor/playhead-to-edit</kbd></dt><dd>Playhead to Active Mark</dd>
-  <dt><kbd class="osc">Editor/playhead-to-next-region-boundary</kbd></dt><dd>Playhead to Next Region Boundary</dd>
-  <dt><kbd class="osc">Editor/playhead-to-next-region-boundary-noselection</kbd></dt><dd>Playhead to Next Region Boundary (No Track Selection)</dd>
-  <dt><kbd class="osc">Editor/playhead-to-next-region-end</kbd></dt><dd>Playhead to Next Region End</dd>
-  <dt><kbd class="osc">Editor/playhead-to-next-region-start</kbd></dt><dd>Playhead to Next Region Start</dd>
-  <dt><kbd class="osc">Editor/playhead-to-next-region-sync</kbd></dt><dd>Playhead to Next Region Sync</dd>
-  <dt><kbd class="osc">Editor/playhead-to-previous-region-boundary</kbd></dt><dd>Playhead to Previous Region Boundary</dd>
-  <dt><kbd class="osc">Editor/playhead-to-previous-region-boundary-noselection</kbd></dt><dd>Playhead to Previous Region Boundary (No Track Selection)</dd>
-  <dt><kbd class="osc">Editor/playhead-to-previous-region-end</kbd></dt><dd>Playhead to Previous Region End</dd>
-  <dt><kbd class="osc">Editor/playhead-to-previous-region-start</kbd></dt><dd>Playhead to Previous Region Start</dd>
-  <dt><kbd class="osc">Editor/playhead-to-previous-region-sync</kbd></dt><dd>Playhead to Previous Region Sync</dd>
-  <dt><kbd class="osc">Editor/playhead-to-range-end</kbd></dt><dd>Playhead to Range End</dd>
-  <dt><kbd class="osc">Editor/playhead-to-range-start</kbd></dt><dd>Playhead to Range Start</dd>
-  <dt><kbd class="osc">Editor/prev-snap-choice</kbd></dt><dd>Previous Snap Choice</dd>
-  <dt><kbd class="osc">Editor/prev-snap-choice-music-only</kbd></dt><dd>Previous Musical Snap Choice</dd>
-  <dt><kbd class="osc">Editor/redo</kbd></dt><dd>Redo</dd>
-  <dt><kbd class="osc">Editor/redo-last-selection-op</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/remove-last-capture</kbd></dt><dd>Remove Last Capture</dd>
-  <dt><kbd class="osc">Editor/remove-location-from-playhead</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/remove-time</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/remove-track</kbd></dt><dd>Remove</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-10</kbd></dt><dd>Save View 10</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-11</kbd></dt><dd>Save View 11</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-12</kbd></dt><dd>Save View 12</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-1</kbd></dt><dd>Save View 1</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-2</kbd></dt><dd>Save View 2</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-3</kbd></dt><dd>Save View 3</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-4</kbd></dt><dd>Save View 4</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-5</kbd></dt><dd>Save View 5</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-6</kbd></dt><dd>Save View 6</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-7</kbd></dt><dd>Save View 7</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-8</kbd></dt><dd>Save View 8</dd>
-  <dt><kbd class="osc">Editor/save-visual-state-9</kbd></dt><dd>Save View 9</dd>
-  <dt><kbd class="osc">Editor/script-action-1</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/script-action-2</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/script-action-3</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/script-action-4</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/script-action-5</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/script-action-6</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/script-action-7</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/script-action-8</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/script-action-9</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/scroll-backward</kbd></dt><dd>Scroll Backward</dd>
-  <dt><kbd class="osc">Editor/scroll-forward</kbd></dt><dd>Scroll Forward</dd>
-  <dt><kbd class="osc">Editor/scroll-playhead-backward</kbd></dt><dd>Playhead Backward</dd>
-  <dt><kbd class="osc">Editor/scroll-playhead-forward</kbd></dt><dd>Playhead Forward</dd>
-  <dt><kbd class="osc">Editor/scroll-tracks-down</kbd></dt><dd>Scroll Tracks Down</dd>
-  <dt><kbd class="osc">Editor/scroll-tracks-up</kbd></dt><dd>Scroll Tracks Up</dd>
-  <dt><kbd class="osc">Editor/select-all-after-edit-cursor</kbd></dt><dd>Select All After Edit Point</dd>
-  <dt><kbd class="osc">Editor/select-all-before-edit-cursor</kbd></dt><dd>Select All Before Edit Point</dd>
-  <dt><kbd class="osc">Editor/select-all-between-cursors</kbd></dt><dd>Select All Overlapping Edit Range</dd>
-  <dt><kbd class="osc">Editor/select-all-in-loop-range</kbd></dt><dd>Select All in Loop Range</dd>
-  <dt><kbd class="osc">Editor/select-all-in-punch-range</kbd></dt><dd>Select All in Punch Range</dd>
-  <dt><kbd class="osc">Editor/select-all-objects => Ctrl+A</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/select-all-tracks => Ctrl+T</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/select-all-within-cursors</kbd></dt><dd>Select All Inside Edit Range</dd>
-  <dt><kbd class="osc">Editor/select-from-regions</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/select-loop-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/select-next-route</kbd></dt><dd>Select Next Track or Bus</dd>
-  <dt><kbd class="osc">Editor/select-prev-route</kbd></dt><dd>Select Previous Track or Bus</dd>
-  <dt><kbd class="osc">Editor/select-punch-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/select-range-between-cursors</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/selected-marker-to-next-region-boundary</kbd></dt><dd>To Next Region Boundary</dd>
-  <dt><kbd class="osc">Editor/selected-marker-to-next-region-boundary-noselection</kbd></dt><dd>To Next Region Boundary (No Track Selection)</dd>
-  <dt><kbd class="osc">Editor/selected-marker-to-previous-region-boundary</kbd></dt><dd>To Previous Region Boundary</dd>
-  <dt><kbd class="osc">Editor/selected-marker-to-previous-region-boundary-noselection</kbd></dt><dd>To Previous Region Boundary (No Track Selection)</dd>
-  <dt><kbd class="osc">Editor/select-range-between-cursors</kbd></dt><dd>Select Edit Range</dd>
-  <dt><kbd class="osc">Editor/separate-from-loop</kbd></dt><dd>Separate Using Loop Range</dd>
-  <dt><kbd class="osc">Editor/separate-from-punch</kbd></dt><dd>Separate Using Punch Range</dd>
-  <dt><kbd class="osc">Editor/set-edit-lock</kbd></dt><dd>Lock</dd>
-  <dt><kbd class="osc">Editor/set-edit-point</kbd></dt><dd>Active Marker to Mouse</dd>
-  <dt><kbd class="osc">Editor/set-edit-ripple</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/set-edit-slide</kbd></dt><dd>Slide</dd>
-  <dt><kbd class="osc">Editor/set-loop-from-edit-range</kbd></dt><dd>Set Loop from Edit Range</dd>
-  <dt><kbd class="osc">Editor/set-playhead</kbd></dt><dd>Playhead to Mouse</dd>
-  <dt><kbd class="osc">Editor/set-punch-from-edit-range</kbd></dt><dd>Set Punch from Edit Range</dd>
-  <dt><kbd class="osc">Editor/set-session-end-from-playhead</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/set-session-from-edit-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/set-session-start-from-playhead</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/set-tempo-from-edit-range</kbd></dt><dd>Set Tempo from Edit Range = Bar</dd>
-  <dt><kbd class="osc">Editor/show-editor-list</kbd></dt><dd>Show Editor List</dd>
-  <dt><kbd class="osc">Editor/show-editor-mixer</kbd></dt><dd>Show Editor Mixer</dd>
-  <dt><kbd class="osc">Editor/show-marker-lines</kbd></dt><dd>Show Marker Lines</dd>
-  <dt><kbd class="osc">Editor/shrink-tracks</kbd></dt><dd>Shrink Track Height</dd>
-  <dt><kbd class="osc">Editor/snap-magnetic</kbd></dt><dd>Magnetic</dd>
-  <dt><kbd class="osc">Editor/snap-normal</kbd></dt><dd>Grid</dd>
-  <dt><kbd class="osc">Editor/snap-off</kbd></dt><dd>No Grid</dd>
-  <dt><kbd class="osc">Editor/sound-midi-notes</kbd></dt><dd>Sound Selected MIDI Notes</dd>
-  <dt><kbd class="osc">Editor/start-loop-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/start-punch-range</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/start-range</kbd></dt><dd>Start Range</dd>
-  <dt><kbd class="osc">Editor/start-range-from-playhead</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/step-mouse-mode</kbd></dt><dd>Step Mouse Mode</dd>
-  <dt><kbd class="osc">Editor/step-tracks-down</kbd></dt><dd>Step Tracks Down</dd>
-  <dt><kbd class="osc">Editor/step-tracks-up</kbd></dt><dd>Step Tracks Up</dd>
-  <dt><kbd class="osc">Editor/tab-to-transient-backwards</kbd></dt><dd>Move Earlier to Transient</dd>
-  <dt><kbd class="osc">Editor/tab-to-transient-forwards</kbd></dt><dd>Move Later to Transient</dd>
-  <dt><kbd class="osc">Editor/temporal-zoom-in</kbd></dt><dd>Zoom In</dd>
-  <dt><kbd class="osc">Editor/temporal-zoom-out</kbd></dt><dd>Zoom Out</dd>
-  <dt><kbd class="osc">Editor/toggle-edit-mode</kbd></dt><dd>Toggle Edit Mode</dd>
-  <dt><kbd class="osc">Editor/toggle-follow-playhead</kbd></dt><dd>Follow Playhead</dd>
-  <dt><kbd class="osc">Editor/toggle-log-window</kbd></dt><dd>Log</dd>
-  <dt><kbd class="osc">Editor/toggle-midi-input-active</kbd></dt><dd>Toggle MIDI Input Active for Editor-Selected Tracks/Busses</dd>
-  <dt><kbd class="osc">Editor/toggle-skip-playback</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/toggle-stationary-playhead</kbd></dt><dd>Stationary Playhead</dd>
-  <dt><kbd class="osc">Editor/toggle-track-active</kbd></dt><dd>Toggle Active</dd>
-  <dt><kbd class="osc">Editor/toggle-vmon-frame</kbd></dt><dd>Frame number</dd>
-  <dt><kbd class="osc">Editor/toggle-vmon-fullscreen</kbd></dt><dd>Fullscreen</dd>
-  <dt><kbd class="osc">Editor/toggle-vmon-letterbox</kbd></dt><dd>Letterbox</dd>
-  <dt><kbd class="osc">Editor/toggle-vmon-ontop</kbd></dt><dd>Always on Top</dd>
-  <dt><kbd class="osc">Editor/toggle-vmon-osdbg</kbd></dt><dd>Timecode Background</dd>
-  <dt><kbd class="osc">Editor/toggle-vmon-timecode</kbd></dt><dd>Timecode</dd>
-  <dt><kbd class="osc">Editor/toggle-zoom</kbd></dt><dd>Toggle Zoom State</dd>
-  <dt><kbd class="osc">Editor/track-height-large</kbd></dt><dd>Large</dd>
-  <dt><kbd class="osc">Editor/track-height-larger</kbd></dt><dd>Larger</dd>
-  <dt><kbd class="osc">Editor/track-height-largest</kbd></dt><dd>Largest</dd>
-  <dt><kbd class="osc">Editor/track-height-normal</kbd></dt><dd>Normal</dd>
-  <dt><kbd class="osc">Editor/track-height-small</kbd></dt><dd>Small</dd>
-  <dt><kbd class="osc">Editor/track-mute-toggle</kbd></dt><dd>Toggle Mute</dd>
-  <dt><kbd class="osc">Editor/track-record-enable-toggle</kbd></dt><dd>Toggle Record Enable</dd>
-  <dt><kbd class="osc">Editor/track-solo-isolate-toggle</kbd></dt><dd>Toggle Solo Isolate</dd>
-  <dt><kbd class="osc">Editor/track-solo-toggle</kbd></dt><dd>Toggle Solo</dd>
-  <dt><kbd class="osc">Editor/undo</kbd></dt><dd>Undo</dd>
-  <dt><kbd class="osc">Editor/undo-last-selection-op</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/zoom-to-selection</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/zoom-to-session</kbd></dt><dd>Zoom to Session</dd>
-  <dt><kbd class="osc">Editor/zoom-vmon-100</kbd></dt><dd>Original Size</dd>
-  <dt><kbd class="osc">Editor/zoom_100_ms</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/zoom_10_min</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/zoom_10_ms</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/zoom_10_sec</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/zoom_1_min</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/zoom_1_sec</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Editor/zoom_5_min</kbd></dt><dd></dd>
-  <!-- EditorMenu -  updated -->
-  <dt><kbd class="osc">EditorMenu/ActionScripts</kbd></dt><dd></dd>
-  <dt><kbd class="osc">EditorMenu/AlignMenu</kbd></dt><dd>Align</dd>
-  <dt><kbd class="osc">EditorMenu/Autoconnect</kbd></dt><dd>Autoconnect</dd>
-  <dt><kbd class="osc">EditorMenu/Crossfades</kbd></dt><dd>Crossfades</dd>
-  <dt><kbd class="osc">EditorMenu/EditCursorMovementOptions</kbd></dt><dd>Move Selected Marker</dd>
-  <dt><kbd class="osc">EditorMenu/Edit</kbd></dt><dd>Edit</dd>
-  <dt><kbd class="osc">EditorMenu/EditPointMenu</kbd></dt><dd>Edit Point</dd>
-  <dt><kbd class="osc">EditorMenu/EditSelectRangeOptions</kbd></dt><dd>Select Range Operations</dd>
-  <dt><kbd class="osc">EditorMenu/EditSelectRegionOptions</kbd></dt><dd>Select Regions</dd>
-  <dt><kbd class="osc">EditorMenu/FadeMenu</kbd></dt><dd>Fade</dd>
-  <dt><kbd class="osc">EditorMenu/LatchMenu</kbd></dt><dd>Latch</dd>
-  <dt><kbd class="osc">EditorMenu/Link</kbd></dt><dd>Link</dd>
-  <dt><kbd class="osc">EditorMenu/LocateToMarker</kbd></dt><dd>Locate to Markers</dd>
-  <dt><kbd class="osc">EditorMenu/MIDI</kbd></dt><dd>MIDI Options</dd>
-  <dt><kbd class="osc">EditorMenu/MarkerMenu</kbd></dt><dd>Markers</dd>
-  <dt><kbd class="osc">EditorMenu/MeterFalloff</kbd></dt><dd>Meter falloff</dd>
-  <dt><kbd class="osc">EditorMenu/MeterHold</kbd></dt><dd>Meter hold</dd>
-  <dt><kbd class="osc">EditorMenu/MiscOptions</kbd></dt><dd>Misc Options</dd>
-  <dt><kbd class="osc">EditorMenu/Monitoring</kbd></dt><dd>Monitoring</dd>
-  <dt><kbd class="osc">EditorMenu/MoveActiveMarkMenu</kbd></dt><dd>Active Mark</dd>
-  <dt><kbd class="osc">EditorMenu/MovePlayHeadMenu</kbd></dt><dd>Playhead</dd>
-  <dt><kbd class="osc">EditorMenu/PlayMenu</kbd></dt><dd>Play</dd>
-  <dt><kbd class="osc">EditorMenu/PrimaryClockMenu</kbd></dt><dd>Primary Clock</dd>
-  <dt><kbd class="osc">EditorMenu/Pullup</kbd></dt><dd>Pullup / Pulldown</dd>
-  <dt><kbd class="osc">EditorMenu/RegionEditOps</kbd></dt><dd>Region operations</dd>
-  <dt><kbd class="osc">EditorMenu/RegionGainMenu</kbd></dt><dd>Gain</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenuDuplicate</kbd></dt><dd>Duplicate</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenuEdit</kbd></dt><dd>Edit</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenuFades</kbd></dt><dd>Fades</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenuGain</kbd></dt><dd>Gain</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenu</kbd></dt><dd>Region</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenuLayering</kbd></dt><dd>Layering</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenuMIDI</kbd></dt><dd>MIDI</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenuPosition</kbd></dt><dd>Position</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenuRanges</kbd></dt><dd>Ranges</dd>
-  <dt><kbd class="osc">EditorMenu/RegionMenuTrim</kbd></dt><dd>Trim</dd>
-  <dt><kbd class="osc">EditorMenu/RulerMenu</kbd></dt><dd>Rulers</dd>
-  <dt><kbd class="osc">EditorMenu/SavedViewMenu</kbd></dt><dd>Views</dd>
-  <dt><kbd class="osc">EditorMenu/ScrollMenu</kbd></dt><dd>Scroll</dd>
-  <dt><kbd class="osc">EditorMenu/SecondaryClockMenu</kbd></dt><dd>Secondary Clock</dd>
-  <dt><kbd class="osc">EditorMenu/Select</kbd></dt><dd>Select</dd>
-  <dt><kbd class="osc">EditorMenu/SelectMenu</kbd></dt><dd>Select</dd>
-  <dt><kbd class="osc">EditorMenu/SeparateMenu</kbd></dt><dd>Separate</dd>
-  <dt><kbd class="osc">EditorMenu/SetLoopMenu</kbd></dt><dd>Loop</dd>
-  <dt><kbd class="osc">EditorMenu/SetPunchMenu</kbd></dt><dd>Punch</dd>
-  <dt><kbd class="osc">EditorMenu/Solo</kbd></dt><dd>Solo</dd>
-  <dt><kbd class="osc">EditorMenu/Subframes</kbd></dt><dd>Subframes</dd>
-  <dt><kbd class="osc">EditorMenu/SyncMenu</kbd></dt><dd>Sync</dd>
-  <dt><kbd class="osc">EditorMenu/TempoMenu</kbd></dt><dd>Tempo</dd>
-  <dt><kbd class="osc">EditorMenu/Timecode</kbd></dt><dd>Timecode fps</dd>
-  <dt><kbd class="osc">EditorMenu/Tools</kbd></dt><dd>Tools</dd>
-  <dt><kbd class="osc">EditorMenu/TrackHeightMenu</kbd></dt><dd>Height</dd>
-  <dt><kbd class="osc">EditorMenu/TrackMenu</kbd></dt><dd>Track</dd>
-  <dt><kbd class="osc">EditorMenu/VideoMonitorMenu</kbd></dt><dd>Video Monitor</dd>
-  <dt><kbd class="osc">EditorMenu/View</kbd></dt><dd>View</dd>
-  <dt><kbd class="osc">EditorMenu/ZoomFocus</kbd></dt><dd>Zoom Focus</dd>
-  <dt><kbd class="osc">EditorMenu/ZoomFocusMenu</kbd></dt><dd>Zoom Focus</dd>
-  <dt><kbd class="osc">EditorMenu/ZoomMenu</kbd></dt><dd>Zoom</dd>
-  <!-- mouseMode - updated-->
-  <dt><kbd class="osc">MouseMode/set-mouse-mode-audition</kbd></dt><dd>Audition Tool</dd>
-  <dt><kbd class="osc">MouseMode/set-mouse-mode-content</kbd></dt><dd></dd>
-  <dt><kbd class="osc">MouseMode/set-mouse-mode-cut</kbd></dt><dd></dd>
-  <dt><kbd class="osc">MouseMode/set-mouse-mode-draw</kbd></dt><dd>Note Drawing Tool</dd>
-  <dt><kbd class="osc">MouseMode/set-mouse-mode-object</kbd></dt><dd>Object Tool</dd>
-  <dt><kbd class="osc">MouseMode/set-mouse-mode-object-range</kbd></dt><dd>Smart Object Mode</dd>
-  <dt><kbd class="osc">MouseMode/set-mouse-mode-range</kbd></dt><dd>Range Tool</dd>
-  <dt><kbd class="osc">MouseMode/set-mouse-mode-timefx</kbd></dt><dd>Time FX Tool</dd>
-  <!-- Region - updated-->
-  <dt><kbd class="osc">Region/add-range-marker-from-region</kbd></dt><dd>Add Single Range Marker</dd>
-  <dt><kbd class="osc">Region/add-range-markers-from-region</kbd></dt><dd>Add Range Marker Per Region</dd>
-  <dt><kbd class="osc">Region/align-regions-end</kbd></dt><dd>Align End</dd>
-  <dt><kbd class="osc">Region/align-regions-end-relative</kbd></dt><dd>Align End Relative</dd>
-  <dt><kbd class="osc">Region/align-regions-start</kbd></dt><dd>Align Start</dd>
-  <dt><kbd class="osc">Region/align-regions-start-relative</kbd></dt><dd>Align Start Relative</dd>
-  <dt><kbd class="osc">Region/align-regions-sync</kbd></dt><dd>Align Sync</dd>
-  <dt><kbd class="osc">Region/align-regions-sync-relative</kbd></dt><dd>Align Sync Relative</dd>
-  <dt><kbd class="osc">/Region/alternate-nudge-backward</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Region/alternate-nudge-forward</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Region/alternate-set-fade-in-length</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Region/alternate-set-fade-out-length</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Region/boost-region-gain</kbd></dt><dd>Boost Gain</dd>
-  <dt><kbd class="osc">Region/bounce-regions-processed</kbd></dt><dd>Bounce (without processing)</dd>
-  <dt><kbd class="osc">Region/bounce-regions-unprocessed</kbd></dt><dd>Bounce (with processing)</dd>
-  <dt><kbd class="osc">Region/choose-top-region-context-menu</kbd></dt><dd>Choose Top...</dd>
-  <dt><kbd class="osc">Region/choose-top-region</kbd></dt><dd>Choose Top...</dd>
-  <dt><kbd class="osc">Region/close-region-gaps</kbd></dt><dd>Close Gaps</dd>
-  <dt><kbd class="osc">Region/combine-regions</kbd></dt><dd>Combine</dd>
-  <dt><kbd class="osc">Region/cut-region-gain</kbd></dt><dd>Cut Gain</dd>
-  <dt><kbd class="osc">Region/duplicate-region</kbd></dt><dd>Duplicate</dd>
-  <dt><kbd class="osc">Region/export-region</kbd></dt><dd>Export...</dd>
-  <dt><kbd class="osc">Region/fork-region</kbd></dt><dd>Unlink from other copies</dd>
-  <dt><kbd class="osc">Region/insert-patch-change-context</kbd></dt><dd>Insert Patch Change...</dd>
-  <dt><kbd class="osc">Region/insert-patch-change</kbd></dt><dd>Insert Patch Change...</dd>
-  <dt><kbd class="osc">Region/insert-region-from-region-list</kbd></dt><dd>Insert Region From Region List</dd>
-  <dt><kbd class="osc">/Region/legatize-region</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Region/loop-region</kbd></dt><dd>Loop</dd>
-  <dt><kbd class="osc">Region/loudness-analyze-region</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Region/lower-region</kbd></dt><dd>Lower</dd>
-  <dt><kbd class="osc">Region/lower-region-to-bottom</kbd></dt><dd>Lower to Bottom</dd>
-  <dt><kbd class="osc">Region/multi-duplicate-region</kbd></dt><dd>Multi-Duplicate...</dd>
-  <dt><kbd class="osc">Region/naturalize-region</kbd></dt><dd>Move to Original Position</dd>
-  <dt><kbd class="osc">Region/normalize-region</kbd></dt><dd>Normalize...</dd>
-  <dt><kbd class="osc">Region/nudge-backward-by-capture-offset</kbd></dt><dd>Nudge Earlier by Capture Offset</dd>
-  <dt><kbd class="osc">Region/nudge-backward</kbd></dt><dd>Nudge Earlier</dd>
-  <dt><kbd class="osc">Region/nudge-forward-by-capture-offset</kbd></dt><dd>Nudge Later by Capture Offset</dd>
-  <dt><kbd class="osc">Region/nudge-forward</kbd></dt><dd>Nudge Later</dd>
-  <dt><kbd class="osc">Region/pitch-shift-region</kbd></dt><dd>Pitch Shift...</dd>
-  <dt><kbd class="osc">Region/place-transient</kbd></dt><dd>Place Transient</dd>
-  <dt><kbd class="osc">Region/play-selected-regions</kbd></dt><dd>Play</dd>
-  <dt><kbd class="osc">Region/quantize-region</kbd></dt><dd>Quantize...</dd>
-  <dt><kbd class="osc">Region/raise-region</kbd></dt><dd>Raise</dd>
-  <dt><kbd class="osc">Region/raise-region-to-top</kbd></dt><dd>Raise to Top</dd>
-  <dt><kbd class="osc">Region/region-fill-track</kbd></dt><dd>Fill Track</dd>
-  <dt><kbd class="osc">Region/remove-region</kbd></dt><dd>Remove</dd>
-  <dt><kbd class="osc">Region/remove-region-sync</kbd></dt><dd>Remove Sync</dd>
-  <dt><kbd class="osc">Region/rename-region</kbd></dt><dd>Rename...</dd>
-  <dt><kbd class="osc">Region/reset-region-gain-envelopes</kbd></dt><dd>Reset Envelope</dd>
-  <dt><kbd class="osc">Region/reset-region-scale-amplitude</kbd></dt><dd>Reset Gain</dd>
-  <dt><kbd class="osc">Region/reverse-region</kbd></dt><dd>Reverse</dd>
-  <dt><kbd class="osc">Region/separate-under-region</kbd></dt><dd>Separate Under</dd>
-  <dt><kbd class="osc">Region/sequence-regions</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Region/set-fade-in-length</kbd></dt><dd>Set Fade In Length</dd>
-  <dt><kbd class="osc">Region/set-fade-out-length</kbd></dt><dd>Set Fade Out Length</dd>
-  <dt><kbd class="osc">Region/set-loop-from-region</kbd></dt><dd>Set Loop Range</dd>
-  <dt><kbd class="osc">Region/set-punch-from-region</kbd></dt><dd>Set Punch</dd>
-  <dt><kbd class="osc">Region/set-region-sync-position</kbd></dt><dd>Set Sync Position</dd>
-  <dt><kbd class="osc">Region/set-selection-from-region</kbd></dt><dd>Set Range Selection</dd>
-  <dt><kbd class="osc">Region/set-tempo-from-region</kbd></dt><dd>Set Tempo from Region = Bar</dd>
-  <dt><kbd class="osc">Region/show-region-list-editor</kbd></dt><dd>List Editor...</dd>
-  <dt><kbd class="osc">Region/show-region-properties</kbd></dt><dd>Properties...</dd>
-  <dt><kbd class="osc">Region/show-rhythm-ferret</kbd></dt><dd>Rhythm Ferret...</dd>
-  <dt><kbd class="osc">Region/snap-regions-to-grid</kbd></dt><dd>Snap Position To Grid</dd>
-  <dt><kbd class="osc">Region/split-multichannel-region</kbd></dt><dd>Make Mono Regions</dd>
-  <dt><kbd class="osc">Region/split-region-at-transients</kbd></dt><dd>Split at Percussion Onsets</dd>
-  <dt><kbd class="osc">Region/split-region</kbd></dt><dd>Split</dd>
-  <dt><kbd class="osc">Region/strip-region-silence</kbd></dt><dd>Strip Silence...</dd>
-  <dt><kbd class="osc">Region/toggle-opaque-region</kbd></dt><dd>Opaque</dd>
-  <dt><kbd class="osc">Region/toggle-region-fade-in</kbd></dt><dd>Fade In</dd>
-  <dt><kbd class="osc">Region/toggle-region-fade-out</kbd></dt><dd>Fade Out</dd>
-  <dt><kbd class="osc">Region/toggle-region-fades</kbd></dt><dd>Fades</dd>
-  <dt><kbd class="osc">Region/toggle-region-gain-envelope-active</kbd></dt><dd>Envelope Active</dd>
-  <dt><kbd class="osc">Region/toggle-region-lock</kbd></dt><dd>Lock</dd>
-  <dt><kbd class="osc">Region/toggle-region-lock-style</kbd></dt><dd>Glue to Bars and Beats</dd>
-  <dt><kbd class="osc">Region/toggle-region-mute</kbd></dt><dd>Mute</dd>
-  <dt><kbd class="osc">Region/toggle-region-video-lock</kbd></dt><dd>Lock to Video</dd>
-  <dt><kbd class="osc">Region/transform-region</kbd></dt><dd></dd>
-  <dt><kbd class="osc">Region/transpose-region</kbd></dt><dd>Transpose...</dd>
-  <dt><kbd class="osc">Region/trim-back</kbd></dt><dd>Trim End at Edit Point</dd>
-  <dt><kbd class="osc">Region/trim-front</kbd></dt><dd>Trim Start at Edit Point</dd>
-  <dt><kbd class="osc">Region/trim-region-to-loop</kbd></dt><dd>Trim to Loop</dd>
-  <dt><kbd class="osc">Region/trim-region-to-punch</kbd></dt><dd>Trim to Punch</dd>
-  <dt><kbd class="osc">Region/trim-to-next-region</kbd></dt><dd>Trim to Next</dd>
-  <dt><kbd class="osc">Region/trim-to-previous-region</kbd></dt><dd>Trim to Previous</dd>
-  <dt><kbd class="osc">Region/uncombine-regions</kbd></dt><dd>Uncombine</dd>
-  <!-- RegionList ok -->
-  <dt><kbd class="osc">RegionList/RegionListSort</kbd></dt><dd>Sort</dd>
-  <dt><kbd class="osc">RegionList/SortAscending</kbd></dt><dd>Ascending</dd>
-  <dt><kbd class="osc">RegionList/SortByRegionEndinFile</kbd></dt><dd>By Region End in File</dd>
-  <dt><kbd class="osc">RegionList/SortByRegionLength</kbd></dt><dd>By Region Length</dd>
-  <dt><kbd class="osc">RegionList/SortByRegionName</kbd></dt><dd>By Region Name</dd>
-  <dt><kbd class="osc">RegionList/SortByRegionPosition</kbd></dt><dd>By Region Position</dd>
-  <dt><kbd class="osc">RegionList/SortByRegionStartinFile</kbd></dt><dd>By Region Start in File</dd>
-  <dt><kbd class="osc">RegionList/SortByRegionTimestamp</kbd></dt><dd>By Region Timestamp</dd>
-  <dt><kbd class="osc">RegionList/SortBySourceFileCreationDate</kbd></dt><dd>By Source File Creation Date</dd>
-  <dt><kbd class="osc">RegionList/SortBySourceFileLength</kbd></dt><dd>By Source File Length</dd>
-  <dt><kbd class="osc">RegionList/SortBySourceFileName</kbd></dt><dd>By Source File Name</dd>
-  <dt><kbd class="osc">RegionList/SortBySourceFilesystem</kbd></dt><dd>By Source Filesystem</dd>
-  <dt><kbd class="osc">RegionList/SortDescending</kbd></dt><dd>Descending</dd>
-  <dt><kbd class="osc">RegionList/removeUnusedRegions</kbd></dt><dd>Remove Unused</dd>
-  <dt><kbd class="osc">RegionList/rlAudition</kbd></dt><dd>Audition</dd>
-  <dt><kbd class="osc">RegionList/rlHide</kbd></dt><dd>Hide</dd>
-  <dt><kbd class="osc">RegionList/rlShow</kbd></dt><dd>Show</dd>
-  <dt><kbd class="osc">RegionList/rlShowAll</kbd></dt><dd>Show All</dd>
-  <dt><kbd class="osc">RegionList/rlShowAuto</kbd></dt><dd>Show Automatic Regions</dd>
-  <!-- Rulers - ok -->
-  <dt><kbd class="osc">Rulers/toggle-bbt-ruler</kbd></dt><dd>Bars & Beats</dd>
-  <dt><kbd class="osc">Rulers/toggle-cd-marker-ruler</kbd></dt><dd>CD Markers</dd>
-  <dt><kbd class="osc">Rulers/toggle-loop-punch-ruler</kbd></dt><dd>Loop/Punch</dd>
-  <dt><kbd class="osc">Rulers/toggle-marker-ruler</kbd></dt><dd>Markers</dd>
-  <dt><kbd class="osc">Rulers/toggle-meter-ruler</kbd></dt><dd>Meter</dd>
-  <dt><kbd class="osc">Rulers/toggle-minsec-ruler</kbd></dt><dd>Min:Sec</dd>
-  <dt><kbd class="osc">Rulers/toggle-range-ruler</kbd></dt><dd>Ranges</dd>
-  <dt><kbd class="osc">Rulers/toggle-samples-ruler</kbd></dt><dd>Samples</dd>
-  <dt><kbd class="osc">Rulers/toggle-tempo-ruler</kbd></dt><dd>Tempo</dd>
-  <dt><kbd class="osc">Rulers/toggle-timecode-ruler</kbd></dt><dd>Timecode</dd>
-  <dt><kbd class="osc">Rulers/toggle-video-ruler</kbd></dt><dd>Video</dd>
-  <!-- Shuttle Actions... these don't seem to be there any more
-  <dt><kbd class="osc">ShuttleActions/SetShuttleUnitsPercentage</kbd></dt><dd>Percentage</dd>
-  <dt><kbd class="osc">ShuttleActions/SetShuttleUnitsSemitones</kbd></dt><dd>Semitones</dd-->
-  <!-- snap checked -->
-  <dt><kbd class="osc">Snap/snap-to-asixteenthbeat</kbd></dt><dd>Snap to Sixteenths</dd>
-  <dt><kbd class="osc">Snap/snap-to-bar</kbd></dt><dd>Snap to Bar</dd>
-  <dt><kbd class="osc">Snap/snap-to-beat</kbd></dt><dd>Snap to Beat</dd>
-  <dt><kbd class="osc">Snap/snap-to-cd-frame</kbd></dt><dd>Snap to CD Frame</dd>
-  <dt><kbd class="osc">Snap/snap-to-eighths</kbd></dt><dd>Snap to Eighths</dd>
-  <dt><kbd class="osc">Snap/snap-to-fifths</kbd></dt><dd>Snap to Fifths</dd>
-  <dt><kbd class="osc">Snap/snap-to-fourteenths</kbd></dt><dd>Snap to Fourteenths</dd>
-  <dt><kbd class="osc">Snap/snap-to-halves</kbd></dt><dd>Snap to Halves</dd>
-  <dt><kbd class="osc">Snap/snap-to-mark</kbd></dt><dd>Snap to Mark</dd>
-  <dt><kbd class="osc">Snap/snap-to-minutes</kbd></dt><dd>Snap to Minutes</dd>
-  <dt><kbd class="osc">Snap/snap-to-onetwentyeighths</kbd></dt><dd>Snap to One Twenty Eighths</dd>
-  <dt><kbd class="osc">Snap/snap-to-quarters</kbd></dt><dd>Snap to Quarters</dd>
-  <dt><kbd class="osc">Snap/snap-to-region-boundary</kbd></dt><dd>Snap to Region Boundary</dd>
-  <dt><kbd class="osc">Snap/snap-to-region-end</kbd></dt><dd>Snap to Region End</dd>
-  <dt><kbd class="osc">Snap/snap-to-region-start</kbd></dt><dd>Snap to Region Start</dd>
-  <dt><kbd class="osc">Snap/snap-to-region-sync</kbd></dt><dd>Snap to Region Sync</dd>
-  <dt><kbd class="osc">Snap/snap-to-seconds</kbd></dt><dd>Snap to Seconds</dd>
-  <dt><kbd class="osc">Snap/snap-to-sevenths</kbd></dt><dd>Snap to Sevenths</dd>
-  <dt><kbd class="osc">Snap/snap-to-sixths</kbd></dt><dd>Snap to Sixths</dd>
-  <dt><kbd class="osc">Snap/snap-to-sixtyfourths</kbd></dt><dd>Snap to Sixty Fourths</dd>
-  <dt><kbd class="osc">Snap/snap-to-tenths</kbd></dt><dd>Snap to Tenths</dd>
-  <dt><kbd class="osc">Snap/snap-to-thirds</kbd></dt><dd>Snap to Thirds</dd>
-  <dt><kbd class="osc">Snap/snap-to-thirtyseconds</kbd></dt><dd>Snap to Thirty Seconds</dd>
-  <dt><kbd class="osc">Snap/snap-to-timecode-frame</kbd></dt><dd>Snap to Timecode Frame</dd>
-  <dt><kbd class="osc">Snap/snap-to-timecode-minutes</kbd></dt><dd>Snap to Timecode Minutes</dd>
-  <dt><kbd class="osc">Snap/snap-to-timecode-seconds</kbd></dt><dd>Snap to Timecode Seconds</dd>
-  <dt><kbd class="osc">Snap/snap-to-twelfths</kbd></dt><dd>Snap to Twelfths</dd>
-  <dt><kbd class="osc">Snap/snap-to-twentieths</kbd></dt><dd>Snap to Twentieths</dd>
-  <dt><kbd class="osc">Snap/snap-to-twentyeighths</kbd></dt><dd>Snap to Twenty Eighths</dd>
-  <dt><kbd class="osc">Snap/snap-to-twentyfourths</kbd></dt><dd>Snap to Twenty Fourths</dd>
-  <!-- Zoom section ok -->
-  <dt><kbd class="osc">Zoom/zoom-focus-center</kbd></dt><dd>Zoom Focus Center</dd>
-  <dt><kbd class="osc">Zoom/zoom-focus-edit</kbd></dt><dd>Zoom Focus Edit Point</dd>
-  <dt><kbd class="osc">Zoom/zoom-focus-left</kbd></dt><dd>Zoom Focus Left</dd>
-  <dt><kbd class="osc">Zoom/zoom-focus-mouse</kbd></dt><dd>Zoom Focus Mouse</dd>
-  <dt><kbd class="osc">Zoom/zoom-focus-playhead</kbd></dt><dd>Zoom Focus Playhead</dd>
-  <dt><kbd class="osc">Zoom/zoom-focus-right</kbd></dt><dd>Zoom Focus Right</dd>
-  <!-- Mixer section totally new -->
-  <dt><kbd class="osc">/Mixer/ab-plugins</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/copy-processors</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/cut-processors</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/decrement-gain</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/delete-processors</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/increment-gain</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/mute</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/paste-processors</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/recenable</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/scroll-left</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/scroll-right</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/select-all-processors</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/select-none</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/solo</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/toggle-midi-input-active</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/toggle-processors</kbd></dt><dd></dd>
-  <dt><kbd class="osc">/Mixer/unity-gain</kbd></dt><dd></dd>
-</dl>
-
 {% children %}
diff --git a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/01_osc-control.html b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/01_osc-control.html
new file mode 100644 (file)
index 0000000..2e52d8b
--- /dev/null
@@ -0,0 +1,514 @@
+---
+layout: default
+title: OSC&#58; Controlling Ardour with OSC
+---
+
+<p>
+  <abbr title="Open Sound Control"><dfn>OSC</dfn></abbr> lets synthesizers
+  and other devices communicate with Ardour. OSC devices can send commands
+  relating to playback (such as play or stop), performance (such as volume,
+  play, stop, and almost any other function (such as Edit, or Undo).
+</p>
+
+<p class="note">
+  <em>Note:</em> OSC control has changed dramatically since Ardour 4.7.
+  The Path structure has been completely redone, Banking has been introduced,
+  The controller is now able to tell Ardour what kind of feedback it can
+  work with (including bank size) and two new math styles have been added
+  to gain controls. If you are using an Ardour version of 4.7 or less,
+  please read <a
+  href="/using-control-surfaces/controlling-ardour-with-osc/osc-control-in-ardour-4.7-and-prior/">
+  Osc control in ardour 4.7 and prior.</a>
+</p>
+
+<p>
+  Ardour is probably one of the most OSC-controllable audio applications
+  around, but as with all OSC-controllable apps, you can't do much without
+  knowing what <dfn>messages</dfn> can be sent. This document describes the
+  various categories of messages that Ardour understands. It is subject to
+  change, particularly the "Actions" part below, since this relates to the
+  GTK GUI for Ardour rather than the backend.
+</p>
+
+<h2>Connecting to Ardour via OSC</h2>
+<p>
+  OSC support is not enabled by default, but can be turned on via
+  <kbd class="menu">Edit &gt; Preferences &gt; Control Surfaces</kbd>.
+  Once enabled, Ardour will listen on port <code>3819</code> by default.
+  This port number can be changed by editing <code>$ARDOUR_CONFIG</code>
+  and adding this line within the <code>&lt;Config&gt;</code> section:
+</p>
+<kbd class="input">&lt;Option name="osc-port" value="<em>Your choice
+here</em>"/&gt;</kbd>
+
+<p>
+  Ardour sends any feedback to the port and address that sent any
+  feedback request. The port does not have to match Ardour's port. In
+  fact it is better not to. This means that Ardour can deal with more
+  than one controller at a time. The two controllers can bank
+  independently and even use different math for faders. This could be
+  used to allow talent to adjust their own monitor mix using a tablet
+  or phone that can run an OSC controller. For a full explanation of
+  how Ardour's feedback works please read <a
+  href="/using-control-surfaces/controlling-ardour-with-osc/feedback-in-osc/">
+  OSC feedback In Ardour.</a>
+</p>
+
+<h2>Control Surface Set Up</h2>
+
+<p>
+  Control surface set up allows the controller to tell Ardour about it's
+  capabilities. The surface can tell Ardour how many control strips it
+  has for banking, if it is capable of setting it's faders or buttons
+  to values set by Ardour's GUI or automation, What kind of math the
+  faders use and more.
+</p>
+<p>
+  Any time the <em>/set_surface</em> command is sent, the current bank
+  is recalculated and if feedback is turned on, the values of each
+  strip's controls are sent (or refreshed) as well. This will also
+  refresh the Master feedback setup.
+</p>
+<p class="note">
+  Surface Port Setting is available in the OSC GUI.
+</p>
+<p>
+  As of Ardour 5.1, There is now a GUI setup in response to those using
+  tablets with applications such as touchOSC or AndrOSC who need to be
+  able to set a port for Ardour to send to. It can also change the
+  default setting for set_surface. For more information about Ardour's
+  OSC configuration GUI please read <a
+  href="/using-control-surfaces/controlling-ardour-with-osc/osc-setup-dialog/">
+  Ardour's Setup Dialog.</a>
+</p>
+<p>If /set_surface is not sent, the default values are used:
+  <ul>
+         <li><em>Bank Size</em>: 0 - No banking (or infinite bank size).</li>
+         <li><em>Strip Types</em>: All strip types except hidden and special.</li>
+         <li><em>Feedback</em>: 0 - All off.</li>
+         <li><em>Fader Mode</em>: 0 - gain in dB (not relevant with feedback off)</li>
+  </ul>
+</p>
+<p>
+  These values give the same behaviour as prior versions of Ardour. (or the closest possible)
+</p>
+<dl class="bindings">
+  <dt><kbd class="osc">/set_surface <em>bank_size</em> <em>strip_types</em>
+  <em>feedback</em> <em>fadermode</em></kbd></dt>
+  <dd>
+         See below for an explanation of each parameter.
+  </dd>
+</dl>
+<h3>bank_size</h3>
+<p>
+  Bank Size is the number of channel strips the controller supports
+  without banking. Setting this to 0 turns banking off by setting the
+  bank size to infinite.
+</p>
+<p class="note">
+       Bank size can also be set with <em>/set_surface/bank_size size.</em>
+</p>
+<h3>strip_types</h3>
+<p>
+  strip_types is an integer made up of bits. The easy way to
+  deal with this is to think of strip_types items being worth a number and
+  then adding all those numbers together for a value to send.
+  Strip Types will determine what kind of strips will be included in
+  bank. This would include: Audio, MIDI, buses, VCAs, Master, Monitor
+  and hidden or selected strips.
+</p>
+<p>
+  Aside from setting the track types for the main mix assignments, using
+  /set_surface/strip_types with more than one surface button will allow
+  switching between modes for example: inputs only, buses only,
+  selected only, hidden only, by having the buttons send values of: 3,
+  12, 256, 512. A full mix button might have a value 31.
+</p>
+<p>
+  While Master and Monitor are listed as possibilities, most surfaces
+  will not use them. Using /master and /monitor makes more sense.
+  However, in the case where there are no master or monitor fader strips
+  on the surface, it may be necessary to include them in the banked
+  strips.
+</p>
+<p>Please see: <a
+  href="/using-control-surfaces/controlling-ardour-with-osc/calculating-feedback-and-strip-types-values/">
+  Calculating Feedback and Strip-types Values.</a>
+</p>
+<p class="note">
+       Strip types can also be set with <em>/set_surface/strip_types types.</em>
+</p>
+<h3>feedback</h3>
+<p>Feedback is an integer made up of bits. The easy way to
+  deal with this is to think of feedback items being worth a number and
+  then adding all those numbers together for a value to send.
+</p>
+<p>Please see: <a
+  href="/using-control-surfaces/controlling-ardour-with-osc/calculating-feedback-and-strip-types-values/">
+  Calculating Feedback and Strip-types Values.</a></p>
+<p class="note">
+       Feedback can also be set with <em>/set_surface/feedback feedback.</em>
+</p>
+
+<h3>gainmode</h3>
+<p>
+  Gainmode is a an int that acts as a bool:
+  <ul>
+         <li><em>0 (or false)</em> dB value as a float from -193 to +6. Sent as
+         /strip/gain SSID value. (-193 or below are the same as -inf)</li>
+         <li><em>1 (or true)</em> A positional fader based on the same math
+         as Ardour's GUI.  An Float from 0 to 1. Sent as
+         /strip/fader SSID value</li>
+  </ul>
+</p>
+<p>
+  Gainmode applies only to feedback values. The controller can choose
+  which gain math to use by choosing to use the /*/gain or /*/fader path
+  to send to Ardour. This makes sure a controller that doesn't set up
+  Ardour's OSC can still use either math. The gainmode for feedback also
+  determines the path Ardour uses for feedback so that the feedback
+  messages match the control messages.
+</p>
+<p class="note">
+       Gain mode can also be set with <em>/set_surface/gainmode gainmode.</em>
+</p>
+
+<h2>Querying Ardour for information</h2>
+<p>
+  The control Surface may wish to control the type a frequency of
+  updates it receives. It can do this with querying commands. See: <a
+  href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
+  Querying Ardour with OSC.</a>
+</p>
+
+<h2>List of OSC messages</h2>
+<p class="note">
+       Parameter types show how the value will be used. However, they may
+       be sent as a different type if needed, see: <a
+       href="/using-control-surfaces/controlling-ardour-with-osc/parameter-types-in-osc/">
+       Parameter Types in OSC.</a>
+</p>
+<h3>Master or Global messages</h3>
+
+<h4>Transport Control</h4>
+<dl class="bindings">
+  <dt><kbd class="osc">/transport_stop</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/transport_play</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/toggle_roll</kbd></dt>
+  <dd>Toggles between play and stop</dd>
+  <dt><kbd class="osc">/set_transport_speed <em>s</em></kbd></dt>
+  <dd>where <em>s</em> is a float ranging from -8.0f to 8.0f</dd>
+  <dt><kbd class="osc">/ffwd</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/rewind</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/goto_start</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/goto_end</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/jump_bars <em>bars</em></kbd></dt>
+  <dd>Where <em>bars</em> is a float (+/-) of the number of bars to jump</dd>
+  <dt><kbd class="osc">/jump_seconds <em>seconds</em></kbd></dt>
+  <dd>Where <em>seconds</em> is a float (+/-) of the number of seconds to jump</dd>
+  <dt><kbd class="osc">/add_marker</kbd></dt>
+  <dd>(adds marker to the current transport position)</dd>
+  <dt><kbd class="osc">/remove_marker</kbd></dt>
+  <dd>Removes marker at the current transport position (if there is one)</dd>
+  <dt><kbd class="osc">/mark_in</kbd></dt>
+  <dd>Marks the begining of a range at the current transport position</dd>
+  <dt><kbd class="osc">/mark_out</kbd></dt>
+  <dd>Marks the end of a range at the current transport position</dd>
+  <dt><kbd class="osc">/next_marker</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/prev_marker</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/locate <em>spos</em> <em>roll</em></kbd></dt>
+  <dd>where <em>spos</em> is the target position in samples and
+  <em>roll</em> is a bool/integer defining whether you want transport
+  to be kept rolling or not</dd>
+  <dt><kbd class="osc">/loop_toggle</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/loop_location <em>start</em> <em>end</em></kbd></dt>
+  <dd><em>start</em> is the beginning of a loop and <em>end</em> is the
+  end of a loop both are integer frame positions.</dd>
+  <dt><kbd class="osc">/set_loop_range</kbd></dt>
+  <dd>Uses edit range as loop range</dd>
+  <dt><kbd class="osc">/set_session_range</kbd></dt>
+  <dd>Uses edit range as session range</dd>
+  <dt><kbd class="osc">/toggle_click</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/midi_panic</kbd></dt>
+  <dd>Ardour will send an all notes off to all midi tracks</dd>
+  <dt><kbd class="osc">/cancel_all_solos</kbd></dt>
+  <dd>Cancel All Solos/PFLs/AFLs</dd>
+</dl>
+
+<h4>Transport Information</h4>
+<dl>
+  <dt><kbd class="osc">/transport_frame</kbd></dt>
+  <dd>Ardour sends /transport_frame <em>current_frame</em></dd>
+  <dt><kbd class="osc">/transport_speed</kbd></dt>
+  <dd>Ardour sends /transport_speed <em>speed</em></dd>
+  <dt><kbd class="osc">/record_enabled</kbd></dt>
+  <dd>Ardour sends /record_enabled <em>recordenable_status</em></dd>
+</dl>
+
+<h4>Editing-related</h4>
+<dl class="bindings">
+  <dt><kbd class="osc">/undo</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/redo</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/save_state</kbd></dt>
+  <dd>(this is the regular <kbd class="menu">Session &gt; Save</kbd>
+  operation)</dd>
+  <dt><kbd class="osc">/quick_snapshot_switch</kbd></dt>
+  <dd>Take a snapshot and switch to new version</dd>
+  <dt><kbd class="osc">/quick_snapshot_stay</kbd></dt>
+  <dd>Take a snapshot and keep working on this version</dd>
+  <dt><kbd class="osc">/fit_*_track(s)</kbd></dt>
+  <dd>Were <em>*</em> is one of 1, 2, 4, 8, 16, 32 or all. Fits this
+  many tracks in editor window. (add s for more than 1)</dd>
+  <dt><kbd class="osc">/zoom_*</kbd></dt>
+  <dd>Zoom editor to include <em>*</em> where <em>*</em> is 100_ms, 1_sec,
+  10_sec, 1_min, 5_min, 10_min or to_session</dd>
+  <dt><kbd class="osc">/temporal_zoom_in</kbd></dt>
+  <dd>Zoom editor in to show less time</dd>
+  <dt><kbd class="osc">/temporal_zoom_out</kbd></dt>
+  <dd>Zoom editor out to show more time</dd>
+  <dt><kbd class="osc">/scroll_up_1_track</kbd></dt>
+  <dd>Scroll the editor pane up 1 track</dd>
+  <dt><kbd class="osc">/scroll_up_1_page</kbd></dt>
+  <dd>Scroll the editor pane up 1 page</dd>
+  <dt><kbd class="osc">/scroll_dn_1_track</kbd></dt>
+  <dd>Scroll the editor pane down 1 track</dd>
+  <dt><kbd class="osc">/scroll_dn_1_page</kbd></dt>
+  <dd>Scroll the editor pane down 1 page</dd>
+</dl>
+
+<h4>Recording control</h4>
+<dl class="bindings">
+  <dt><kbd class="osc">/toggle_punch_in</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/toggle_punch_out</kbd></dt>
+  <dd></dd>
+  <dt><kbd class="osc">/set_punch_range</kbd></dt>
+  <dd>Uses edit range as punch range</dd>
+  <dt><kbd class="osc">/rec_enable_toggle</kbd></dt>
+  <dd></dd>
+  <!--dt><kbd class="osc">/toggle_all_rec_enables</kbd></dt>
+  <dd>(toggles all tracks' recording state)</dd-->
+  <dt><kbd class="osc">/stop_forget</kbd></dt>
+  <dd>Stop transport and delete/forget last take</dd>
+</dl>
+
+<h4>Master and Monitor strip control</h4>
+<dl class="bindings">
+  <dt><kbd class="osc">/master/gain <em>dB</em></kbd></dt>
+  <dd>See gain in strips</dd>
+  <dt><kbd class="osc">/master/fader  <em>position</em></kbd></dt>
+  <dd>See fader in strips</dd>
+  <dt><kbd class="osc">/master/trimdB <em>dB</em></kbd></dt>
+  <dd>see trimdb in strips</dd>
+  <dt><kbd class="osc">/master/pan_stereo_position <em>position</em></kbd></dt>
+  <dd>See pan_stereo_position in strips</dd>
+  <dt><kbd class="osc">/master/mute  <em>yn</em></kbd></dt>
+  <dd>See mute in strips</dd>
+  <dt><kbd class="osc">/monitor/gain <em>dB</em></kbd></dt>
+  <dd>See gain in strips</dd>
+  <dt><kbd class="osc">/monitor/fader  <em>position</em></kbd></dt>
+  <dd>See fader in strips</dd>
+</dl>
+
+<h3>Track specific operations</h3>
+<p>
+  For each of the following, <em>ssid</em> is the Surface Strip ID for the track
+</p>
+<p class="note">
+  SSID has a different meaning than RID in Ardour version 4.7 and before.
+  Effectively, banking is always being used and the SSID is generated on
+  the fly. The SSID is the position of the strip within bank as an int
+  1 to bank size. There are no gaps as there have been in the past.
+  Depending on the value of strip_types sent to Ardour, Master and
+  Monitor, may be included in the list of SSIDs or not as set in
+  <em>/set_surface</em>.
+</p>
+<p class="note">
+  Some Surfaces (many Android applets) are not able to deal with more
+  than one parameter in a command. However, the two parameter commands
+  below can also be sent as /strip/command/ssid param. In this case the
+  param should be a float even if an int is required below.
+</p>
+<dl class="bindings">
+  <dt><kbd class="osc">/bank_up </kbd></dt>
+  <dd>Change bank to the next higher bank.</dd>
+  <dt><kbd class="osc">/bank_down </kbd></dt>
+  <dd>Change bank to the next lower bank.</dd>
+  <dt><kbd class="osc">/strip/mute <em>ssid</em> <em>mute_st</em></kbd></dt>
+  <dd>where <em>mute_st</em> is a bool/int representing the desired mute state of the track</dd>
+  <dt><kbd class="osc">/strip/solo <em>ssid</em> <em>solo_st</em></kbd></dt>
+  <dd>where <em>solo_st</em> is a bool/int representing the desired solo state of the track</dd>
+  <dt><kbd class="osc">/strip/solo_iso <em>ssid</em> <em>state</em></kbd></dt>
+  <dd>where <em>state</em> is a bool/int representing the desired solo isolate state of the track</dd>
+  <dt><kbd class="osc">/strip/solo_safe <em>ssid</em> <em>state</em></kbd></dt>
+  <dd>where <em>state</em> is a bool/int representing the desired solo safe/lock state of the track</dd>
+  <dt><kbd class="osc">/strip/monitor_input <em>ssid</em> <em>monitor_st</em></kbd></dt>
+  <dd>where <em>monitor_st</em> is a bool/int where 1 is forced input monitoring.</dd>
+  <dt><kbd class="osc">/strip/monitor_disk <em>ssid</em> <em>monitor_st</em></kbd></dt>
+  <dd>where <em>monitor_st</em> is a bool/int where 1 is forced disk monitoring. When input and disk are both off,
+  Auto monitoring is enabled.</dd>
+  <dt><kbd class="osc">/strip/recenable <em>ssid</em> <em>rec_st</em></kbd></dt>
+  <dd>where <em>rec_st</em> is a bool/int representing the desired rec state of the track</dd>
+  <dt><kbd class="osc">/strip/record_safe <em>ssid</em> <em>rec_st</em></kbd></dt>
+  <dd>where <em>rec_st</em> is a bool/int representing the desired record safe state of the track</dd>
+  <dt><kbd class="osc">/strip/polarity <em>ssid</em> <em>invert</em></kbd></dt>
+  <dd>where <em>invert</em> is a bool/int representing the desired polarity of the track</dd>
+  <dt><kbd class="osc">/strip/gain <em>ssid</em>  <em>gain</em></kbd></dt>
+  <dd>where <em>gain</em> is a float ranging from -193 to 6 representing the desired gain of the track in dB.</dd>
+  <dt><kbd class="osc">/strip/fader <em>ssid</em>  <em>position</em></kbd></dt>
+  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the fader control position.</dd>
+  <dt><kbd class="osc">/strip/trimdB <em>ssid</em>  <em>trim_db</em></kbd></dt>
+  <dd>where <em>trim_db</em> is a float ranging from -20 to 20 representing the desired trim of the track in dB.</dd>
+  <dt><kbd class="osc">/strip/pan_stereo_position <em>ssid</em> <em>position</em></kbd></dt>
+  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired pan position of the track</dd>
+  <dt><kbd class="osc">/strip/pan_stereo_width <em>ssid</em> <em>width</em></kbd></dt>
+  <dd>where <em>width</em> is a float ranging from 0 to 1 representing the desired pan width of the track</dd>
+  <dt><kbd class="osc">/strip/send/gain <em>ssid</em> <em>sendid</em> <em>send_gain</em></kbd></dt>
+  <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
+  ranging from -193 to +6 representing the desired gain in dB for the send</dd>
+  <dt><kbd class="osc">/strip/send/fader <em>ssid</em> <em>sendid</em> <em>send_gain</em></kbd></dt>
+  <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
+  ranging from 0 to 1 representing the desired position for the send as a fader</dd>
+  <dt><kbd class="osc">/strip/send/enable <em>ssid</em> <em>sendid</em> <em>state</em></kbd></dt>
+  <dd>where <em>sendid</em> = nth_send, <em>state</em> is 1 for enabled and 0 for disabled</dd>
+  <dt><kbd class="osc">/strip/list </kbd></dt>
+  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
+  Querying Ardour with OSC.</a></dd>
+  <dt><kbd class="osc">/strip/sends <em>ssid</em></kbd></dt>
+  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
+  Querying Ardour with OSC.</a></dd>
+  <dt><kbd class="osc">/strip/receives <em>ssid</em></kbd></dt>
+  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
+  Querying Ardour with OSC.</a></dd>
+  <dt><kbd class="osc">/strip/plugin/list <em>ssid</em></kbd></dt>
+  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
+  Querying Ardour with OSC.</a></dd>
+  <dt><kbd class="osc">/strip/plugin/descriptor <em>ssid</em></kbd></dt>
+  <dd>see: <a href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
+  Querying Ardour with OSC.</a></dd>
+  <dt><kbd class="osc">/strip/plugin/reset <em>ssid</em> <em>piid</em> </kbd></dt>
+  <dd>where <em>piid</em> = nth Plugin, will reset all values to the plugin's original values</dd>
+  <dt><kbd class="osc">/strip/plugin/activate <em>ssid</em> <em>piid</em> </kbd></dt>
+  <dd>where <em>piid</em> = nth Plugin, will set the plugin's state to active</dd>
+  <dt><kbd class="osc">/strip/plugin/deactivate <em>ssid</em> <em>piid</em> </kbd></dt>
+  <dd>where <em>piid</em> = nth Plugin, will set the plugin's state to inactive</dd>
+  <dt><kbd class="osc">/strip/plugin/parameter <em>ssid</em> <em>piid</em> <em>param</em> <em>value</em></kbd></dt>
+  <dd>where <em>piid</em> = nth Plugin, <em>param</em> = nth param, <em>value</em>
+  is a float ranging from 0 to 1 representing the desired parameter value</dd>
+  <dt><kbd class="osc">/strip/name <em>ssid</em> <em>name</em></kbd></dt>
+  <dd>where <em>name</em> is a string for the desired name of the track</dd>
+</dl>
+<h3>Selected Strip Operations</h3>
+<p>
+  New for Ardour 5, A whole set of operations that work on the selected
+  or expanded strip.
+</p>
+<p class="note">
+  Selected strip operations are complex enough for their own page.
+  Please read: <a
+  href="/using-control-surfaces/controlling-ardour-with-osc/selection-considerations-in-osc/">
+  Selection Considerations in OSC.</a> This is most important if more
+  than one OSC surface is being used with Ardour.
+</p>
+<p>
+  There are two kinds of selection in OSC. GUI selection and local
+  expansion. By default expansion follows selection.
+  <ul>
+       <li>
+               GUI selection: Use <em>/strip/select</em> to set.  Selecting
+               a strip in the GUI will set OSC surface select and the surface
+               will set GUI selection as well.
+       </li>
+       <li>
+               Local expansion: Use <em>/strip/expand</em> to expand a strip
+               without changing overall selection. When /strip/expand is set
+               to 0 or false, the select channel will go back to using the
+               strip selected by the GUI. While expand is turned on,
+               selecting a strip on the GUI does not
+               select the OSC strip. Sending a /strip/select message will
+               override the expand as if it had been set to false.
+               Good for more than one OSC controller at a time.
+       </li>
+  </ul>
+</p>
+
+<dl class="bindings">
+  <dt><kbd class="osc">/strip/select <em>ssid</em> <em>y/n</em></kbd></dt>
+  <dd>Where <em>y/n</em> = 1 for select. Sets both GUI select and strip
+  to expanded mode. (0 is ignored)</dd>
+  <dt><kbd class="osc">/strip/expand <em>ssid</em> <em>y/n</em></kbd></dt>
+  <dd>Where <em>y/n</em> = 1 for expanded mode. Sets only local strip to
+  Expanded. Setting to 0 resets the expansion to follow selection.</dd>
+  <dt><kbd class="osc">/select/expand <em>y/n</em></kbd></dt>
+  <dd>Where <em>y/n</em> = 1 for expanded mode, 0 for Select mode.</dd>
+  <dt><kbd class="osc">/select/recenable <em>y/n</em></kbd></dt>
+  <dd>Where <em>y/n</em> is 1 for enabled and 0 for disabled</dd>
+  <dt><kbd class="osc">/select/record_safe <em>y/n</em></kbd></dt>
+  <dd>Where <em>y/n</em> is 1 for safe and 0 for unlocked</dd>
+  <dt><kbd class="osc">/select/mute <em>y/n</em></kbd></dt>
+  <dd>Where <em>y/n</em> is 1 for enabled and 0 for disabled</dd>
+  <dt><kbd class="osc">/select/solo <em>y/n</em></kbd></dt>
+  <dd>Where <em>y/n</em> is 1 for enabled and 0 for disabled</dd>
+  <dt><kbd class="osc">/select/solo_iso <em>state</em></kbd></dt>
+  <dd>where <em>state</em> is a bool/int representing the desired solo isolate state of the track</dd>
+  <dt><kbd class="osc">/select/solo_safe <em>state</em></kbd></dt>
+  <dd>where <em>state</em> is a bool/int representing the desired solo safe/lock state of the track</dd>
+  <dt><kbd class="osc">/select/monitor_input <em>y/n</em></kbd></dt>
+  <dd>Where <em>y/n</em> is 1 for monitor from input and 0 for auto</dd>
+  <dt><kbd class="osc">/select/monitor_disk <em>y/n</em></kbd></dt>
+  <dd>Where <em>y/n</em> is 1 for monitor from disk and 0 for auto</dd>
+  <dt><kbd class="osc">/select/polarity <em>invert</em></kbd></dt>
+  <dd>where <em>invert</em> is a bool/int representing the desired polarity of the track</dd>
+  <dt><kbd class="osc">/select/gain <em>gain</em></kbd></dt>
+  <dd>Where <em>gain</em> is a float ranging from -193 to 6 representing the desired gain of the track in dB.</dd>
+  <dt><kbd class="osc">/select/fader <em>position</em></kbd></dt>
+  <dd>Where <em>position</em> is an float ranging from 0 to 1 representing the fader control position.</dd>
+  <dt><kbd class="osc">/select/trimdB <em>trim_db</em></kbd></dt>
+  <dd>where <em>trim_db</em> is a float ranging from -20 to 20 representing the desired trim of the track in dB.</dd>
+  <dt><kbd class="osc">/select/pan_stereo_position <em>position</em></kbd></dt>
+  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired pan position of the track</dd>
+  <dt><kbd class="osc">/select/pan_stereo_width <em>width</em></kbd></dt>
+  <dd>where <em>width</em> is a float ranging from 0 to 1 representing the desired pan width of the track</dd>
+  <dt><kbd class="osc">/select/pan_elevation_position <em>position</em></kbd></dt>
+  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired pan elevation of the track</dd>
+  <dt><kbd class="osc">/select/pan_frontback_position <em>position</em></kbd></dt>
+  <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired front to back position of the track</dd>
+  <dt><kbd class="osc">/select/pan_lfe_control <em>value</em></kbd></dt>
+  <dd>where <em>value</em> is a float ranging from 0 to 1 representing the desired LFE control value for the track</dd>
+  <dt><kbd class="osc">/select/send_gain", <em>sendid</em> <em>send_gain</em></kbd></dt>
+  <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
+  ranging from -193 to +6 representing the desired gain in dB for the send</dd>
+  <dt><kbd class="osc">/select/send_fader", <em>sendid</em> <em>send_gain</em></kbd></dt>
+  <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
+  ranging from 0 to 1 representing the desired position for the send as a fader</dd>
+  <dt><kbd class="osc">/select/send_enable", <em>sendid</em> <em>state</em></kbd></dt>
+  <dd>where <em>sendid</em> = nth_send, <em>state</em> is 1 for enabled and 0 for disabled</dd>
+</dl>
+
+<h3>Menu actions</h3>
+<p>
+  Every single menu item in Ardour's GUI is accessible via OSC. There is
+  a single common syntax to trigger the action as if it was selected
+  with the mouse (or keyboard):</p>
+<kbd class="osc">/access_action <em>action_name</em></kbd>
+<p>
+  The <a
+  href="/using-control-surfaces/controlling-ardour-with-osc/osc-actions-list/">
+  list of actions</a> shows all available values of <em>action-name</em> as of
+  June 2016 for Ardour 5.0.pre0.1. You can get the current list at any
+  time by running Ardour with the -b flag.
+  </p>
+
+{% children %}
similarity index 98%
rename from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/06_osc-setup-dialog.html
rename to _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/02_osc-setup-dialog.html
index ffa9948c813c52e22ccb62086b1d989ade670981..d21edf866342a0c519dd880a97e3cc596a280a36 100644 (file)
@@ -1,7 +1,7 @@
 ---
 layout: default
-title: Using the OSC Setup Dialog
----                        
+title: OSC&#58; Using the Setup Dialog
+---
 
 <p>
   Starting with Ardour 5.1 OSC has a graphic setup dialog. This dialog
similarity index 98%
rename from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/07_querying-ardour-with-osc.html
rename to _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/03_querying-ardour-with-osc.html
index 3ad110fbac59878511212a0879f8c2d776bf2dc7..13e732279c0970fd76ddae1e8071fb802a7e1475 100644 (file)
@@ -1,7 +1,7 @@
 ---
 layout: default
-title: Querying Ardour with OSC
----                        
+title: OSC&#58; Querying Ardour
+---
 
 <p>
   In order to make a custom controller that knows what strips Ardour
similarity index 99%
rename from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/02_feedback-in-osc.html
rename to _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/04_feedback-in-osc.html
index 2214d0d4ce28d4c11dd8cd4fae29c5bdd779c8a4..1b4055748ebf6eef4a4a216b6ae75c200e354d99 100644 (file)
@@ -1,13 +1,13 @@
 ---
 layout: default
-title: OSC Feedback With Ardour
----                        
-  
+title: OSC&#58; Feedback
+---
+
 <p>
   Feedback from the Ardour to the the control surface is very useful for
   a number of things. Motor faders need to know where the the track
   they have been attached to is at before they were assigned otherwise
-  the DAW fader will jump to where the controller fader is. Likewise, 
+  the DAW fader will jump to where the controller fader is. Likewise,
   the buttons on each strip need to know what their value is so they can
   light their LED correctly. Transport controls should let you know if
   they are active too. This is what feedback is all about.
@@ -177,7 +177,7 @@ title: OSC Feedback With Ardour
   <dt><kbd class="osc">/bank_down <em>LED</em></kbd></dt>
   <dd>where <em>LED</em> is a bool that indicates another bank_down operation is possible.</dd>
   <dt><kbd class="osc">/strip/name <em>ssid</em> <em>track_name</em></kbd></dt>
-  <dd>where <em>track_name</em> is a string representing the name of the track 
+  <dd>where <em>track_name</em> is a string representing the name of the track
   (note there is no coresponding command to set the track name)</dd>
   <dt><kbd class="osc">/strip/mute <em>ssid</em> <em>mute_st</em></kbd></dt>
   <dd>where <em>mute_st</em> is a bool/int representing the actual mute state of the track</dd>
@@ -1,7 +1,7 @@
 ---
 layout: default
-title: Calculating Feedback and Strip-types Values
----                        
+title: OSC&#58; Feedback and Strip-types Values
+---
 
 <p><em>/set_surface</em> has two values the user needs to calculate before
   use. In general these will not be calculated at run time, but
@@ -20,7 +20,7 @@ title: Calculating Feedback and Strip-types Values
   strip_types is an integer made up of bits. The easy way to
   deal with this is to think of strip_types items being worth a number and
   then adding all those numbers together for a value to send.
-  Strip Types will determine What kind of strips will be included in 
+  Strip Types will determine What kind of strips will be included in
   bank. This would include: Audio, MIDI, busses, VCAs, Master, Monitor
   and hidden or selected strips.
 </p>
@@ -77,7 +77,7 @@ title: Calculating Feedback and Strip-types Values
   Audio Aux? say what? I am sure most people will have noticed that they
   can find no <em>Aux</em> strips in the Ardour mixer. There are none.
   There are buses that can be used a number of ways. From analog days,
-  in OSC a bus is something that gets used as a sub mix before ending up
+  in OSC, a bus is something that gets used as a sub mix before ending up
   going to Master. An auxiliary bus is used like a separate mixer and
   it's output goes outside the program or computer to be used as:
   a monitor mix, a back up recording, or what have you. In OSC where
@@ -89,7 +89,7 @@ title: Calculating Feedback and Strip-types Values
   to enable both buses and auxes if they would prefer.
 </p>
 
-<h3>feedback</h3> 
+<h3>feedback</h3>
 <p>Feedback is an integer made up of bits. The easy way to
   deal with this is to think of feedback items being worth a number and
   then adding all those numbers together for a value to send.
similarity index 87%
rename from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/05_selection-considerations-in-osc.html
rename to _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/08_selection-considerations-in-osc.html
index 63b16bcd4269065749e7caed700e9cb65dada3a3..3996b498963e796d5039d7ce0432fce09c6bb097 100644 (file)
@@ -1,6 +1,6 @@
 ---
 layout: default
-title: Selection/Feedback Expansion Considerations in OSC
+title: OSC&#58; Selection and Expansion Considerations
 ---
 
 <p>
@@ -38,6 +38,9 @@ title: Selection/Feedback Expansion Considerations in OSC
   selection is global and affects all controllers using GUI selection
   as well as the GUI.
 </p>
+<p class="note">
+       Both select and expansion use the /select set of commands.
+</p>
 <p>
   In general, in a one user situation where that one user may use either
   the OSC surface or the GUI, using GUI based selection makes the most
@@ -62,8 +65,8 @@ title: Selection/Feedback Expansion Considerations in OSC
   and commands locally without changing the GUI select. Another
   /strip/expand or a /strip/select will override that expand command
   and releasing the /strip/expand or /select/expand (setting it to 0 or
-  false) will set the /select set of commands/feedback back to whichever
-  strip the GUI has selected at that time. This could be used to switch
-  between the GUI select and the local expand to compare two strips
-  settings.
+  false) will set the /select set of commands and feedback back to
+  whichever strip the GUI has selected at that time. This could be used
+  to switch between the GUI select and the local expand to compare two
+  strips settings.
 </p>
similarity index 99%
rename from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/01_osc-control-in-ardour-4.7-and-prior.html
rename to _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/10_osc-control-in-ardour-4.7-and-prior.html
index 141ec811e0d7eefb8121832f60c0700c95df1ff7..1b1e470eda8c1106c9a570d4d119870377eefaf2 100644 (file)
@@ -1,29 +1,35 @@
 ---
 layout: default
-title: Controlling Ardour with OSC (Ardour 4.7 and Prior)
----                        
-  
+title: OSC control for Ardour 4.7 and Prior
+---
+
+<p class="note">
+       This page is what was available before version 5.* was added. It has
+       not been updated to make sure all 4.7 functionality is acurately
+       represented. This page will vanish soon.
+</p>
+
 <p>
-  <abbr title="Open Sound Control"><dfn>OSC</dfn></abbr> lets synthesizers 
-  and other devices communicate with Ardour. OSC devices can send commands 
-  relating to playback (such as play or stop), performance (such as volume, 
+  <abbr title="Open Sound Control"><dfn>OSC</dfn></abbr> lets synthesizers
+  and other devices communicate with Ardour. OSC devices can send commands
+  relating to playback (such as play or stop), performance (such as volume,
   play, stop, and almost any other function (such as Edit, or Undo).
 </p>
 <p>
-  Ardour is probably one of the most OSC-controllable audio applications 
-  around, but as with all OSC-controllable apps, you can't do much without 
-  knowing what <dfn>messages</dfn> can be sent. This document describes the 
-  various categories of messages that Ardour understands. It is subject to 
-  change, particularly the "Actions" part below, since this relates to the 
+  Ardour is probably one of the most OSC-controllable audio applications
+  around, but as with all OSC-controllable apps, you can't do much without
+  knowing what <dfn>messages</dfn> can be sent. This document describes the
+  various categories of messages that Ardour understands. It is subject to
+  change, particularly the "Actions" part below, since this relates to the
   GTK GUI for Ardour rather than the backend.
 </p>
 
 <h2>Connecting to Ardour via OSC</h2>
 <p>
-  OSC support is not enabled by default, but can be turned on via 
-  <kbd class="menu">Edit &gt; Preferences &gt; Control Surfaces</kbd>. 
-  Once enabled, Ardour will listen on port <code>3819</code> by default. 
-  This port number can be changed by editing <code>$ARDOUR_CONFIG</code> 
+  OSC support is not enabled by default, but can be turned on via
+  <kbd class="menu">Edit &gt; Preferences &gt; Control Surfaces</kbd>.
+  Once enabled, Ardour will listen on port <code>3819</code> by default.
+  This port number can be changed by editing <code>$ARDOUR_CONFIG</code>
   and adding this line within the <code>&lt;Config&gt;</code> section:
 </p>
 <kbd class="input">&lt;Option name="osc-port" value="<em>Your choice
@@ -55,7 +61,7 @@ here</em>"/&gt;</kbd>
   <dd></dd>
   <dt><kbd class="osc">/ardour/locate <em>spos</em> <em>roll</em></kbd></dt>
   <dd>where <em>spos</em> is the target position in samples and
-  <em>roll</em> is a bool/integer defining whether you want transport 
+  <em>roll</em> is a bool/integer defining whether you want transport
   to be kept rolling or not</dd>
   <dt><kbd class="osc">/ardour/loop_toggle</kbd></dt>
   <dd></dd>
@@ -579,7 +585,7 @@ here</em>"/&gt;</kbd>
   <dt><kbd class="osc">Region/trim-to-next-region</kbd></dt><dd>Trim to Next</dd>
   <dt><kbd class="osc">Region/trim-to-previous-region</kbd></dt><dd>Trim to Previous</dd>
   <dt><kbd class="osc">Region/uncombine-regions</kbd></dt><dd>Uncombine</dd>
-  <dt><kbd class="osc">Rulers/toggle-bbt-ruler</kbd></dt><dd>Bars & Beats</dd>
+  <dt><kbd class="osc">Rulers/toggle-bbt-ruler</kbd></dt><dd>Bars &amp; Beats</dd>
   <dt><kbd class="osc">Rulers/toggle-cd-marker-ruler</kbd></dt><dd>CD Markers</dd>
   <dt><kbd class="osc">Rulers/toggle-loop-punch-ruler</kbd></dt><dd>Loop/Punch</dd>
   <dt><kbd class="osc">Rulers/toggle-marker-ruler</kbd></dt><dd>Markers</dd>
@@ -633,8 +639,8 @@ here</em>"/&gt;</kbd>
   <dt><kbd class="osc">Transport/Loop</kbd></dt><dd>Play Loop Range</dd>
   <dt><kbd class="osc">Transport/PlayPreroll</kbd></dt><dd>Play Selection w/Preroll</dd>
   <dt><kbd class="osc">Transport/PlaySelection</kbd></dt><dd>Play Selected Range</dd>
-  <dt><kbd class="osc">Transport/primary-clock-bbt</kbd></dt><dd>Bars & Beats</dd>
-  <dt><kbd class="osc">Transport/primary-clock-minsec</kbd></dt><dd>Minutes & Seconds</dd>
+  <dt><kbd class="osc">Transport/primary-clock-bbt</kbd></dt><dd>Bars &amp; Beats</dd>
+  <dt><kbd class="osc">Transport/primary-clock-minsec</kbd></dt><dd>Minutes &am Seconds</dd>
   <dt><kbd class="osc">Transport/primary-clock-samples</kbd></dt><dd>Samples</dd>
   <dt><kbd class="osc">Transport/primary-clock-timecode</kbd></dt><dd>Timecode</dd>
   <dt><kbd class="osc">Transport/Record</kbd></dt><dd>Enable Record</dd>
@@ -643,8 +649,8 @@ here</em>"/&gt;</kbd>
   <dt><kbd class="osc">Transport/Rewind</kbd></dt><dd>Rewind</dd>
   <dt><kbd class="osc">Transport/RewindSlow</kbd></dt><dd>Rewind (Slow)</dd>
   <dt><kbd class="osc">Transport/Roll</kbd></dt><dd>Roll</dd>
-  <dt><kbd class="osc">Transport/secondary-clock-bbt</kbd></dt><dd>Bars & Beats</dd>
-  <dt><kbd class="osc">Transport/secondary-clock-minsec</kbd></dt><dd>Minutes & Seconds</dd>
+  <dt><kbd class="osc">Transport/secondary-clock-bbt</kbd></dt><dd>Bars &amp; Beats</dd>
+  <dt><kbd class="osc">Transport/secondary-clock-minsec</kbd></dt><dd>Minutes &amp; Seconds</dd>
   <dt><kbd class="osc">Transport/secondary-clock-samples</kbd></dt><dd>Samples</dd>
   <dt><kbd class="osc">Transport/secondary-clock-timecode</kbd></dt><dd>Timecode</dd>
   <dt><kbd class="osc">Transport/Stop</kbd></dt><dd>Stop</dd>