+<p>Open Sound Control (<abbr title="Open Sound Control">OSC</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 messages can be sent. This document describes the various categories of messages that Ardour understands. It is subject to change, particular 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>
+
+<h2>Connect to Ardour via OSC</h2>
<p>
-OSC support is not enabled by default, but can be turned on via <code>Edit > Preferences > User Interaction</code>. Once enabled, Ardour will listen on port 3819 by default. This port number can be changed by editing $ARDOUR_CONFIG and adding this line within the <Config> section:</p>
+OSC support is not enabled by default, but can be turned on via <code>Edit > Preferences > Control Surfaces</code>. Once enabled, Ardour will listen on port 3819 by default. This port number can be changed by editing $ARDOUR_CONFIG and adding this line within the <Config> section:</p>
<pre>
<Option name="osc-port" value="YourChoiceHere"/>
</pre>
+
<h2>Transport Control</h2>
<dl class="wide-table">
-<dt>/ardour/transport_stop
-<dt>/ardour/transport_play
-<dt>/ardour/set_transport_speed [transport_speed]
-</dt>
-</dt>
-</dt>
-<dd>where [transport_speed] is a float rangin from -8 to 8.
-</dd>
-<dt>/ardour/ffwd
-<dt>/ardour/rewind
-<dt>/ardour/goto_start
-<dt>/ardour/goto_end
-<dt>/ardour/add_marker
-</dt>
-</dt>
-</dt>
-</dt>
-</dt>
+<dt>/ardour/transport_stop</dt>
+<dt>/ardour/transport_play</dt>
+<dt>/ardour/set_transport_speed [transport_speed]</dt>
+<dd>where [transport_speed] is a float rangin from -8 to 8.</dd>
+<dt>/ardour/ffwd</dt>
+<dt>/ardour/rewind</dt>
+<dt>/ardour/goto_start</dt>
+<dt>/ardour/goto_end</dt>
+<dt>/ardour/add_marker</dt>
<dd>(adds marker to the current transport position)
</dd>
-<dt>/ardour/next_marker
-<dt>/ardour/prev_marker
-<dt>/ardour/locate [sample_pos] [with_roll]
-</dt>
-</dt>
-</dt>
+<dt>/ardour/next_marker</dt>
+<dt>/ardour/prev_marker</dt>
+<dt>/ardour/locate [sample_pos] [with_roll]</dt>
<dd>where [sample_pos] is the target position and [with_roll] is a bool/integer (whether you want transport to be kept rolling or not).
</dd>
-<dt>/ardour/loop_toggle<br>
-</dt>
+<dt>/ardour/loop_toggle</dt>
</dl>
+
<h2>Editing-related</h2>
<dl class="wide-table">
-<dt> /ardour/undo
-<dt> /ardour/redo
-<dt> /ardour/save_state
-</dt>
-</dt>
-</dt>
-<dd>(this is regular Session _> Save operatio)<br>
-</dd>
+<dt> /ardour/undo</dt>
+<dt> /ardour/redo</dt>
+<dt> /ardour/save_state</dt>
+<dd>(this is regular Session _> Save operatio)</dd>
</dl>
+
<h2>Recording control</h2>
<dl class="wide-table">
-<dt> /ardour/toggle_punch_in
-<dt> /ardour/toggle_punch_out
-<dt> /ardour/rec_enable_toggle
-<dt> /ardour/toggle_all_rec_enables
-</dt>
-</dt>
-</dt>
-</dt>
-<dd>(toggles all tracks recording state). !currently toggles on but not off for 2.0 branch.<br>
-</dd>
+<dt> /ardour/toggle_punch_in</dt>
+<dt> /ardour/toggle_punch_out</dt>
+<dt> /ardour/rec_enable_toggle</dt>
+<dt> /ardour/toggle_all_rec_enables</dt>
+<dd>(toggles all tracks recording state). !currently toggles on but not off for 2.0 branch.</dd>
</dl>
+
<h2>Track specific operations</h2>
<p>
For each of the following, [remote_id] is the remote_id or the track
</dd>
<dt> /ardour/routes/gaindB [remote_id] [gain_db]
</dt>
-<dd>where [gain_db] is a float ranging from -400 to 6 representing the desired gain of the track in dB.<br>
+<dd>where [gain_db] is a float ranging from -400 to 6 representing the desired gain of the track in dB.
</dd>
</dl>
+
<h2>Menu actions</h2>
<p>
-Every single menu item in Ardour's GUI is accessible via OSC. There is<br>
-a single common syntax to trigger the action as if it was selected<br>
+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>
<pre>
/ardour/access_action [action_name]
</pre>
-<p>The list below shows all available values of [action-name] as of<br>
-mid-March 2010 for Ardour 2.X. You can get the current list at any<br>
+<p>The list below shows all available values of [action-name] as of
+mid-March 2010 for Ardour 2.X. You can get the current list at any
time by running Ardour with the -b flag.</p>
<ul>
<li> Common/About
projects / ardour-manual / blobdiff