3 <abbr title="Open Sound Control"><dfn>OSC</dfn></abbr> lets synthesizers
4 and other devices communicate with Ardour. OSC devices can send commands
5 relating to playback (such as play or stop), performance (such as volume,
6 play, stop, and almost any other function (such as Edit, or Undo).
10 <em>Note:</em> OSC control has changed dramatically since Ardour 4.7.
11 The Path structure has been completely redone, Banking has been introduced,
12 The controller is now able to tell Ardour what kind of feedback it can
13 work with (including bank size) and two new math styles have been added
14 to gain controls. If you are using an Ardour version of 4.7 or less,
16 href="/using-control-surfaces/controlling-ardour-with-osc/osc-control-in-ardour-4.7-and-prior/">
17 Osc control in ardour 4.7 and prior.</a>
21 Ardour is probably one of the most OSC-controllable audio applications
22 around, but as with all OSC-controllable apps, you can't do much without
23 knowing what <dfn>messages</dfn> can be sent. This document describes the
24 various categories of messages that Ardour understands. It is subject to
25 change, particularly the "Actions" part below, since this relates to the
26 GTK GUI for Ardour rather than the backend.
29 <h2>Connecting to Ardour via OSC</h2>
31 OSC support is not enabled by default, but can be turned on via
32 <kbd class="menu">Edit > Preferences > Control Surfaces</kbd>.
33 Once enabled, Ardour will listen on port <code>3819</code> by default.
34 This port number can be changed by editing <code>$ARDOUR_CONFIG</code>
35 and adding this line within the <code><Config></code> section:
37 <kbd class="input"><Option name="osc-port" value="<em>Your choice
41 Ardour sends any feedback to the port and address that sent any
42 feedback request. The port does not have to match Ardour's port. In
43 fact it is better not to. This means that Ardour can deal with more
44 than one controller at a time. The two controllers can bank
45 independently and even use different math for faders. This could be
46 used to allow talent to adjust their own monitor mix using a tablet
47 or phone that can run an OSC controller. For a full explanation of
48 how Ardour's feedback works please read <a
49 href="/using-control-surfaces/controlling-ardour-with-osc/feedback-in-osc/">
50 OSC feedback In Ardour.</a>
53 <h2>Control Surface Set Up</h2>
56 Control surface set up allows the controller to tell Ardour about it's
57 capabilities. The surface can tell Ardour how many control strips it
58 has for banking, if it is capable of setting it's faders or buttons
59 to values set by Ardour's GUI or automation, What kind of math the
63 Any time the <em>/set_surface</em> command is sent, the current bank
64 is recalculated and if feedback is turned on, the values of each
65 strip's controls are sent (or refreshed) as well. This will also
66 refresh the Master feedback setup.
69 Surface Port Setting is available in the OSC GUI.
72 As of Ardour 5.1, There is now a GUI setup in response to those using
73 tablets with applications such as touchOSC or AndrOSC who need to be
74 able to set a port for Ardour to send to. It can also change the
75 default setting for set_surface. For more information about Ardour's
76 OSC configuration GUI please read <a
77 href="/using-control-surfaces/controlling-ardour-with-osc/osc-setup-dialog/">
78 Ardour's Setup Dialog.</a>
80 <p>If /set_surface is not sent, the default values are used:
82 <li><em>Bank Size</em>: 0—No banking (or infinite bank size).</li>
83 <li><em>Strip Types</em>: All strip types except hidden and special.</li>
84 <li><em>Feedback</em>: 0—All off.</li>
85 <li><em>Fader Mode</em>: 0—gain in dB (not relevant with feedback off)</li>
89 These values give the same behaviour as prior versions of Ardour. (or the closest possible)
92 <dt><kbd class="osc">/set_surface <em>bank_size</em> <em>strip_types</em>
93 <em>feedback</em> <em>fadermode</em></kbd></dt>
95 See below for an explanation of each parameter.
100 Bank Size is the number of channel strips the controller supports
101 without banking. Setting this to 0 turns banking off by setting the
102 bank size to infinite.
105 Bank size can also be set with <em>/set_surface/bank_size size.</em>
109 strip_types is an integer made up of bits. The easy way to
110 deal with this is to think of strip_types items being worth a number and
111 then adding all those numbers together for a value to send.
112 Strip Types will determine what kind of strips will be included in
113 bank. This would include: Audio, MIDI, busses, VCAs, Master, Monitor
114 and hidden or selected strips.
117 Aside from setting the track types for the main mix assignments, using
118 /set_surface/strip_types with more than one surface button will allow
119 switching between modes for example: inputs only, busses only,
120 selected only, hidden only, by having the buttons send values of: 3,
121 12, 256, 512. A full mix button might have a value 31.
124 While Master and Monitor are listed as possibilities, most surfaces
125 will not use them. Using /master and /monitor makes more sense.
126 However, in the case where there are no master or monitor fader strips
127 on the surface, it may be necessary to include them in the banked
131 href="/using-control-surfaces/controlling-ardour-with-osc/calculating-feedback-and-strip-types-values/">
132 Calculating Feedback and Strip-types Values.</a>
135 Strip types can also be set with <em>/set_surface/strip_types types.</em>
138 <p>Feedback is an integer made up of bits. The easy way to
139 deal with this is to think of feedback items being worth a number and
140 then adding all those numbers together for a value to send.
143 href="/using-control-surfaces/controlling-ardour-with-osc/calculating-feedback-and-strip-types-values/">
144 Calculating Feedback and Strip-types Values.</a></p>
146 Feedback can also be set with <em>/set_surface/feedback feedback.</em>
151 Gainmode is a an int that acts as a bool:
153 <li><em>0 (or false)</em> dB value as a float from -193 to +6. Sent as
154 /strip/gain SSID value. (-193 or below are the same as -inf)</li>
155 <li><em>1 (or true)</em> A positional fader based on the same math
156 as Ardour's GUI. An Float from 0 to 1. Sent as
157 /strip/fader SSID value</li>
161 Gainmode applies only to feedback values. The controller can choose
162 which gain math to use by choosing to use the /*/gain or /*/fader path
163 to send to Ardour. This makes sure a controller that doesn't set up
164 Ardour's OSC can still use either math. The gainmode for feedback also
165 determines the path Ardour uses for feedback so that the feedback
166 messages match the control messages.
169 Gain mode can also be set with <em>/set_surface/gainmode gainmode.</em>
172 <h2>Querying Ardour for information</h2>
174 The control Surface may wish to control the type a frequency of
175 updates it receives. It can do this with querying commands. See: <a
176 href="/using-control-surfaces/controlling-ardour-with-osc/querying-ardour-with-osc/">
177 Querying Ardour with OSC.</a>
180 <h2>List of OSC messages</h2>
182 Parameter types show how the value will be used. However, they may
183 be sent as a different type if needed, see: <a
184 href="/using-control-surfaces/controlling-ardour-with-osc/parameter-types-in-osc/">
185 Parameter Types in OSC.</a>
187 <h3>Master or Global messages</h3>
189 <h4>Transport Control</h4>
190 <dl class="bindings">
191 <dt><kbd class="osc">/transport_stop</kbd></dt>
193 <dt><kbd class="osc">/transport_play</kbd></dt>
195 <dt><kbd class="osc">/toggle_roll</kbd></dt>
196 <dd>Toggles between play and stop</dd>
197 <dt><kbd class="osc">/set_transport_speed <em>s</em></kbd></dt>
198 <dd>where <em>s</em> is a float ranging from -8.0f to 8.0f</dd>
199 <dt><kbd class="osc">/ffwd</kbd></dt>
201 <dt><kbd class="osc">/rewind</kbd></dt>
203 <dt><kbd class="osc">/goto_start</kbd></dt>
205 <dt><kbd class="osc">/goto_end</kbd></dt>
207 <dt><kbd class="osc">/jump_bars <em>bars</em></kbd></dt>
208 <dd>Where <em>bars</em> is a float (+/-) of the number of bars to jump</dd>
209 <dt><kbd class="osc">/jump_seconds <em>seconds</em></kbd></dt>
210 <dd>Where <em>seconds</em> is a float (+/-) of the number of seconds to jump</dd>
211 <dt><kbd class="osc">/add_marker</kbd></dt>
212 <dd>(adds marker to the current transport position)</dd>
213 <dt><kbd class="osc">/remove_marker</kbd></dt>
214 <dd>Removes marker at the current transport position (if there is one)</dd>
215 <dt><kbd class="osc">/mark_in</kbd></dt>
216 <dd>Marks the begining of a range at the current transport position</dd>
217 <dt><kbd class="osc">/mark_out</kbd></dt>
218 <dd>Marks the end of a range at the current transport position</dd>
219 <dt><kbd class="osc">/next_marker</kbd></dt>
221 <dt><kbd class="osc">/prev_marker</kbd></dt>
223 <dt><kbd class="osc">/locate <em>spos</em> <em>roll</em></kbd></dt>
224 <dd>where <em>spos</em> is the target position in samples and
225 <em>roll</em> is a bool/integer defining whether you want transport
226 to be kept rolling or not</dd>
227 <dt><kbd class="osc">/loop_toggle</kbd></dt>
229 <dt><kbd class="osc">/loop_location <em>start</em> <em>end</em></kbd></dt>
230 <dd><em>start</em> is the beginning of a loop and <em>end</em> is the
231 end of a loop both are integer frame positions.</dd>
232 <dt><kbd class="osc">/set_loop_range</kbd></dt>
233 <dd>Uses edit range as loop range</dd>
234 <dt><kbd class="osc">/set_session_range</kbd></dt>
235 <dd>Uses edit range as session range</dd>
236 <dt><kbd class="osc">/toggle_click</kbd></dt>
238 <dt><kbd class="osc">/midi_panic</kbd></dt>
239 <dd>Ardour will send an all notes off to all midi tracks</dd>
240 <dt><kbd class="osc">/cancel_all_solos</kbd></dt>
241 <dd>Cancel All Solos/PFLs/AFLs</dd>
244 <h4>Transport Information</h4>
246 <dt><kbd class="osc">/transport_frame</kbd></dt>
247 <dd>Ardour sends /transport_frame <em>current_frame</em></dd>
248 <dt><kbd class="osc">/transport_speed</kbd></dt>
249 <dd>Ardour sends /transport_speed <em>speed</em></dd>
250 <dt><kbd class="osc">/record_enabled</kbd></dt>
251 <dd>Ardour sends /record_enabled <em>recordenable_status</em></dd>
254 <h4>Editing-related</h4>
255 <dl class="bindings">
256 <dt><kbd class="osc">/undo</kbd></dt>
258 <dt><kbd class="osc">/redo</kbd></dt>
260 <dt><kbd class="osc">/save_state</kbd></dt>
261 <dd>(this is the regular <kbd class="menu">Session > Save</kbd>
263 <dt><kbd class="osc">/quick_snapshot_switch</kbd></dt>
264 <dd>Take a snapshot and switch to new version</dd>
265 <dt><kbd class="osc">/quick_snapshot_stay</kbd></dt>
266 <dd>Take a snapshot and keep working on this version</dd>
267 <dt><kbd class="osc">/fit_*_track(s)</kbd></dt>
268 <dd>Were <em>*</em> is one of 1, 2, 4, 8, 16, 32 or all. Fits this
269 many tracks in editor window. (add s for more than 1)</dd>
270 <dt><kbd class="osc">/zoom_*</kbd></dt>
271 <dd>Zoom editor to include <em>*</em> where <em>*</em> is 100_ms, 1_sec,
272 10_sec, 1_min, 5_min, 10_min or to_session</dd>
273 <dt><kbd class="osc">/temporal_zoom_in</kbd></dt>
274 <dd>Zoom editor in to show less time</dd>
275 <dt><kbd class="osc">/temporal_zoom_out</kbd></dt>
276 <dd>Zoom editor out to show more time</dd>
277 <dt><kbd class="osc">/scroll_up_1_track</kbd></dt>
278 <dd>Scroll the editor pane up 1 track</dd>
279 <dt><kbd class="osc">/scroll_up_1_page</kbd></dt>
280 <dd>Scroll the editor pane up 1 page</dd>
281 <dt><kbd class="osc">/scroll_dn_1_track</kbd></dt>
282 <dd>Scroll the editor pane down 1 track</dd>
283 <dt><kbd class="osc">/scroll_dn_1_page</kbd></dt>
284 <dd>Scroll the editor pane down 1 page</dd>
287 <h4>Recording control</h4>
288 <dl class="bindings">
289 <dt><kbd class="osc">/toggle_punch_in</kbd></dt>
291 <dt><kbd class="osc">/toggle_punch_out</kbd></dt>
293 <dt><kbd class="osc">/set_punch_range</kbd></dt>
294 <dd>Uses edit range as punch range</dd>
295 <dt><kbd class="osc">/rec_enable_toggle</kbd></dt>
297 <!--dt><kbd class="osc">/toggle_all_rec_enables</kbd></dt>
298 <dd>(toggles all tracks' recording state)</dd-->
299 <dt><kbd class="osc">/stop_forget</kbd></dt>
300 <dd>Stop transport and delete/forget last take</dd>
303 <h4>Master and Monitor strip control</h4>
304 <dl class="bindings">
305 <dt><kbd class="osc">/master/gain <em>dB</em></kbd></dt>
306 <dd>See gain in strips</dd>
307 <dt><kbd class="osc">/master/fader <em>position</em></kbd></dt>
308 <dd>See fader in strips</dd>
309 <dt><kbd class="osc">/master/trimdB <em>dB</em></kbd></dt>
310 <dd>see trimdb in strips</dd>
311 <dt><kbd class="osc">/master/pan_stereo_position <em>position</em></kbd></dt>
312 <dd>See pan_stereo_position in strips</dd>
313 <dt><kbd class="osc">/master/mute <em>yn</em></kbd></dt>
314 <dd>See mute in strips</dd>
315 <dt><kbd class="osc">/monitor/gain <em>dB</em></kbd></dt>
316 <dd>See gain in strips</dd>
317 <dt><kbd class="osc">/monitor/fader <em>position</em></kbd></dt>
318 <dd>See fader in strips</dd>
321 <h3>Track specific operations</h3>
323 For each of the following, <em>ssid</em> is the Surface Strip ID for the track
326 SSID has a different meaning than RID in Ardour version 4.7 and before.
327 Effectively, banking is always being used and the SSID is generated on
328 the fly. The SSID is the position of the strip within bank as an int
329 1 to bank size. There are no gaps as there have been in the past.
330 Depending on the value of strip_types sent to Ardour, Master and
331 Monitor, may be included in the list of SSIDs or not as set in
332 <em>/set_surface</em>.
335 Some Surfaces (many Android applets) are not able to deal with more
336 than one parameter in a command. However, the two parameter commands
337 below can also be sent as /strip/command/ssid param. In this case the
338 param should be a float even if an int is required below.
340 <dl class="bindings">
341 <dt><kbd class="osc">/bank_up </kbd></dt>
342 <dd>Change bank to the next higher bank.</dd>
343 <dt><kbd class="osc">/bank_down </kbd></dt>
344 <dd>Change bank to the next lower bank.</dd>
345 <dt><kbd class="osc">/strip/mute <em>ssid</em> <em>mute_st</em></kbd></dt>
346 <dd>where <em>mute_st</em> is a bool/int representing the desired mute state of the track</dd>
347 <dt><kbd class="osc">/strip/solo <em>ssid</em> <em>solo_st</em></kbd></dt>
348 <dd>where <em>solo_st</em> is a bool/int representing the desired solo state of the track</dd>
349 <dt><kbd class="osc">/strip/solo_iso <em>ssid</em> <em>state</em></kbd></dt>
350 <dd>where <em>state</em> is a bool/int representing the desired solo isolate state of the track</dd>
351 <dt><kbd class="osc">/strip/solo_safe <em>ssid</em> <em>state</em></kbd></dt>
352 <dd>where <em>state</em> is a bool/int representing the desired solo safe/lock state of the track</dd>
353 <dt><kbd class="osc">/strip/monitor_input <em>ssid</em> <em>monitor_st</em></kbd></dt>
354 <dd>where <em>monitor_st</em> is a bool/int where 1 is forced input monitoring.</dd>
355 <dt><kbd class="osc">/strip/monitor_disk <em>ssid</em> <em>monitor_st</em></kbd></dt>
356 <dd>where <em>monitor_st</em> is a bool/int where 1 is forced disk monitoring. When input and disk are both off,
357 Auto monitoring is enabled.</dd>
358 <dt><kbd class="osc">/strip/recenable <em>ssid</em> <em>rec_st</em></kbd></dt>
359 <dd>where <em>rec_st</em> is a bool/int representing the desired rec state of the track</dd>
360 <dt><kbd class="osc">/strip/record_safe <em>ssid</em> <em>rec_st</em></kbd></dt>
361 <dd>where <em>rec_st</em> is a bool/int representing the desired record safe state of the track</dd>
362 <dt><kbd class="osc">/strip/polarity <em>ssid</em> <em>invert</em></kbd></dt>
363 <dd>where <em>invert</em> is a bool/int representing the desired polarity of the track</dd>
364 <dt><kbd class="osc">/strip/gain <em>ssid</em> <em>gain</em></kbd></dt>
365 <dd>where <em>gain</em> is a float ranging from -193 to 6 representing the desired gain of the track in dB.</dd>
366 <dt><kbd class="osc">/strip/fader <em>ssid</em> <em>position</em></kbd></dt>
367 <dd>where <em>position</em> is a float ranging from 0 to 1 representing the fader control position.</dd>
368 <dt><kbd class="osc">/strip/trimdB <em>ssid</em> <em>trim_db</em></kbd></dt>
369 <dd>where <em>trim_db</em> is a float ranging from -20 to 20 representing the desired trim of the track in dB.</dd>
370 <dt><kbd class="osc">/strip/pan_stereo_position <em>ssid</em> <em>position</em></kbd></dt>
371 <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired pan position of the track</dd>
372 <dt><kbd class="osc">/strip/pan_stereo_width <em>ssid</em> <em>width</em></kbd></dt>
373 <dd>where <em>width</em> is a float ranging from 0 to 1 representing the desired pan width of the track</dd>
374 <dt><kbd class="osc">/strip/send/gain <em>ssid</em> <em>sendid</em> <em>send_gain</em></kbd></dt>
375 <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
376 ranging from -193 to +6 representing the desired gain in dB for the send</dd>
377 <dt><kbd class="osc">/strip/send/fader <em>ssid</em> <em>sendid</em> <em>send_gain</em></kbd></dt>
378 <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
379 ranging from 0 to 1 representing the desired position for the send as a fader</dd>
380 <dt><kbd class="osc">/strip/send/enable <em>ssid</em> <em>sendid</em> <em>state</em></kbd></dt>
381 <dd>where <em>sendid</em> = nth_send, <em>state</em> is 1 for enabled and 0 for disabled</dd>
382 <dt><kbd class="osc">/strip/list </kbd></dt>
383 <dd>see: <a href="@@osc58-querying-ardour">
384 Querying Ardour with OSC.</a></dd>
385 <dt><kbd class="osc">/strip/sends <em>ssid</em></kbd></dt>
386 <dd>see: <a href="@@osc58-querying-ardour">
387 Querying Ardour with OSC.</a></dd>
388 <dt><kbd class="osc">/strip/receives <em>ssid</em></kbd></dt>
389 <dd>see: <a href="@@osc58-querying-ardour">
390 Querying Ardour with OSC.</a></dd>
391 <dt><kbd class="osc">/strip/plugin/list <em>ssid</em></kbd></dt>
392 <dd>see: <a href="@@osc58-querying-ardour">
393 Querying Ardour with OSC.</a></dd>
394 <dt><kbd class="osc">/strip/plugin/descriptor <em>ssid</em></kbd></dt>
395 <dd>see: <a href="@@osc58-querying-ardour">
396 Querying Ardour with OSC.</a></dd>
397 <dt><kbd class="osc">/strip/plugin/reset <em>ssid</em> <em>piid</em> </kbd></dt>
398 <dd>where <em>piid</em> = nth Plugin, will reset all values to the plugin's original values</dd>
399 <dt><kbd class="osc">/strip/plugin/activate <em>ssid</em> <em>piid</em> </kbd></dt>
400 <dd>where <em>piid</em> = nth Plugin, will set the plugin's state to active</dd>
401 <dt><kbd class="osc">/strip/plugin/deactivate <em>ssid</em> <em>piid</em> </kbd></dt>
402 <dd>where <em>piid</em> = nth Plugin, will set the plugin's state to inactive</dd>
403 <dt><kbd class="osc">/strip/plugin/parameter <em>ssid</em> <em>piid</em> <em>param</em> <em>value</em></kbd></dt>
404 <dd>where <em>piid</em> = nth Plugin, <em>param</em> = nth param, <em>value</em>
405 is a float ranging from 0 to 1 representing the desired parameter value</dd>
406 <dt><kbd class="osc">/strip/name <em>ssid</em> <em>name</em></kbd></dt>
407 <dd>where <em>name</em> is a string for the desired name of the track</dd>
409 <h3>Selected Strip Operations</h3>
411 New for Ardour 5, A whole set of operations that work on the selected
415 Selected strip operations are complex enough for their own page.
417 href="/using-control-surfaces/controlling-ardour-with-osc/selection-considerations-in-osc/">
418 Selection Considerations in OSC.</a> This is most important if more
419 than one OSC surface is being used with Ardour.
422 There are two kinds of selection in OSC. GUI selection and local
423 expansion. By default expansion follows selection.
426 GUI selection: Use <em>/strip/select</em> to set. Selecting
427 a strip in the GUI will set OSC surface select and the surface
428 will set GUI selection as well.
431 Local expansion: Use <em>/strip/expand</em> to expand a strip
432 without changing overall selection. When /strip/expand is set
433 to 0 or false, the select channel will go back to using the
434 strip selected by the GUI. While expand is turned on,
435 selecting a strip on the GUI does not
436 select the OSC strip. Sending a /strip/select message will
437 override the expand as if it had been set to false.
438 Good for more than one OSC controller at a time.
443 <dl class="bindings">
444 <dt><kbd class="osc">/strip/select <em>ssid</em> <em>y/n</em></kbd></dt>
445 <dd>Where <em>y/n</em> = 1 for select. Sets both GUI select and strip
446 to expanded mode. (0 is ignored)</dd>
447 <dt><kbd class="osc">/strip/expand <em>ssid</em> <em>y/n</em></kbd></dt>
448 <dd>Where <em>y/n</em> = 1 for expanded mode. Sets only local strip to
449 Expanded. Setting to 0 resets the expansion to follow selection.</dd>
450 <dt><kbd class="osc">/select/expand <em>y/n</em></kbd></dt>
451 <dd>Where <em>y/n</em> = 1 for expanded mode, 0 for Select mode.</dd>
452 <dt><kbd class="osc">/select/recenable <em>y/n</em></kbd></dt>
453 <dd>Where <em>y/n</em> is 1 for enabled and 0 for disabled</dd>
454 <dt><kbd class="osc">/select/record_safe <em>y/n</em></kbd></dt>
455 <dd>Where <em>y/n</em> is 1 for safe and 0 for unlocked</dd>
456 <dt><kbd class="osc">/select/mute <em>y/n</em></kbd></dt>
457 <dd>Where <em>y/n</em> is 1 for enabled and 0 for disabled</dd>
458 <dt><kbd class="osc">/select/solo <em>y/n</em></kbd></dt>
459 <dd>Where <em>y/n</em> is 1 for enabled and 0 for disabled</dd>
460 <dt><kbd class="osc">/select/solo_iso <em>state</em></kbd></dt>
461 <dd>where <em>state</em> is a bool/int representing the desired solo isolate state of the track</dd>
462 <dt><kbd class="osc">/select/solo_safe <em>state</em></kbd></dt>
463 <dd>where <em>state</em> is a bool/int representing the desired solo safe/lock state of the track</dd>
464 <dt><kbd class="osc">/select/monitor_input <em>y/n</em></kbd></dt>
465 <dd>Where <em>y/n</em> is 1 for monitor from input and 0 for auto</dd>
466 <dt><kbd class="osc">/select/monitor_disk <em>y/n</em></kbd></dt>
467 <dd>Where <em>y/n</em> is 1 for monitor from disk and 0 for auto</dd>
468 <dt><kbd class="osc">/select/polarity <em>invert</em></kbd></dt>
469 <dd>where <em>invert</em> is a bool/int representing the desired polarity of the track</dd>
470 <dt><kbd class="osc">/select/gain <em>gain</em></kbd></dt>
471 <dd>Where <em>gain</em> is a float ranging from -193 to 6 representing the desired gain of the track in dB.</dd>
472 <dt><kbd class="osc">/select/fader <em>position</em></kbd></dt>
473 <dd>Where <em>position</em> is an float ranging from 0 to 1 representing the fader control position.</dd>
474 <dt><kbd class="osc">/select/trimdB <em>trim_db</em></kbd></dt>
475 <dd>where <em>trim_db</em> is a float ranging from -20 to 20 representing the desired trim of the track in dB.</dd>
476 <dt><kbd class="osc">/select/pan_stereo_position <em>position</em></kbd></dt>
477 <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired pan position of the track</dd>
478 <dt><kbd class="osc">/select/pan_stereo_width <em>width</em></kbd></dt>
479 <dd>where <em>width</em> is a float ranging from 0 to 1 representing the desired pan width of the track</dd>
480 <dt><kbd class="osc">/select/pan_elevation_position <em>position</em></kbd></dt>
481 <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired pan elevation of the track</dd>
482 <dt><kbd class="osc">/select/pan_frontback_position <em>position</em></kbd></dt>
483 <dd>where <em>position</em> is a float ranging from 0 to 1 representing the desired front to back position of the track</dd>
484 <dt><kbd class="osc">/select/pan_lfe_control <em>value</em></kbd></dt>
485 <dd>where <em>value</em> is a float ranging from 0 to 1 representing the desired LFE control value for the track</dd>
486 <dt><kbd class="osc">/select/send_gain", <em>sendid</em> <em>send_gain</em></kbd></dt>
487 <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
488 ranging from -193 to +6 representing the desired gain in dB for the send</dd>
489 <dt><kbd class="osc">/select/send_fader", <em>sendid</em> <em>send_gain</em></kbd></dt>
490 <dd>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
491 ranging from 0 to 1 representing the desired position for the send as a fader</dd>
492 <dt><kbd class="osc">/select/send_enable", <em>sendid</em> <em>state</em></kbd></dt>
493 <dd>where <em>sendid</em> = nth_send, <em>state</em> is 1 for enabled and 0 for disabled</dd>
496 <h3>Menu actions</h3>
498 Every single menu item in Ardour's GUI is accessible via OSC. There is
499 a single common syntax to trigger the action as if it was selected
500 with the mouse (or keyboard):</p>
501 <kbd class="osc">/access_action <em>action_name</em></kbd>
504 href="/appendix/menu-actions-list/">
505 list of actions</a> shows all available values of <em>action-name</em> as of
506 June 2016 for Ardour 5.0.pre0.1. You can get the current list at any
507 time by running Ardour with the -b flag.