From: Len Ovens
Date: Sat, 14 Jan 2017 16:43:09 +0000 (-0800)
Subject: OSC: Reorder chapter to make sense.
X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=eab856b887efcfb08fde39896840f5ae9981187d;p=ardour-manual-diverged
OSC: Reorder chapter to make sense.
---
diff --git a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc.html b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc.html
index f79afa2..230b56e 100644
--- a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc.html
+++ b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc.html
@@ -1,1236 +1,13 @@
---
layout: default
title: Controlling Ardour with OSC
----
+---
- OSC 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,
+ OSC 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).
-
- Note: 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
- Osc control in ardour 4.7 and prior.
-
-
-
- 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, particularly the "Actions" part below, since this relates to the
- GTK GUI for Ardour rather than the backend.
-
-
-Connecting to Ardour via OSC
-
- OSC support is not enabled by default, but can be turned on via
- .
- 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:
-
-<Option name="osc-port" value="Your choice
-here"/>
-
-
- 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
- OSC feedback In Ardour.
-
-
-Control Surface Set Up
-
-
- 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.
-
-
- Any time the /set_surface 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.
-
-
- Surface Port Setting is available in the OSC GUI.
-
-
- 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
- Ardour's Setup Dialog.
-
-If /set_surface is not sent, the default values are used:
-
- - Bank Size: 0 - No banking (or infinite bank size).
- - Strip Types: All strip types except hidden and special.
- - Feedback: 0 - All off.
- - Fader Mode: 0 - gain in dB (not relevant with feedback off)
-
-
-
- These values give the same behaviour as prior versions of Ardour. (or the closest possible)
-
-
- - /set_surface bank_size strip_types
- feedback fadermode
- -
- See below for an explanation of each parameter.
-
-
-bank_size
-
- 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.
-
-
- Bank size can also be set with /set_surface/bank_size size.
-
-strip_types
-
- 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.
-
-
- 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.
-
-
- 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.
-
-Please see:
- Calculating Feedback and Strip-types Values.
-
-
- Strip types can also be set with /set_surface/strip_types types.
-
-feedback
-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.
-
-Please see:
- Calculating Feedback and Strip-types Values.
-
- Feedback can also be set with /set_surface/feedback feedback.
-
-
-gainmode
-
- Gainmode is a an int that acts as a bool:
-
- - 0 (or false) dB value as a float from -193 to +6. Sent as
- /strip/gain SSID value. (-193 or below are the same as -inf)
- - 1 (or true) A positional fader based on the same math
- as Ardour's GUI. An Float from 0 to 1. Sent as
- /strip/fader SSID value
-
-
-
- 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.
-
-
- Gain mode can also be set with /set_surface/gainmode gainmode.
-
-
-Querying Ardour for information
-
- The control Surface may wish to control the type a frequency of
- updates it receives. It can do this with querying commands. See:
- Querying Ardour with OSC.
-
-
-List of OSC messages
-
- Parameter types show how the value will be used. However, they may
- be sent as a different type if needed, see:
- Parameter Types in OSC.
-
-Master or Global messages
-
-Transport Control
-
- - /transport_stop
-
- - /transport_play
-
- - /toggle_roll
- - Toggles between play and stop
- - /set_transport_speed s
- - where s is a float ranging from -8.0f to 8.0f
- - /ffwd
-
- - /rewind
-
- - /goto_start
-
- - /goto_end
-
- - /jump_bars bars
- - Where bars is a float (+/-) of the number of bars to jump
- - /jump_seconds seconds
- - Where seconds is a float (+/-) of the number of seconds to jump
- - /add_marker
- - (adds marker to the current transport position)
- - /remove_marker
- - Removes marker at the current transport position (if there is one)
- - /mark_in
- - Marks the begining of a range at the current transport position
- - /mark_out
- - Marks the end of a range at the current transport position
- - /next_marker
-
- - /prev_marker
-
- - /locate spos roll
- - where spos is the target position in samples and
- roll is a bool/integer defining whether you want transport
- to be kept rolling or not
- - /loop_toggle
-
- - /loop_location start end
- - start is the beginning of a loop and end is the
- end of a loop both are integer frame positions.
- - /set_loop_range
- - Uses edit range as loop range
- - /set_session_range
- - Uses edit range as session range
- - /toggle_click
-
- - /midi_panic
- - Ardour will send an all notes off to all midi tracks
- - /cancel_all_solos
- - Cancel All Solos/PFLs/AFLs
-
-
-Transport Information
-
- - /transport_frame
- - Ardour sends /transport_frame current_frame
- - /transport_speed
- - Ardour sends /transport_speed speed
- - /record_enabled
- - Ardour sends /record_enabled recordenable_status
-
-
-Editing-related
-
- - /undo
-
- - /redo
-
- - /save_state
- - (this is the regular
- operation)
- - /quick_snapshot_switch
- - Take a snapshot and switch to new version
- - /quick_snapshot_stay
- - Take a snapshot and keep working on this version
- - /fit_*_track(s)
- - Were * is one of 1, 2, 4, 8, 16, 32 or all. Fits this
- many tracks in editor window. (add s for more than 1)
- - /zoom_*
- - Zoom editor to include * where * is 100_ms, 1_sec,
- 10_sec, 1_min, 5_min, 10_min or to_session
- - /temporal_zoom_in
- - Zoom editor in to show less time
- - /temporal_zoom_out
- - Zoom editor out to show more time
- - /scroll_up_1_track
- - Scroll the editor pane up 1 track
- - /scroll_up_1_page
- - Scroll the editor pane up 1 page
- - /scroll_dn_1_track
- - Scroll the editor pane down 1 track
- - /scroll_dn_1_page
- - Scroll the editor pane down 1 page
-
-
-Recording control
-
- - /toggle_punch_in
-
- - /toggle_punch_out
-
- - /set_punch_range
- - Uses edit range as punch range
- - /rec_enable_toggle
-
-
- - /stop_forget
- - Stop transport and delete/forget last take
-
-
-Master and Monitor strip control
-
- - /master/gain dB
- - See gain in strips
- - /master/fader position
- - See fader in strips
- - /master/trimdB dB
- - see trimdb in strips
- - /master/pan_stereo_position position
- - See pan_stereo_position in strips
- - /master/mute yn
- - See mute in strips
- - /monitor/gain dB
- - See gain in strips
- - /monitor/fader position
- - See fader in strips
-
-
-Track specific operations
-
- For each of the following, ssid is the Surface Strip ID for the track
-
-
- 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
- /set_surface.
-
-
- 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.
-
-
- - /bank_up
- - Change bank to the next higher bank.
- - /bank_down
- - Change bank to the next lower bank.
- - /strip/mute ssid mute_st
- - where mute_st is a bool/int representing the desired mute state of the track
- - /strip/solo ssid solo_st
- - where solo_st is a bool/int representing the desired solo state of the track
- - /strip/solo_iso ssid state
- - where state is a bool/int representing the desired solo isolate state of the track
- - /strip/solo_safe ssid state
- - where state is a bool/int representing the desired solo safe/lock state of the track
- - /strip/monitor_input ssid monitor_st
- - where monitor_st is a bool/int where 1 is forced input monitoring.
- - /strip/monitor_disk ssid monitor_st
- - where monitor_st is a bool/int where 1 is forced disk monitoring. When input and disk are both off,
- Auto monitoring is enabled.
- - /strip/recenable ssid rec_st
- - where rec_st is a bool/int representing the desired rec state of the track
- - /strip/record_safe ssid rec_st
- - where rec_st is a bool/int representing the desired record safe state of the track
- - /strip/polarity ssid invert
- - where invert is a bool/int representing the desired polarity of the track
- - /strip/gain ssid gain
- - where gain is a float ranging from -193 to 6 representing the desired gain of the track in dB.
- - /strip/fader ssid position
- - where position is a float ranging from 0 to 1 representing the fader control position.
- - /strip/trimdB ssid trim_db
- - where trim_db is a float ranging from -20 to 20 representing the desired trim of the track in dB.
- - /strip/pan_stereo_position ssid position
- - where position is a float ranging from 0 to 1 representing the desired pan position of the track
- - /strip/pan_stereo_width ssid width
- - where width is a float ranging from 0 to 1 representing the desired pan width of the track
- - /strip/send/gain ssid sendid send_gain
- - where sendid = nth_send, send_gain is a float
- ranging from -193 to +6 representing the desired gain in dB for the send
- - /strip/send/fader ssid sendid send_gain
- - where sendid = nth_send, send_gain is a float
- ranging from 0 to 1 representing the desired position for the send as a fader
- - /strip/send/enable ssid sendid state
- - where sendid = nth_send, state is 1 for enabled and 0 for disabled
- - /strip/list
- - see:
- Querying Ardour with OSC.
- - /strip/sends ssid
- - see:
- Querying Ardour with OSC.
- - /strip/receives ssid
- - see:
- Querying Ardour with OSC.
- - /strip/plugin/list ssid
- - see:
- Querying Ardour with OSC.
- - /strip/plugin/descriptor ssid
- - see:
- Querying Ardour with OSC.
- - /strip/plugin/reset ssid piid
- - where piid = nth Plugin, will reset all values to the plugin's original values
- - /strip/plugin/activate ssid piid
- - where piid = nth Plugin, will set the plugin's state to active
- - /strip/plugin/deactivate ssid piid
- - where piid = nth Plugin, will set the plugin's state to inactive
- - /strip/plugin/parameter ssid piid param value
- - where piid = nth Plugin, param = nth param, value
- is a float ranging from 0 to 1 representing the desired parameter value
- - /strip/name ssid name
- - where name is a string for the desired name of the track
-
-Selected Strip Operations
-
- New for Ardour 5, A whole set of operations that work on the selected
- or expanded strip.
-
-
- Selected strip operations are complex enough for their own page.
- Please read:
- Selection Considerations in OSC. This is most important if more
- than one OSC surface is being used with Ardour.
-
-
- There are two kinds of selection in OSC. GUI selection and local
- expansion. By default expansion follows selection.
-
- -
- GUI selection: Use /strip/select to set. Selecting
- a strip in the GUI will set OSC surface select and the surface
- will set GUI selection as well.
-
- -
- Local expansion: Use /strip/expand 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.
-
-
-
-
-
- - /strip/select ssid y/n
- - Where y/n = 1 for select. Sets both GUI select and strip
- to expanded mode. (0 is ignored)
- - /strip/expand ssid y/n
- - Where y/n = 1 for expanded mode. Sets only local strip to
- Expanded. Setting to 0 resets the expansion to follow selection.
- - /select/expand y/n
- - Where y/n = 1 for expanded mode, 0 for Select mode.
- - /select/recenable y/n
- - Where y/n is 1 for enabled and 0 for disabled
- - /select/record_safe y/n
- - Where y/n is 1 for safe and 0 for unlocked
- - /select/mute y/n
- - Where y/n is 1 for enabled and 0 for disabled
- - /select/solo y/n
- - Where y/n is 1 for enabled and 0 for disabled
- - /select/solo_iso state
- - where state is a bool/int representing the desired solo isolate state of the track
- - /select/solo_safe state
- - where state is a bool/int representing the desired solo safe/lock state of the track
- - /select/monitor_input y/n
- - Where y/n is 1 for monitor from input and 0 for auto
- - /select/monitor_disk y/n
- - Where y/n is 1 for monitor from disk and 0 for auto
- - /select/polarity invert
- - where invert is a bool/int representing the desired polarity of the track
- - /select/gain gain
- - Where gain is a float ranging from -193 to 6 representing the desired gain of the track in dB.
- - /select/fader position
- - Where position is an float ranging from 0 to 1 representing the fader control position.
- - /select/trimdB trim_db
- - where trim_db is a float ranging from -20 to 20 representing the desired trim of the track in dB.
- - /select/pan_stereo_position position
- - where position is a float ranging from 0 to 1 representing the desired pan position of the track
- - /select/pan_stereo_width width
- - where width is a float ranging from 0 to 1 representing the desired pan width of the track
- - /select/pan_elevation_position position
- - where position is a float ranging from 0 to 1 representing the desired pan elevation of the track
- - /select/pan_frontback_position position
- - where position is a float ranging from 0 to 1 representing the desired front to back position of the track
- - /select/pan_lfe_control value
- - where value is a float ranging from 0 to 1 representing the desired LFE control value for the track
- - /select/send_gain", sendid send_gain
- - where sendid = nth_send, send_gain is a float
- ranging from -193 to +6 representing the desired gain in dB for the send
- - /select/send_fader", sendid send_gain
- - where sendid = nth_send, send_gain is a float
- ranging from 0 to 1 representing the desired position for the send as a fader
- - /select/send_enable", sendid state
- - where sendid = nth_send, state is 1 for enabled and 0 for disabled
-
-
-Menu actions
-
- 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):
-/access_action action_name
-
- The list below shows all available values of action-name 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.
-
-
- - Action Name
- Menu Name
-
- - ProcessorMenu/ab_plugins
- A/B Plugins
- - ProcessorMenu/activate_all
- Activate All
- - ProcessorMenu/clear
- Clear (all)
- - ProcessorMenu/clear_post
- Clear (post-fader)
- - ProcessorMenu/clear_pre
- Clear (pre-fader)
- - ProcessorMenu/controls
- Controls
- - ProcessorMenu/copy
- Copy
- - ProcessorMenu/cut
- Cut
- - ProcessorMenu/deactivate_all
- Deactivate All
- - ProcessorMenu/delete
- Delete
- - ProcessorMenu/deselectall
- Deselect All
- - ProcessorMenu/edit-generic
- Edit with generic controls...
- - ProcessorMenu/edit
- Edit...
- - ProcessorMenu/newaux
- New Aux Send ...
- - ProcessorMenu/newinsert
- New Insert
- - ProcessorMenu/newplugin
- New Plugin
- - ProcessorMenu/newsend
- New External Send ...
- - ProcessorMenu/paste
- Paste
- - ProcessorMenu/rename
- Rename
- - ProcessorMenu/selectall
- Select All
- - ProcessorMenu/send_options
- Send Options
-
- - Common/Hide
- - Common/NewMIDITracer
- MIDI Tracer
- - Common/Quit
- Quit
- - Common/Save
- Save
- - Common/ToggleMaximalEditor
- Maximize Editor Space
- - Common/ToggleMaximalMixer
- - Common/ToggleMixerList
- - Common/ToggleMonitorSection
- - Common/ToggleRecordEnableTrack10
- Toggle Record Enable Track 10
- - Common/ToggleRecordEnableTrack11
- Toggle Record Enable Track 11
- - Common/ToggleRecordEnableTrack12
- Toggle Record Enable Track 12
- - Common/ToggleRecordEnableTrack13
- Toggle Record Enable Track 13
- - Common/ToggleRecordEnableTrack14
- Toggle Record Enable Track 14
- - Common/ToggleRecordEnableTrack15
- Toggle Record Enable Track 15
- - Common/ToggleRecordEnableTrack16
- Toggle Record Enable Track 16
- - Common/ToggleRecordEnableTrack17
- Toggle Record Enable Track 17
- - Common/ToggleRecordEnableTrack18
- Toggle Record Enable Track 18
- - Common/ToggleRecordEnableTrack19
- Toggle Record Enable Track 19
- - Common/ToggleRecordEnableTrack1
- Toggle Record Enable Track 1
- - Common/ToggleRecordEnableTrack20
- Toggle Record Enable Track 20
- - Common/ToggleRecordEnableTrack21
- Toggle Record Enable Track 21
- - Common/ToggleRecordEnableTrack22
- Toggle Record Enable Track 22
- - Common/ToggleRecordEnableTrack23
- Toggle Record Enable Track 23
- - Common/ToggleRecordEnableTrack24
- Toggle Record Enable Track 24
- - Common/ToggleRecordEnableTrack25
- Toggle Record Enable Track 25
- - Common/ToggleRecordEnableTrack26
- Toggle Record Enable Track 26
- - Common/ToggleRecordEnableTrack27
- Toggle Record Enable Track 27
- - Common/ToggleRecordEnableTrack28
- Toggle Record Enable Track 28
- - Common/ToggleRecordEnableTrack29
- Toggle Record Enable Track 29
- - Common/ToggleRecordEnableTrack2
- Toggle Record Enable Track 2
- - Common/ToggleRecordEnableTrack30
- Toggle Record Enable Track 30
- - Common/ToggleRecordEnableTrack31
- Toggle Record Enable Track 31
- - Common/ToggleRecordEnableTrack32
- Toggle Record Enable Track 32
- - Common/ToggleRecordEnableTrack3
- Toggle Record Enable Track 3
- - Common/ToggleRecordEnableTrack4
- Toggle Record Enable Track 4
- - Common/ToggleRecordEnableTrack5
- Toggle Record Enable Track 5
- - Common/ToggleRecordEnableTrack6
- Toggle Record Enable Track 6
- - Common/ToggleRecordEnableTrack7
- Toggle Record Enable Track 7
- - Common/ToggleRecordEnableTrack8
- Toggle Record Enable Track 8
- - Common/ToggleRecordEnableTrack9
- Toggle Record Enable Track 9
- - Common/attach-editor
- - Common/attach-mixer
- - Common/attach-preferences
- - Common/change-editor-visibility
- - Common/change-mixer-visibility
- - Common/change-preferences-visibility
- - Common/Chat
- Chat
- - Common/cheat-sheet
- - Common/detach-editor
- - Common/detach-mixer
- - Common/detach-preferences
- - Common/forums
- - Common/hide-editor
- - Common/hide-mixer
- - Common/hide-preferences
- - Common/howto-report
- - Common/key-change-editor-visibility
- - Common/key-change-mixer-visibility
- - Common/key-change-preferences-visibility
- - Common/Manual
- Manual
- - Common/menu-show-preferences
- - Common/next-tab
- - Common/previous-tab
- - Common/Reference
- Reference
- - Common/show-editor
- - Common/show-mixer
- - Common/show-preferences
- - Common/toggle-editor-mixer
- Toggle Editor+Mixer
- - Common/toggle-luawindow
- - Common/toggle-meterbridge
- Meterbridge
- - Common/tracker
- - Common/website
- - Common/website-dev
-
- - MIDI/panic
- Panic
-
- - Main/AddLuaScript
- - Main/AddTrackBus
- Add Track or Bus...
- - Main/CleanupPeakFiles
- - Main/CleanupUnused
- Clean-up Unused Sources...
- - Main/Close
- Close
- - Main/CloseVideo
- Remove Video
- - Main/EditMetadata
- Edit Metadata...
- - Main/Escape
- - Main/ExportAudio
- Export To Audio File(s)...
- - Main/Export
- Export
- - Main/ExportVideo
- Export To Video File
- - Main/FlushWastebasket
- Flush Wastebasket
- - Main/ImportMetadata
- Import Metadata...
- - Main/Metadata
- Metadata
- - Main/New
- New...
- - Main/Open
- Open...
- - Main/OpenVideo
- Open Video
- - Main/QuickSnapshotStay
- - Main/QuickSnapshotSwitch
- - Main/Recent
- Recent...
- - Main/RemoveLuaScript
- - Main/Rename
- Rename...
- - Main/SaveAs
- Save As...
- - Main/SaveTemplate
- Save Template...
- - Main/Scripting
- - Main/SnapshotStay
- - Main/SnapshotSwitch
- - Main/StemExport
- Stem export...
- - Main/cancel-solo
- - Main/duplicate-routes
-
- - Main_menu/AudioFileFormatData
- Sample Format
- - Main_menu/AudioFileFormatHeader
- File Type
- - Main_menu/AudioFileFormat
- Audio File Format
- - Main_menu/Cleanup
- Clean-up
- - Main_menu/ControlSurfaces
- Control Surfaces
- - Main_menu/Denormals
- Denormal Handling
- - Main_menu/Help
- Help
- - Main_menu/KeyMouseActions
- Misc. Shortcuts
- - Main_menu/MeteringFallOffRate
- Fall Off Rate
- - Main_menu/MeteringHoldTime
- Hold Time
- - Main_menu/Metering
- Metering
- - Main_menu/MixerMenu
- - Main_menu/Plugins
- Plugins
- - Main_menu/PrefsMenu
- - Main_menu/Session
- Session
- - Main_menu/Sync
- Sync
- - Main_menu/TransportOptions
- Options
- - Main_menu/WindowMenu
- Window
-
- - options/SendMidiClock
- Send MIDI Clock
- - options/SendMIDIfeedback
- Send MIDI Feedback
- - options/SendMMC
- Send MMC
- - options/SendMTC
- Send MTC
- - options/UseMMC
- Use MMC
-
- - Transport/ForwardFast
- Forward (Fast)
- - Transport/Forward
- Forward
- - Transport/ForwardSlow
- Forward (Slow)
- - Transport/GotoEnd
- Goto End
- - Transport/GotoStart
- Goto Start
- - Transport/GotoWallClock
- Goto Wall Clock
- - Transport/GotoZero
- Goto Zero
- - Transport/Loop
- Play Loop Range
- - Transport/PlayPreroll
- Play Selection w/Preroll
- - Transport/PlaySelection
- Play Selected Range
- - Transport/Record
- Enable Record
- - Transport/RewindFast
- Rewind (Fast)
- - Transport/Rewind
- Rewind
- - Transport/RewindSlow
- Rewind (Slow)
- - Transport/Roll
- Roll
- - Transport/Stop
- Stop
- - Transport/ToggleAutoInput
- Auto Input
- - Transport/ToggleAutoPlay
- Auto Play
- - Transport/ToggleAutoReturn
- Auto Return
- - Transport/ToggleClick
- Click
- - Transport/ToggleExternalSync
- - Transport/ToggleFollowEdits
- Follow Edits
- - Transport/TogglePunchIn
- Punch In
- - Transport/TogglePunch
- Punch In/Out
- - Transport/TogglePunchOut
- Punch Out
- - Transport/ToggleRollForgetCapture
- Stop and Forget Capture
- - Transport/ToggleRoll
- Start/Stop
- - Transport/ToggleRollMaybe
- Start/Continue/Stop
- - Transport/ToggleTimeMaster
- Time Master
- - Transport/ToggleVideoSync
- Sync Startup to Video
- - Transport/TransitionToReverse
- Transition To Reverse
- - Transport/TransitionToRoll
- Transition To Roll
- - Transport/Transport
- Transport
- - Transport/alternate-GotoStart
- - Transport/alternate-ToggleRoll
- - Transport/alternate-numpad-decimal
- - Transport/alternate-record-roll
- - Transport/focus-on-clock
- Focus On Clock
- - Transport/numpad-0
- - Transport/numpad-1
- - Transport/numpad-2
- - Transport/numpad-3
- - Transport/numpad-4
- - Transport/numpad-5
- - Transport/numpad-6
- - Transport/numpad-7
- - Transport/numpad-8
- - Transport/numpad-9
- - Transport/numpad-decimal
- - Transport/primary-clock-bbt
- Bars & Beats
- - Transport/primary-clock-minsec
- Minutes & Seconds
- - Transport/primary-clock-samples
- Samples
- - Transport/primary-clock-timecode
- Timecode
- - Transport/record-roll
- Start Recording
- - Transport/secondary-clock-bbt
- Bars & Beats
- - Transport/secondary-clock-minsec
- Minutes & Seconds
- - Transport/secondary-clock-samples
- Samples
- - Transport/secondary-clock-timecode
- Timecode
-
- - Window/toggle-about
- About
- - Window/toggle-add-routes
- Add Tracks/Busses
- - Window/toggle-add-video
- Add Tracks/Busses
- - Window/toggle-audio-connection-manager
- Audio Connections
- - Window/toggle-audio-midi-setup
- Audio/MIDI Setup
- - Window/toggle-big-clock
- Big Clock
- - Window/toggle-bundle-manager
- Bundle Manager
- - Window/toggle-inspector
- Tracks and Busses
- - Window/toggle-key-editor
- Key Bindings
- - Window/toggle-locations
- Locations
- - Window/toggle-midi-connection-manager
- MIDI Connections
- - Window/toggle-script-manager
- - Window/toggle-session-options-editor
- Properties
- - Window/toggle-speaker-config
- Speaker Configuration
- - Window/toggle-video-export
-
- - Editor/SnapMode
- Snap Mode
- - Editor/SnapTo
- Snap to
- - Editor/ToggleGroupTabs
- Show Group Tabs
- - Editor/ToggleJadeo
- Video Monitor
- - Editor/ToggleMeasureVisibility
- Show Measures
- - Editor/ToggleSummary
- Show Summary
- - Editor/add-location-from-playhead
- Add Mark from Playhead
- - Editor/addExistingAudioFiles
- Import
- - Editor/addExistingPTFiles
- - Editor/addExternalAudioToRegionList
- Import to Region List...
- - Editor/alt-finish-range
- - Editor/alt-start-range
- - Editor/alternate-add-location-from-playhead
- - Editor/alternate-alternate-redo
- - Editor/alternate-editor-delete
- - Editor/alternate-jump-backward-to-mark
- - Editor/alternate-jump-forward-to-mark
- - Editor/alternate-redo
- - Editor/alternate-remove-location-from-playhead
- - Editor/alternate-select-all-after-edit-cursor
- - Editor/alternate-select-all-before-edit-cursor
- - Editor/alternate-tab-to-transient-backwards
- - Editor/alternate-tab-to-transient-forwards
- - Editor/bring-into-session
- - Editor/center-edit-cursor
- Center Edit Point
- - Editor/center-playhead
- Center Playhead
- - Editor/crop
- Crop
- - Editor/cycle-edit-point
- Change Edit Point
- - Editor/cycle-edit-point-with-marker
- Change Edit Point Including Marker
- - Editor/cycle-snap-mode
- Next Snap Mode
- - Editor/cycle-zoom-focus
- Next Zoom Focus
- - Editor/deselect-all
- Deselect All
- - Editor/duplicate-range
- Duplicate Range
- - Editor/edit-at-mouse
- Mouse
- - Editor/edit-at-playhead
- Playhead
- - Editor/edit-at-selected-marker
- Marker
- - Editor/edit-cursor-to-next-region-end
- To Next Region End
- - Editor/edit-cursor-to-next-region-start
- To Next Region Start
- - Editor/edit-cursor-to-next-region-sync
- To Next Region Sync
- - Editor/edit-cursor-to-previous-region-end
- To Previous Region End
- - Editor/edit-cursor-to-previous-region-start
- To Previous Region Start
- - Editor/edit-cursor-to-previous-region-sync
- To Previous Region Sync
- - Editor/edit-cursor-to-range-end
- To Range End
- - Editor/edit-cursor-to-range-start
- To Range Start
- - Editor/edit-to-playhead
- Active Mark to Playhead
- - Editor/editor-copy
- Copy
- - Editor/editor-crop
- Crop
- - Editor/editor-cut
- Cut
- - Editor/editor-delete
- Delete
- - Editor/editor-fade-range
- - Editor/editor-paste
- Paste
- - Editor/editor-separate
- Separate
- - Editor/expand-tracks
- Expand Track Height
- - Editor/export-audio
- Export Audio
- - Editor/export-range
- Export Range
- - Editor/finish-loop-range
- - Editor/finish-punch-range
- - Editor/finish-range
- Finish Range
- - Editor/fit-selection
- Fit Selected Tracks
- - Editor/fit_16_tracks
- - Editor/fit_1_track
- - Editor/fit_2_tracks
- - Editor/fit_32_tracks
- - Editor/fit_4_tracks
- - Editor/fit_8_tracks
- - Editor/fit_all_tracks
- - Editor/goto-mark-1
- Locate to Mark 1
- - Editor/goto-mark-2
- Locate to Mark 2
- - Editor/goto-mark-3
- Locate to Mark 3
- - Editor/goto-mark-4
- Locate to Mark 4
- - Editor/goto-mark-5
- Locate to Mark 5
- - Editor/goto-mark-6
- Locate to Mark 6
- - Editor/goto-mark-7
- Locate to Mark 7
- - Editor/goto-mark-8
- Locate to Mark 8
- - Editor/goto-mark-9
- Locate to Mark 9
- - Editor/goto-visual-state-10
- Goto View 10
- - Editor/goto-visual-state-11
- Goto View 11
- - Editor/goto-visual-state-12
- Goto View 12
- - Editor/goto-visual-state-1
- Goto View 1
- - Editor/goto-visual-state-2
- Goto View 2
- - Editor/goto-visual-state-3
- Goto View 3
- - Editor/goto-visual-state-4
- Goto View 4
- - Editor/goto-visual-state-5
- Goto View 5
- - Editor/goto-visual-state-6
- Goto View 6
- - Editor/goto-visual-state-7
- Goto View 7
- - Editor/goto-visual-state-8
- Goto View 8
- - Editor/goto-visual-state-9
- Goto View 9
- - Editor/importFromSession
- Import From Session
- - Editor/insert-time
- Insert Time
- - Editor/invert-selection
- Invert Selection
- - Editor/jump-backward-to-mark
- Jump to Previous Mark
- - Editor/jump-forward-to-mark
- Jump to Next Mark
- - Editor/lock
- - Editor/main-menu-play-selected-regions
- Play Selected Regions
- - Editor/move-range-end-to-next-region-boundary
- Move Range End to Next Region Boundary
- - Editor/move-range-end-to-previous-region-boundary
- Move Range End to Previous Region Boundary
- - Editor/move-range-start-to-next-region-boundary
- Move Range Start to Next Region Boundary
- - Editor/move-range-start-to-previous-region-boundary
- Move Range Start to Previous Region Boundary
- - Editor/move-selected-tracks-down
- Move Selected Tracks Down
- - Editor/move-selected-tracks-up
- Move Selected Tracks Up
- - Editor/next-snap-choice
- Next Snap Choice
- - Editor/next-snap-choice-music-only
- Next Musical Snap Choice
- - Editor/nudge-next-backward
- Nudge Next Earlier
- - Editor/nudge-next-forward
- Nudge Next Later
- - Editor/nudge-playhead-backward
- Nudge Playhead Backward
- - Editor/nudge-playhead-forward
- Nudge Playhead Forward
- - Editor/play-edit-range
- Play Edit Range
- - Editor/play-from-edit-point-and-return
- Play from Edit Point and Return
- - Editor/play-from-edit-point
- Play From Edit Point
- - Editor/playhead-backward-to-grid
- Playhead To Previous Grid
- - Editor/playhead-forward-to-grid
- Playhead To Next Grid
- - Editor/playhead-to-edit
- Playhead to Active Mark
- - Editor/playhead-to-next-region-boundary
- Playhead to Next Region Boundary
- - Editor/playhead-to-next-region-boundary-noselection
- Playhead to Next Region Boundary (No Track Selection)
- - Editor/playhead-to-next-region-end
- Playhead to Next Region End
- - Editor/playhead-to-next-region-start
- Playhead to Next Region Start
- - Editor/playhead-to-next-region-sync
- Playhead to Next Region Sync
- - Editor/playhead-to-previous-region-boundary
- Playhead to Previous Region Boundary
- - Editor/playhead-to-previous-region-boundary-noselection
- Playhead to Previous Region Boundary (No Track Selection)
- - Editor/playhead-to-previous-region-end
- Playhead to Previous Region End
- - Editor/playhead-to-previous-region-start
- Playhead to Previous Region Start
- - Editor/playhead-to-previous-region-sync
- Playhead to Previous Region Sync
- - Editor/playhead-to-range-end
- Playhead to Range End
- - Editor/playhead-to-range-start
- Playhead to Range Start
- - Editor/prev-snap-choice
- Previous Snap Choice
- - Editor/prev-snap-choice-music-only
- Previous Musical Snap Choice
- - Editor/redo
- Redo
- - Editor/redo-last-selection-op
- - Editor/remove-last-capture
- Remove Last Capture
- - Editor/remove-location-from-playhead
- - Editor/remove-time
- - Editor/remove-track
- Remove
- - Editor/save-visual-state-10
- Save View 10
- - Editor/save-visual-state-11
- Save View 11
- - Editor/save-visual-state-12
- Save View 12
- - Editor/save-visual-state-1
- Save View 1
- - Editor/save-visual-state-2
- Save View 2
- - Editor/save-visual-state-3
- Save View 3
- - Editor/save-visual-state-4
- Save View 4
- - Editor/save-visual-state-5
- Save View 5
- - Editor/save-visual-state-6
- Save View 6
- - Editor/save-visual-state-7
- Save View 7
- - Editor/save-visual-state-8
- Save View 8
- - Editor/save-visual-state-9
- Save View 9
- - Editor/script-action-1
- - Editor/script-action-2
- - Editor/script-action-3
- - Editor/script-action-4
- - Editor/script-action-5
- - Editor/script-action-6
- - Editor/script-action-7
- - Editor/script-action-8
- - Editor/script-action-9
- - Editor/scroll-backward
- Scroll Backward
- - Editor/scroll-forward
- Scroll Forward
- - Editor/scroll-playhead-backward
- Playhead Backward
- - Editor/scroll-playhead-forward
- Playhead Forward
- - Editor/scroll-tracks-down
- Scroll Tracks Down
- - Editor/scroll-tracks-up
- Scroll Tracks Up
- - Editor/select-all-after-edit-cursor
- Select All After Edit Point
- - Editor/select-all-before-edit-cursor
- Select All Before Edit Point
- - Editor/select-all-between-cursors
- Select All Overlapping Edit Range
- - Editor/select-all-in-loop-range
- Select All in Loop Range
- - Editor/select-all-in-punch-range
- Select All in Punch Range
- - Editor/select-all-objects => Ctrl+A
- - Editor/select-all-tracks => Ctrl+T
- - Editor/select-all-within-cursors
- Select All Inside Edit Range
- - Editor/select-from-regions
- - Editor/select-loop-range
- - Editor/select-next-route
- Select Next Track or Bus
- - Editor/select-prev-route
- Select Previous Track or Bus
- - Editor/select-punch-range
- - Editor/select-range-between-cursors
- - Editor/selected-marker-to-next-region-boundary
- To Next Region Boundary
- - Editor/selected-marker-to-next-region-boundary-noselection
- To Next Region Boundary (No Track Selection)
- - Editor/selected-marker-to-previous-region-boundary
- To Previous Region Boundary
- - Editor/selected-marker-to-previous-region-boundary-noselection
- To Previous Region Boundary (No Track Selection)
- - Editor/select-range-between-cursors
- Select Edit Range
- - Editor/separate-from-loop
- Separate Using Loop Range
- - Editor/separate-from-punch
- Separate Using Punch Range
- - Editor/set-edit-lock
- Lock
- - Editor/set-edit-point
- Active Marker to Mouse
- - Editor/set-edit-ripple
- - Editor/set-edit-slide
- Slide
- - Editor/set-loop-from-edit-range
- Set Loop from Edit Range
- - Editor/set-playhead
- Playhead to Mouse
- - Editor/set-punch-from-edit-range
- Set Punch from Edit Range
- - Editor/set-session-end-from-playhead
- - Editor/set-session-from-edit-range
- - Editor/set-session-start-from-playhead
- - Editor/set-tempo-from-edit-range
- Set Tempo from Edit Range = Bar
- - Editor/show-editor-list
- Show Editor List
- - Editor/show-editor-mixer
- Show Editor Mixer
- - Editor/show-marker-lines
- Show Marker Lines
- - Editor/shrink-tracks
- Shrink Track Height
- - Editor/snap-magnetic
- Magnetic
- - Editor/snap-normal
- Grid
- - Editor/snap-off
- No Grid
- - Editor/sound-midi-notes
- Sound Selected MIDI Notes
- - Editor/start-loop-range
- - Editor/start-punch-range
- - Editor/start-range
- Start Range
- - Editor/start-range-from-playhead
- - Editor/step-mouse-mode
- Step Mouse Mode
- - Editor/step-tracks-down
- Step Tracks Down
- - Editor/step-tracks-up
- Step Tracks Up
- - Editor/tab-to-transient-backwards
- Move Earlier to Transient
- - Editor/tab-to-transient-forwards
- Move Later to Transient
- - Editor/temporal-zoom-in
- Zoom In
- - Editor/temporal-zoom-out
- Zoom Out
- - Editor/toggle-edit-mode
- Toggle Edit Mode
- - Editor/toggle-follow-playhead
- Follow Playhead
- - Editor/toggle-log-window
- Log
- - Editor/toggle-midi-input-active
- Toggle MIDI Input Active for Editor-Selected Tracks/Busses
- - Editor/toggle-skip-playback
- - Editor/toggle-stationary-playhead
- Stationary Playhead
- - Editor/toggle-track-active
- Toggle Active
- - Editor/toggle-vmon-frame
- Frame number
- - Editor/toggle-vmon-fullscreen
- Fullscreen
- - Editor/toggle-vmon-letterbox
- Letterbox
- - Editor/toggle-vmon-ontop
- Always on Top
- - Editor/toggle-vmon-osdbg
- Timecode Background
- - Editor/toggle-vmon-timecode
- Timecode
- - Editor/toggle-zoom
- Toggle Zoom State
- - Editor/track-height-large
- Large
- - Editor/track-height-larger
- Larger
- - Editor/track-height-largest
- Largest
- - Editor/track-height-normal
- Normal
- - Editor/track-height-small
- Small
- - Editor/track-mute-toggle
- Toggle Mute
- - Editor/track-record-enable-toggle
- Toggle Record Enable
- - Editor/track-solo-isolate-toggle
- Toggle Solo Isolate
- - Editor/track-solo-toggle
- Toggle Solo
- - Editor/undo
- Undo
- - Editor/undo-last-selection-op
- - Editor/zoom-to-selection
- - Editor/zoom-to-session
- Zoom to Session
- - Editor/zoom-vmon-100
- Original Size
- - Editor/zoom_100_ms
- - Editor/zoom_10_min
- - Editor/zoom_10_ms
- - Editor/zoom_10_sec
- - Editor/zoom_1_min
- - Editor/zoom_1_sec
- - Editor/zoom_5_min
-
- - EditorMenu/ActionScripts
- - EditorMenu/AlignMenu
- Align
- - EditorMenu/Autoconnect
- Autoconnect
- - EditorMenu/Crossfades
- Crossfades
- - EditorMenu/EditCursorMovementOptions
- Move Selected Marker
- - EditorMenu/Edit
- Edit
- - EditorMenu/EditPointMenu
- Edit Point
- - EditorMenu/EditSelectRangeOptions
- Select Range Operations
- - EditorMenu/EditSelectRegionOptions
- Select Regions
- - EditorMenu/FadeMenu
- Fade
- - EditorMenu/LatchMenu
- Latch
- - EditorMenu/Link
- Link
- - EditorMenu/LocateToMarker
- Locate to Markers
- - EditorMenu/MIDI
- MIDI Options
- - EditorMenu/MarkerMenu
- Markers
- - EditorMenu/MeterFalloff
- Meter falloff
- - EditorMenu/MeterHold
- Meter hold
- - EditorMenu/MiscOptions
- Misc Options
- - EditorMenu/Monitoring
- Monitoring
- - EditorMenu/MoveActiveMarkMenu
- Active Mark
- - EditorMenu/MovePlayHeadMenu
- Playhead
- - EditorMenu/PlayMenu
- Play
- - EditorMenu/PrimaryClockMenu
- Primary Clock
- - EditorMenu/Pullup
- Pullup / Pulldown
- - EditorMenu/RegionEditOps
- Region operations
- - EditorMenu/RegionGainMenu
- Gain
- - EditorMenu/RegionMenuDuplicate
- Duplicate
- - EditorMenu/RegionMenuEdit
- Edit
- - EditorMenu/RegionMenuFades
- Fades
- - EditorMenu/RegionMenuGain
- Gain
- - EditorMenu/RegionMenu
- Region
- - EditorMenu/RegionMenuLayering
- Layering
- - EditorMenu/RegionMenuMIDI
- MIDI
- - EditorMenu/RegionMenuPosition
- Position
- - EditorMenu/RegionMenuRanges
- Ranges
- - EditorMenu/RegionMenuTrim
- Trim
- - EditorMenu/RulerMenu
- Rulers
- - EditorMenu/SavedViewMenu
- Views
- - EditorMenu/ScrollMenu
- Scroll
- - EditorMenu/SecondaryClockMenu
- Secondary Clock
- - EditorMenu/Select
- Select
- - EditorMenu/SelectMenu
- Select
- - EditorMenu/SeparateMenu
- Separate
- - EditorMenu/SetLoopMenu
- Loop
- - EditorMenu/SetPunchMenu
- Punch
- - EditorMenu/Solo
- Solo
- - EditorMenu/Subframes
- Subframes
- - EditorMenu/SyncMenu
- Sync
- - EditorMenu/TempoMenu
- Tempo
- - EditorMenu/Timecode
- Timecode fps
- - EditorMenu/Tools
- Tools
- - EditorMenu/TrackHeightMenu
- Height
- - EditorMenu/TrackMenu
- Track
- - EditorMenu/VideoMonitorMenu
- Video Monitor
- - EditorMenu/View
- View
- - EditorMenu/ZoomFocus
- Zoom Focus
- - EditorMenu/ZoomFocusMenu
- Zoom Focus
- - EditorMenu/ZoomMenu
- Zoom
-
- - MouseMode/set-mouse-mode-audition
- Audition Tool
- - MouseMode/set-mouse-mode-content
- - MouseMode/set-mouse-mode-cut
- - MouseMode/set-mouse-mode-draw
- Note Drawing Tool
- - MouseMode/set-mouse-mode-object
- Object Tool
- - MouseMode/set-mouse-mode-object-range
- Smart Object Mode
- - MouseMode/set-mouse-mode-range
- Range Tool
- - MouseMode/set-mouse-mode-timefx
- Time FX Tool
-
- - Region/add-range-marker-from-region
- Add Single Range Marker
- - Region/add-range-markers-from-region
- Add Range Marker Per Region
- - Region/align-regions-end
- Align End
- - Region/align-regions-end-relative
- Align End Relative
- - Region/align-regions-start
- Align Start
- - Region/align-regions-start-relative
- Align Start Relative
- - Region/align-regions-sync
- Align Sync
- - Region/align-regions-sync-relative
- Align Sync Relative
- - /Region/alternate-nudge-backward
- - /Region/alternate-nudge-forward
- - /Region/alternate-set-fade-in-length
- - /Region/alternate-set-fade-out-length
- - Region/boost-region-gain
- Boost Gain
- - Region/bounce-regions-processed
- Bounce (without processing)
- - Region/bounce-regions-unprocessed
- Bounce (with processing)
- - Region/choose-top-region-context-menu
- Choose Top...
- - Region/choose-top-region
- Choose Top...
- - Region/close-region-gaps
- Close Gaps
- - Region/combine-regions
- Combine
- - Region/cut-region-gain
- Cut Gain
- - Region/duplicate-region
- Duplicate
- - Region/export-region
- Export...
- - Region/fork-region
- Unlink from other copies
- - Region/insert-patch-change-context
- Insert Patch Change...
- - Region/insert-patch-change
- Insert Patch Change...
- - Region/insert-region-from-region-list
- Insert Region From Region List
- - /Region/legatize-region
- - Region/loop-region
- Loop
- - Region/loudness-analyze-region
- - Region/lower-region
- Lower
- - Region/lower-region-to-bottom
- Lower to Bottom
- - Region/multi-duplicate-region
- Multi-Duplicate...
- - Region/naturalize-region
- Move to Original Position
- - Region/normalize-region
- Normalize...
- - Region/nudge-backward-by-capture-offset
- Nudge Earlier by Capture Offset
- - Region/nudge-backward
- Nudge Earlier
- - Region/nudge-forward-by-capture-offset
- Nudge Later by Capture Offset
- - Region/nudge-forward
- Nudge Later
- - Region/pitch-shift-region
- Pitch Shift...
- - Region/place-transient
- Place Transient
- - Region/play-selected-regions
- Play
- - Region/quantize-region
- Quantize...
- - Region/raise-region
- Raise
- - Region/raise-region-to-top
- Raise to Top
- - Region/region-fill-track
- Fill Track
- - Region/remove-region
- Remove
- - Region/remove-region-sync
- Remove Sync
- - Region/rename-region
- Rename...
- - Region/reset-region-gain-envelopes
- Reset Envelope
- - Region/reset-region-scale-amplitude
- Reset Gain
- - Region/reverse-region
- Reverse
- - Region/separate-under-region
- Separate Under
- - Region/sequence-regions
- - Region/set-fade-in-length
- Set Fade In Length
- - Region/set-fade-out-length
- Set Fade Out Length
- - Region/set-loop-from-region
- Set Loop Range
- - Region/set-punch-from-region
- Set Punch
- - Region/set-region-sync-position
- Set Sync Position
- - Region/set-selection-from-region
- Set Range Selection
- - Region/set-tempo-from-region
- Set Tempo from Region = Bar
- - Region/show-region-list-editor
- List Editor...
- - Region/show-region-properties
- Properties...
- - Region/show-rhythm-ferret
- Rhythm Ferret...
- - Region/snap-regions-to-grid
- Snap Position To Grid
- - Region/split-multichannel-region
- Make Mono Regions
- - Region/split-region-at-transients
- Split at Percussion Onsets
- - Region/split-region
- Split
- - Region/strip-region-silence
- Strip Silence...
- - Region/toggle-opaque-region
- Opaque
- - Region/toggle-region-fade-in
- Fade In
- - Region/toggle-region-fade-out
- Fade Out
- - Region/toggle-region-fades
- Fades
- - Region/toggle-region-gain-envelope-active
- Envelope Active
- - Region/toggle-region-lock
- Lock
- - Region/toggle-region-lock-style
- Glue to Bars and Beats
- - Region/toggle-region-mute
- Mute
- - Region/toggle-region-video-lock
- Lock to Video
- - Region/transform-region
- - Region/transpose-region
- Transpose...
- - Region/trim-back
- Trim End at Edit Point
- - Region/trim-front
- Trim Start at Edit Point
- - Region/trim-region-to-loop
- Trim to Loop
- - Region/trim-region-to-punch
- Trim to Punch
- - Region/trim-to-next-region
- Trim to Next
- - Region/trim-to-previous-region
- Trim to Previous
- - Region/uncombine-regions
- Uncombine
-
- - RegionList/RegionListSort
- Sort
- - RegionList/SortAscending
- Ascending
- - RegionList/SortByRegionEndinFile
- By Region End in File
- - RegionList/SortByRegionLength
- By Region Length
- - RegionList/SortByRegionName
- By Region Name
- - RegionList/SortByRegionPosition
- By Region Position
- - RegionList/SortByRegionStartinFile
- By Region Start in File
- - RegionList/SortByRegionTimestamp
- By Region Timestamp
- - RegionList/SortBySourceFileCreationDate
- By Source File Creation Date
- - RegionList/SortBySourceFileLength
- By Source File Length
- - RegionList/SortBySourceFileName
- By Source File Name
- - RegionList/SortBySourceFilesystem
- By Source Filesystem
- - RegionList/SortDescending
- Descending
- - RegionList/removeUnusedRegions
- Remove Unused
- - RegionList/rlAudition
- Audition
- - RegionList/rlHide
- Hide
- - RegionList/rlShow
- Show
- - RegionList/rlShowAll
- Show All
- - RegionList/rlShowAuto
- Show Automatic Regions
-
- - Rulers/toggle-bbt-ruler
- Bars & Beats
- - Rulers/toggle-cd-marker-ruler
- CD Markers
- - Rulers/toggle-loop-punch-ruler
- Loop/Punch
- - Rulers/toggle-marker-ruler
- Markers
- - Rulers/toggle-meter-ruler
- Meter
- - Rulers/toggle-minsec-ruler
- Min:Sec
- - Rulers/toggle-range-ruler
- Ranges
- - Rulers/toggle-samples-ruler
- Samples
- - Rulers/toggle-tempo-ruler
- Tempo
- - Rulers/toggle-timecode-ruler
- Timecode
- - Rulers/toggle-video-ruler
- Video
-
-
- - Snap/snap-to-asixteenthbeat
- Snap to Sixteenths
- - Snap/snap-to-bar
- Snap to Bar
- - Snap/snap-to-beat
- Snap to Beat
- - Snap/snap-to-cd-frame
- Snap to CD Frame
- - Snap/snap-to-eighths
- Snap to Eighths
- - Snap/snap-to-fifths
- Snap to Fifths
- - Snap/snap-to-fourteenths
- Snap to Fourteenths
- - Snap/snap-to-halves
- Snap to Halves
- - Snap/snap-to-mark
- Snap to Mark
- - Snap/snap-to-minutes
- Snap to Minutes
- - Snap/snap-to-onetwentyeighths
- Snap to One Twenty Eighths
- - Snap/snap-to-quarters
- Snap to Quarters
- - Snap/snap-to-region-boundary
- Snap to Region Boundary
- - Snap/snap-to-region-end
- Snap to Region End
- - Snap/snap-to-region-start
- Snap to Region Start
- - Snap/snap-to-region-sync
- Snap to Region Sync
- - Snap/snap-to-seconds
- Snap to Seconds
- - Snap/snap-to-sevenths
- Snap to Sevenths
- - Snap/snap-to-sixths
- Snap to Sixths
- - Snap/snap-to-sixtyfourths
- Snap to Sixty Fourths
- - Snap/snap-to-tenths
- Snap to Tenths
- - Snap/snap-to-thirds
- Snap to Thirds
- - Snap/snap-to-thirtyseconds
- Snap to Thirty Seconds
- - Snap/snap-to-timecode-frame
- Snap to Timecode Frame
- - Snap/snap-to-timecode-minutes
- Snap to Timecode Minutes
- - Snap/snap-to-timecode-seconds
- Snap to Timecode Seconds
- - Snap/snap-to-twelfths
- Snap to Twelfths
- - Snap/snap-to-twentieths
- Snap to Twentieths
- - Snap/snap-to-twentyeighths
- Snap to Twenty Eighths
- - Snap/snap-to-twentyfourths
- Snap to Twenty Fourths
-
- - Zoom/zoom-focus-center
- Zoom Focus Center
- - Zoom/zoom-focus-edit
- Zoom Focus Edit Point
- - Zoom/zoom-focus-left
- Zoom Focus Left
- - Zoom/zoom-focus-mouse
- Zoom Focus Mouse
- - Zoom/zoom-focus-playhead
- Zoom Focus Playhead
- - Zoom/zoom-focus-right
- Zoom Focus Right
-
- - /Mixer/ab-plugins
- - /Mixer/copy-processors
- - /Mixer/cut-processors
- - /Mixer/decrement-gain
- - /Mixer/delete-processors
- - /Mixer/increment-gain
- - /Mixer/mute
- - /Mixer/paste-processors
- - /Mixer/recenable
- - /Mixer/scroll-left
- - /Mixer/scroll-right
- - /Mixer/select-all-processors
- - /Mixer/select-none
- - /Mixer/solo
- - /Mixer/toggle-midi-input-active
- - /Mixer/toggle-processors
- - /Mixer/unity-gain
-
-
{% 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
index 0000000..2e52d8b
--- /dev/null
+++ b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/01_osc-control.html
@@ -0,0 +1,514 @@
+---
+layout: default
+title: OSC: Controlling Ardour with OSC
+---
+
+
+ OSC 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).
+
+
+
+ Note: 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
+ Osc control in ardour 4.7 and prior.
+
+
+
+ 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, particularly the "Actions" part below, since this relates to the
+ GTK GUI for Ardour rather than the backend.
+
+
+Connecting to Ardour via OSC
+
+ OSC support is not enabled by default, but can be turned on via
+ .
+ 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:
+
+<Option name="osc-port" value="Your choice
+here"/>
+
+
+ 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
+ OSC feedback In Ardour.
+
+
+Control Surface Set Up
+
+
+ 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.
+
+
+ Any time the /set_surface 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.
+
+
+ Surface Port Setting is available in the OSC GUI.
+
+
+ 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
+ Ardour's Setup Dialog.
+
+If /set_surface is not sent, the default values are used:
+
+ - Bank Size: 0 - No banking (or infinite bank size).
+ - Strip Types: All strip types except hidden and special.
+ - Feedback: 0 - All off.
+ - Fader Mode: 0 - gain in dB (not relevant with feedback off)
+
+
+
+ These values give the same behaviour as prior versions of Ardour. (or the closest possible)
+
+
+ - /set_surface bank_size strip_types
+ feedback fadermode
+ -
+ See below for an explanation of each parameter.
+
+
+bank_size
+
+ 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.
+
+
+ Bank size can also be set with /set_surface/bank_size size.
+
+strip_types
+
+ 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.
+
+
+ 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.
+
+
+ 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.
+
+Please see:
+ Calculating Feedback and Strip-types Values.
+
+
+ Strip types can also be set with /set_surface/strip_types types.
+
+feedback
+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.
+
+Please see:
+ Calculating Feedback and Strip-types Values.
+
+ Feedback can also be set with /set_surface/feedback feedback.
+
+
+gainmode
+
+ Gainmode is a an int that acts as a bool:
+
+ - 0 (or false) dB value as a float from -193 to +6. Sent as
+ /strip/gain SSID value. (-193 or below are the same as -inf)
+ - 1 (or true) A positional fader based on the same math
+ as Ardour's GUI. An Float from 0 to 1. Sent as
+ /strip/fader SSID value
+
+
+
+ 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.
+
+
+ Gain mode can also be set with /set_surface/gainmode gainmode.
+
+
+Querying Ardour for information
+
+ The control Surface may wish to control the type a frequency of
+ updates it receives. It can do this with querying commands. See:
+ Querying Ardour with OSC.
+
+
+List of OSC messages
+
+ Parameter types show how the value will be used. However, they may
+ be sent as a different type if needed, see:
+ Parameter Types in OSC.
+
+Master or Global messages
+
+Transport Control
+
+ - /transport_stop
+
+ - /transport_play
+
+ - /toggle_roll
+ - Toggles between play and stop
+ - /set_transport_speed s
+ - where s is a float ranging from -8.0f to 8.0f
+ - /ffwd
+
+ - /rewind
+
+ - /goto_start
+
+ - /goto_end
+
+ - /jump_bars bars
+ - Where bars is a float (+/-) of the number of bars to jump
+ - /jump_seconds seconds
+ - Where seconds is a float (+/-) of the number of seconds to jump
+ - /add_marker
+ - (adds marker to the current transport position)
+ - /remove_marker
+ - Removes marker at the current transport position (if there is one)
+ - /mark_in
+ - Marks the begining of a range at the current transport position
+ - /mark_out
+ - Marks the end of a range at the current transport position
+ - /next_marker
+
+ - /prev_marker
+
+ - /locate spos roll
+ - where spos is the target position in samples and
+ roll is a bool/integer defining whether you want transport
+ to be kept rolling or not
+ - /loop_toggle
+
+ - /loop_location start end
+ - start is the beginning of a loop and end is the
+ end of a loop both are integer frame positions.
+ - /set_loop_range
+ - Uses edit range as loop range
+ - /set_session_range
+ - Uses edit range as session range
+ - /toggle_click
+
+ - /midi_panic
+ - Ardour will send an all notes off to all midi tracks
+ - /cancel_all_solos
+ - Cancel All Solos/PFLs/AFLs
+
+
+Transport Information
+
+ - /transport_frame
+ - Ardour sends /transport_frame current_frame
+ - /transport_speed
+ - Ardour sends /transport_speed speed
+ - /record_enabled
+ - Ardour sends /record_enabled recordenable_status
+
+
+Editing-related
+
+ - /undo
+
+ - /redo
+
+ - /save_state
+ - (this is the regular
+ operation)
+ - /quick_snapshot_switch
+ - Take a snapshot and switch to new version
+ - /quick_snapshot_stay
+ - Take a snapshot and keep working on this version
+ - /fit_*_track(s)
+ - Were * is one of 1, 2, 4, 8, 16, 32 or all. Fits this
+ many tracks in editor window. (add s for more than 1)
+ - /zoom_*
+ - Zoom editor to include * where * is 100_ms, 1_sec,
+ 10_sec, 1_min, 5_min, 10_min or to_session
+ - /temporal_zoom_in
+ - Zoom editor in to show less time
+ - /temporal_zoom_out
+ - Zoom editor out to show more time
+ - /scroll_up_1_track
+ - Scroll the editor pane up 1 track
+ - /scroll_up_1_page
+ - Scroll the editor pane up 1 page
+ - /scroll_dn_1_track
+ - Scroll the editor pane down 1 track
+ - /scroll_dn_1_page
+ - Scroll the editor pane down 1 page
+
+
+Recording control
+
+ - /toggle_punch_in
+
+ - /toggle_punch_out
+
+ - /set_punch_range
+ - Uses edit range as punch range
+ - /rec_enable_toggle
+
+
+ - /stop_forget
+ - Stop transport and delete/forget last take
+
+
+Master and Monitor strip control
+
+ - /master/gain dB
+ - See gain in strips
+ - /master/fader position
+ - See fader in strips
+ - /master/trimdB dB
+ - see trimdb in strips
+ - /master/pan_stereo_position position
+ - See pan_stereo_position in strips
+ - /master/mute yn
+ - See mute in strips
+ - /monitor/gain dB
+ - See gain in strips
+ - /monitor/fader position
+ - See fader in strips
+
+
+Track specific operations
+
+ For each of the following, ssid is the Surface Strip ID for the track
+
+
+ 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
+ /set_surface.
+
+
+ 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.
+
+
+ - /bank_up
+ - Change bank to the next higher bank.
+ - /bank_down
+ - Change bank to the next lower bank.
+ - /strip/mute ssid mute_st
+ - where mute_st is a bool/int representing the desired mute state of the track
+ - /strip/solo ssid solo_st
+ - where solo_st is a bool/int representing the desired solo state of the track
+ - /strip/solo_iso ssid state
+ - where state is a bool/int representing the desired solo isolate state of the track
+ - /strip/solo_safe ssid state
+ - where state is a bool/int representing the desired solo safe/lock state of the track
+ - /strip/monitor_input ssid monitor_st
+ - where monitor_st is a bool/int where 1 is forced input monitoring.
+ - /strip/monitor_disk ssid monitor_st
+ - where monitor_st is a bool/int where 1 is forced disk monitoring. When input and disk are both off,
+ Auto monitoring is enabled.
+ - /strip/recenable ssid rec_st
+ - where rec_st is a bool/int representing the desired rec state of the track
+ - /strip/record_safe ssid rec_st
+ - where rec_st is a bool/int representing the desired record safe state of the track
+ - /strip/polarity ssid invert
+ - where invert is a bool/int representing the desired polarity of the track
+ - /strip/gain ssid gain
+ - where gain is a float ranging from -193 to 6 representing the desired gain of the track in dB.
+ - /strip/fader ssid position
+ - where position is a float ranging from 0 to 1 representing the fader control position.
+ - /strip/trimdB ssid trim_db
+ - where trim_db is a float ranging from -20 to 20 representing the desired trim of the track in dB.
+ - /strip/pan_stereo_position ssid position
+ - where position is a float ranging from 0 to 1 representing the desired pan position of the track
+ - /strip/pan_stereo_width ssid width
+ - where width is a float ranging from 0 to 1 representing the desired pan width of the track
+ - /strip/send/gain ssid sendid send_gain
+ - where sendid = nth_send, send_gain is a float
+ ranging from -193 to +6 representing the desired gain in dB for the send
+ - /strip/send/fader ssid sendid send_gain
+ - where sendid = nth_send, send_gain is a float
+ ranging from 0 to 1 representing the desired position for the send as a fader
+ - /strip/send/enable ssid sendid state
+ - where sendid = nth_send, state is 1 for enabled and 0 for disabled
+ - /strip/list
+ - see:
+ Querying Ardour with OSC.
+ - /strip/sends ssid
+ - see:
+ Querying Ardour with OSC.
+ - /strip/receives ssid
+ - see:
+ Querying Ardour with OSC.
+ - /strip/plugin/list ssid
+ - see:
+ Querying Ardour with OSC.
+ - /strip/plugin/descriptor ssid
+ - see:
+ Querying Ardour with OSC.
+ - /strip/plugin/reset ssid piid
+ - where piid = nth Plugin, will reset all values to the plugin's original values
+ - /strip/plugin/activate ssid piid
+ - where piid = nth Plugin, will set the plugin's state to active
+ - /strip/plugin/deactivate ssid piid
+ - where piid = nth Plugin, will set the plugin's state to inactive
+ - /strip/plugin/parameter ssid piid param value
+ - where piid = nth Plugin, param = nth param, value
+ is a float ranging from 0 to 1 representing the desired parameter value
+ - /strip/name ssid name
+ - where name is a string for the desired name of the track
+
+Selected Strip Operations
+
+ New for Ardour 5, A whole set of operations that work on the selected
+ or expanded strip.
+
+
+ Selected strip operations are complex enough for their own page.
+ Please read:
+ Selection Considerations in OSC. This is most important if more
+ than one OSC surface is being used with Ardour.
+
+
+ There are two kinds of selection in OSC. GUI selection and local
+ expansion. By default expansion follows selection.
+
+ -
+ GUI selection: Use /strip/select to set. Selecting
+ a strip in the GUI will set OSC surface select and the surface
+ will set GUI selection as well.
+
+ -
+ Local expansion: Use /strip/expand 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.
+
+
+
+
+
+ - /strip/select ssid y/n
+ - Where y/n = 1 for select. Sets both GUI select and strip
+ to expanded mode. (0 is ignored)
+ - /strip/expand ssid y/n
+ - Where y/n = 1 for expanded mode. Sets only local strip to
+ Expanded. Setting to 0 resets the expansion to follow selection.
+ - /select/expand y/n
+ - Where y/n = 1 for expanded mode, 0 for Select mode.
+ - /select/recenable y/n
+ - Where y/n is 1 for enabled and 0 for disabled
+ - /select/record_safe y/n
+ - Where y/n is 1 for safe and 0 for unlocked
+ - /select/mute y/n
+ - Where y/n is 1 for enabled and 0 for disabled
+ - /select/solo y/n
+ - Where y/n is 1 for enabled and 0 for disabled
+ - /select/solo_iso state
+ - where state is a bool/int representing the desired solo isolate state of the track
+ - /select/solo_safe state
+ - where state is a bool/int representing the desired solo safe/lock state of the track
+ - /select/monitor_input y/n
+ - Where y/n is 1 for monitor from input and 0 for auto
+ - /select/monitor_disk y/n
+ - Where y/n is 1 for monitor from disk and 0 for auto
+ - /select/polarity invert
+ - where invert is a bool/int representing the desired polarity of the track
+ - /select/gain gain
+ - Where gain is a float ranging from -193 to 6 representing the desired gain of the track in dB.
+ - /select/fader position
+ - Where position is an float ranging from 0 to 1 representing the fader control position.
+ - /select/trimdB trim_db
+ - where trim_db is a float ranging from -20 to 20 representing the desired trim of the track in dB.
+ - /select/pan_stereo_position position
+ - where position is a float ranging from 0 to 1 representing the desired pan position of the track
+ - /select/pan_stereo_width width
+ - where width is a float ranging from 0 to 1 representing the desired pan width of the track
+ - /select/pan_elevation_position position
+ - where position is a float ranging from 0 to 1 representing the desired pan elevation of the track
+ - /select/pan_frontback_position position
+ - where position is a float ranging from 0 to 1 representing the desired front to back position of the track
+ - /select/pan_lfe_control value
+ - where value is a float ranging from 0 to 1 representing the desired LFE control value for the track
+ - /select/send_gain", sendid send_gain
+ - where sendid = nth_send, send_gain is a float
+ ranging from -193 to +6 representing the desired gain in dB for the send
+ - /select/send_fader", sendid send_gain
+ - where sendid = nth_send, send_gain is a float
+ ranging from 0 to 1 representing the desired position for the send as a fader
+ - /select/send_enable", sendid state
+ - where sendid = nth_send, state is 1 for enabled and 0 for disabled
+
+
+Menu actions
+
+ 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):
+/access_action action_name
+
+ The
+ list of actions shows all available values of action-name 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.
+
+
+{% children %}
diff --git a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/06_osc-setup-dialog.html b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/02_osc-setup-dialog.html
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 ffa9948..d21edf8 100644
--- a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/06_osc-setup-dialog.html
+++ b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/02_osc-setup-dialog.html
@@ -1,7 +1,7 @@
---
layout: default
-title: Using the OSC Setup Dialog
----
+title: OSC: Using the Setup Dialog
+---
Starting with Ardour 5.1 OSC has a graphic setup dialog. This dialog
diff --git a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/07_querying-ardour-with-osc.html b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/03_querying-ardour-with-osc.html
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 3ad110f..13e7322 100644
--- a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/07_querying-ardour-with-osc.html
+++ b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/03_querying-ardour-with-osc.html
@@ -1,7 +1,7 @@
---
layout: default
-title: Querying Ardour with OSC
----
+title: OSC: Querying Ardour
+---
In order to make a custom controller that knows what strips Ardour
diff --git a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/02_feedback-in-osc.html b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/04_feedback-in-osc.html
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 2214d0d..1b40557 100644
--- a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/02_feedback-in-osc.html
+++ b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/04_feedback-in-osc.html
@@ -1,13 +1,13 @@
---
layout: default
-title: OSC Feedback With Ardour
----
-
+title: OSC: Feedback
+---
+
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
/bank_down LED
where LED is a bool that indicates another bank_down operation is possible.
/strip/name ssid track_name
- where track_name is a string representing the name of the track
+ where track_name is a string representing the name of the track
(note there is no coresponding command to set the track name)
/strip/mute ssid mute_st
where mute_st is a bool/int representing the actual mute state of the track
diff --git a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/05_calculating-feedback-and-strip-types-values.html
similarity index 96%
rename from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html
rename to _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/05_calculating-feedback-and-strip-types-values.html
index 6e8340c..91a9b70 100644
--- a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html
+++ b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/05_calculating-feedback-and-strip-types-values.html
@@ -1,7 +1,7 @@
---
layout: default
-title: Calculating Feedback and Strip-types Values
----
+title: OSC: Feedback and Strip-types Values
+---
/set_surface 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.
@@ -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 Aux 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.
-feedback
+feedback
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.
diff --git a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/04_parameter-types-in-osc.html b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/07_parameter-types-in-osc.html
similarity index 97%
rename from _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/04_parameter-types-in-osc.html
rename to _manual/23_using-control-surfaces/01_controlling-ardour-with-osc/07_parameter-types-in-osc.html
index 15956d0..7af30f0 100644
--- a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/04_parameter-types-in-osc.html
+++ b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/07_parameter-types-in-osc.html
@@ -1,6 +1,6 @@
---
layout: default
-title: Parameter Types in OSC
+title: OSC: Parameter Types
---
diff --git a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/05_selection-considerations-in-osc.html b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/08_selection-considerations-in-osc.html
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 63b16bc..3996b49 100644
--- a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/05_selection-considerations-in-osc.html
+++ b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/08_selection-considerations-in-osc.html
@@ -1,6 +1,6 @@
---
layout: default
-title: Selection/Feedback Expansion Considerations in OSC
+title: OSC: Selection and Expansion Considerations
---
@@ -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.
+
+ Both select and expansion use the /select set of commands.
+
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.
diff --git a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/01_osc-control-in-ardour-4.7-and-prior.html b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/10_osc-control-in-ardour-4.7-and-prior.html
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 141ec81..1b1e470 100644
--- a/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/01_osc-control-in-ardour-4.7-and-prior.html
+++ b/_manual/23_using-control-surfaces/01_controlling-ardour-with-osc/10_osc-control-in-ardour-4.7-and-prior.html
@@ -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
+---
+
+
+ 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.
+
+
- OSC 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,
+ OSC 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).
- 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, 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 messages 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.
Connecting to Ardour via OSC
- OSC support is not enabled by default, but can be turned on via
- .
- Once enabled, Ardour will listen on port 3819
by default.
- This port number can be changed by editing $ARDOUR_CONFIG
+ OSC support is not enabled by default, but can be turned on via
+ .
+ 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:
<Option name="osc-port" value="Your choice
@@ -55,7 +61,7 @@ here"/>
/ardour/locate spos roll
where spos is the target position in samples and
- roll is a bool/integer defining whether you want transport
+ roll is a bool/integer defining whether you want transport
to be kept rolling or not
/ardour/loop_toggle
@@ -579,7 +585,7 @@ here"/>
Region/trim-to-next-regionTrim to Next
Region/trim-to-previous-regionTrim to Previous
Region/uncombine-regionsUncombine
- Rulers/toggle-bbt-rulerBars & Beats
+ Rulers/toggle-bbt-rulerBars & Beats
Rulers/toggle-cd-marker-rulerCD Markers
Rulers/toggle-loop-punch-rulerLoop/Punch
Rulers/toggle-marker-rulerMarkers
@@ -633,8 +639,8 @@ here"/>
Transport/LoopPlay Loop Range
Transport/PlayPrerollPlay Selection w/Preroll
Transport/PlaySelectionPlay Selected Range
- Transport/primary-clock-bbtBars & Beats
- Transport/primary-clock-minsecMinutes & Seconds
+ Transport/primary-clock-bbtBars & Beats
+ Transport/primary-clock-minsecMinutes &am Seconds
Transport/primary-clock-samplesSamples
Transport/primary-clock-timecodeTimecode
Transport/RecordEnable Record
@@ -643,8 +649,8 @@ here"/>
Transport/RewindRewind
Transport/RewindSlowRewind (Slow)
Transport/RollRoll
- Transport/secondary-clock-bbtBars & Beats
- Transport/secondary-clock-minsecMinutes & Seconds
+ Transport/secondary-clock-bbtBars & Beats
+ Transport/secondary-clock-minsecMinutes & Seconds
Transport/secondary-clock-samplesSamples
Transport/secondary-clock-timecodeTimecode
Transport/StopStop