diff --git a/include/audio-midi-setup.html b/include/audio-midi-setup.html
new file mode 100644
index 00000000..2ce417b8
--- /dev/null
+++ b/include/audio-midi-setup.html
@@ -0,0 +1,70 @@
+
Audio/MIDI Setup
+
+
+
+
+ The Audio/MIDI Setup Dialog
+
+
+
+
+ This window exposes the different audio options to be used by Ardour for the
+ current work session, for hardware and software and is made of:
+
+
+
+
Audio System
+
Depending on the operating system, Ardour can possibly use different audio
+ systems, e.g. on Linux, both
+ ALSA and JACK are
+ available.
+
+
Driver
+
+ On Mac OS X this will typically be CoreAudio. On Linux usually
+ this will be either FFADO
+ or ALSA, depending on whether or not a firewire device
+ is used. Advanced users on all platforms may also
+ use NetJack which provides network audio I/O.
+
+
Device
+
The selector should show all available interfaces provided by the
+ driver above and which are capable of duplex operation.
+
+ When using an Intel Mac running OS X and the builtin audio
+ interface, its separate input and output devices must be
+ merged first into a single "aggregate device" before Ardour will be able
+ to use it.
+
+
+
Sample Rate
+
+ The selector will allow to select from any sample rate supported by the device
+ selected above it.
+
+
Buffer Size
+
+ The size of the buffer used by the audio interface can be adjusted
+ to allow for either lower latency, or lower CPU usage and higher
+ latency.
+
+
Input/Output Channels
+
+ Specifies the number of hardware channels to use. The
+ default is all available channels.
+
Hardware Input/Output Latency
+
Specify the hardware delay in samples for precise latency compensation.
+
Calibrate
+
+ This button runs a semi-automated guided process to obtain
+ precise hardware latency measurements for the above option.
+
MIDI System
+
+ Selects the MIDI driver to use. On Mac OS X, this will be CoreMIDI. On Linux, this will follow the audio backend.
+ If the Audio backend is ALSA, midi will be alsa also. If the backend is
+ JACK, it can be changed between two legacy
+ ALSA drivers or the (preferred) new JACK+ALSA implementation.
Whether or not a template is used, and before the "Template Setup" dialog, the
- Audio/MIDI Setup will be shown.
+ Audio/MIDI Setup will be shown.
-
Audio/MIDI Setup
-
-
-
- The Audio/MIDI Setup Dialog
-
-
-
-
- This window exposes the different audio options to be used by Ardour for the
- current work session, for hardware and software and is made of:
-
-
-
-
Audio System
-
Depending on the operating system, Ardour can possibly use different audio
- systems, e.g. on Linux, both
- ALSA and JACK are
- available.
-
-
Driver
-
- On Mac OS X this will typically be CoreAudio. On Linux usually
- this will be either FFADO
- or ALSA, depending on whether or not a firewire device
- is used. Advanced users on all platforms may also
- use NetJack which provides network audio I/O.
-
-
Device
-
The selector should show all available interfaces provided by the
- driver above and which are capable of duplex operation.
-
- When using an Intel Mac running OS X and the builtin audio
- interface, its separate input and output devices must be
- merged first into a single "aggregate device" before Ardour will be able
- to use it.
-
-
-
Sample Rate
-
- The selector will allow to select from any sample rate supported by the device
- selected above it.
-
-
Buffer Size
-
- The size of the buffer used by the audio interface can be adjusted
- to allow for either lower latency, or lower CPU usage and higher
- latency.
-
-
Input/Output Channels
-
- Specifies the number of hardware channels to use. The
- default is all available channels.
-
Hardware Input/Output Latency
-
Specify the hardware delay in samples for precise latency compensation.
-
Calibrate
-
- This button runs a semi-automated guided process to obtain
- precise hardware latency measurements for the above option.
-
MIDI System
-
- Selects the MIDI driver to use. On Mac OS X, this will be CoreMIDI. On Linux, this will follow the audio backend.
- If the Audio backend is ALSA, midi will be alsa also. If the backend is
- JACK, it can be changed between two legacy
- ALSA drivers or the (preferred) new JACK+ALSA implementation.
- Signal processing uses: sets how many cpu processors can be
- used to do signal processing. It can be set to use one up to all
- processors.
+
+ Show Audio/MIDI Setup window Shows the
+ Audio/MIDI Setup dialog.
-
-
-
- Memory Usage
-
-
- Waveform image cache (megabytes): sets the maximum amount of ram that
- can be used to store the images representing the waveforms in the editor. Past
- this amount, the images will be regenerated when needed, which can significantly
- decrease the system's performance.
-
-
-
-
- Engine
-
Try to auto-launch audio/midi engine allows Ardour to try to
automatically launch the audio and MIDI system, driver and device, thus not
- showing the Audio/MIDI Setup dialog. This
+ showing the Audio/MIDI Setup dialog. This
can save a little time if the system is always used the same way.
- Automation
+ Editor Undo defines the behaviour of the Undo operations:
- Thinning factor ranges from 0 to 1000 with larger
- values sending fewer automation changes. Thinning is like lossy
- audio compression, removing data that is less likely to be noticed,
- although the more is removed, the more likely the loss will be noticed.
- The advantage to thinning is reduced CPU usage.
-
+ Limit undo history sets how many commands can be
+ undone using Z or Edit > Undo.
+ Unchecking will keep an endless memory of operations to undo, at the
+ expense of memory.
+
- Automation sampling interval ranges from 1 to
- 1000 ms. Determines how frequently the automation input is
- sampled. The shorter the interval the higher the accuracy but also
- the higher the CPU requirements.
+ Save undo history sets how many commands are saved so
+ they are available to be undone after reopening the session. This can
+ also be unchecked to keep all actions undoable, at the cost of bigger
+ session files.
+
+
+ Verify removal of last capture when enabled prompts to
+ verify removal the last recording capture when
+ Edit > Remove Last Capture is executed.
- Tempo
+ Session Management:
- Allow non quarter-note pulse: by default, Ardour understands the tempo as the number of quarter notes in a minute.
- Checking this option allows to set the tempo based on any division of the note,
- from whole to 1/128th. This is reflected in the Edit
- Tempo window (accessed by double clicking a tempo marker) that shows a
- "Pulse" menu when this option is checked.
+ Make periodic backups of the session file will create
+ a backup session file after changes to the timeline. The backup file is
+ the session name followed by .ardour.bak. The backup can be
+ used to recover from crashes when the session had not been explicitly
+ saved.
+
+
+ Default folder for new sessions: defaults the folder
+ where Ardour will create new session folders. This is used in the
+ Session Setup dialog displayed by
+ Session > New.
+
+
+ Maximum number of recent sessions: determines how
+ many of the last opened sessions shows in the Recent Sessions
+ dialog displayed by Session > Recent.
+
+ Import:
+
+
+ Drag and drop import always copies files to session
+ selects, and then disables changes to, the Copy files to session
+ option in the Add Existing Media dialog.
+
+
+
+
+ Export
+
+
+ Save loudness analysis as image file after export allows, when the
+ Analyze Exported Audio is checked in the
+ Export dialog, to save the analysis graph
+ as a file named session.png alongside the exported audio
+ file(s) (in the same folder).
+
+
+ Save Mixer screenshot after export creates and exports
+ a graphical image of the Mixer window as a file named
+ session-mixer.png alongside the exported audio file(s)
+ (in the same folder).
+
+
+
+
+
+
Appearance
+
+
GUI Lock
@@ -115,65 +168,406 @@
-
-
-
Session
+
+ Theme
+
+
+ Draw "flat" buttons: when enabled, button controls
+ in the user interface will be drawn with a flat look. When disabled button
+ controls will have a slight 3D appearance.
+
+
+ Draw "boxy" buttons: when enabled, button controls
+ in the user interface will have square corners instead of being slightly
+ rounded.
+
+
+ LED meter style if checked, the bar meters in the editor and
+ mixer will be styled to look like if they were made of LEDs, with a dotted
+ bar. Unchecking this option makes the bars flat and continuous.
+
+
+ Icon Set: Changes the mouse cursor icons used to indicate
+ different tool modes in the editor. An example would be the icons used to
+ indicate whether the cursor will select a region or change the length of a
+ region.
+
+
+
+
+ Graphical User Interface
+
+
+ Highlight widgets on mouseover, when checked, makes Ardour's
+ widgets (buttons, sliders, …) slightly change color when the mouse
+ hovers them, visually indicating what a mouse action would interact with.
+
+
+ Show tooltips if mouse hovers over a control when checked,
+ displays a little help bubble about the control the mouse hovers. The mouse
+ pointer needs to stay idle for about 1 sec for the tooltip to appear.
+
+
+ Update clocks at TC Frame rate: Ardour updates its clocks every
+ 100 ms. Checking this will make the clock refresh at every TimeCode
+ frame which is more responsive, at the cost of a bit more system stress.
+
+
+ Blink Rec-Arm buttons: when enabled, the record-armed
+ buttons on tracks will blink when they are armed but not currently recording.
+ When disabled, the record-armed buttons on tracks will be outlined in red
+ instead of blinking. The global record-arm button in the
+ Transport bar is unaffected.
+
+
+ Blink Alert indicators: when enabled, the Alert indicators (like
+ the Error Log or the Feedback
+ button) will blink when they are active (when an error or feedback
+ has been detected, respectively). When disabled, the indicators will turn red instead of
+ blinking.
+
+
+
+
+ Graphics Acceleration
+
+
+ Disable Graphics Hardware Acceleration (requires restart)
+ Ardour uses hardware accelerated UI rendering by default for speed.
+ Sometimes though, a buggy driver can cause this to make the system slow or
+ unstable. Checking this will make Ardour draw its UI without
+ hardware acceleration, in software, improving stability and responsiveness
+ on those buggy systems at the expense of speed.
+
+
+ Possibly improve slow graphical performance (requires restart)
+ Wherever gradients appear in the UI, Ardour uses hardware accelerated
+ gradients creation. Checking this will make Ardour draw its own gradients without
+ hardware acceleration for stability on systems with buggy drivers.
+
+
+
+
+
+
Recorder
- Undo defines the behaviour of the Undo operations:
+ Input Meter Layout
- Limit undo history sets how many commands can be
- undone using Z or Edit > Undo.
- Unchecking will keep an endless memory of operations to undo, at the
- expense of memory.
+ Input Meter Layout:In Recorder mode, determines if audio
+ inputs are displayed horizontally or vertically.
+
+
+
+
+
+
Editor
+
+
+
+ General
+
+
+ Use name highlight bars in region displays (requires a restart):
+ when enabled, the region name is displayed, in the editor, in its own opaque bar
+ at the bottom of the region. When disabled, the region name is overlaid
+ at the top of the region, possibly over audio waveforms or MIDI notes.
- Save undo history sets how many commands are saved so
- they are available to be undone after reopening the session. This can
- also be unchecked to keep all actions undoable, at the cost of bigger
- session files.
+ Region color follows track color: when enabled,
+ the background color of regions in the editor will be displayed using
+ the color assigned to the track. When disabled the default region
+ background color will be used.
- Verify removal of last capture when enabled prompts to
- verify removal the last recording capture when
- Edit > Remove Last Capture is executed.
+ Show Region Names: when enabled, overlays the name of
+ the region over its waveform representation, in the top-left.
+
+
+ Waveforms color gradient depth: determines how much gradient
+ effect is applied to the inner of audio waveforms displayed in the editor.
+ Values range from 0.0, no gradient effect, to 1.0, maximum effect.
+
+
+ Timeline item gradient depth: Determines how much
+ gradient effect is applied to the backgrounds of regions displayed in the
+ editor. Values range from 0.0, no gradient effect, to 1.0, maximum effect.
+
+
+ Track name ellipsis mode: when the track header is not
+ wide enough to display the track's name in full, selects how the
+ name will be shorten between:
+
+
Ellipsize start of name will show only the end of the name
+
Ellipsize middle of name will show only the start and end of the name
+
Ellipsize end of name will show only the start of the name
+
+
+
+ Add a visual gap below Audio Regions: selects whether or
+ not the audio regions fit the height of the track or leave a gap at
+ the bottom, either small or large.
- Session Management:
+ Waveforms
- Make periodic backups of the session file will create
- a backup session file after changes to the timeline. The backup file is
- the session name followed by .ardour.bak. The backup can be
- used to recover from crashes when the session had not been explicitly
- saved.
+ Show waveforms in regions when enabled shows a visual
+ representation of the region's audio waveform.
- Drag and drop import always copies files to session
- selects, and then disables changes to, the Copy files to session
- option in the Add Existing Media dialog.
+ Show waveform while recording when
+ enabled, will draw the audio waveform in regions being recorded, in near
+ real time. When disabled, only a region block will be drawn while recording,
+ reducing CPU requirements.
- Default folder for new sessions: defaults the folder
- where Ardour will create new session folders. This is used in the
- Session Setup dialog displayed by
- Session > New.
+ Show waveform clipping: when enabled the waveform
+ displayed will show peaks marked in red if they exceed the clip level.
- Maximum number of recent sessions: determines how many
- of the last opened sessions shows in the
- Recent Sessions dialog displayed by
- Session > Recent.
+ Waveform Clip Level (dBFS): sets the level at which the
+ waveform shown in an audio region will be drawn in red to indicate
+ clipping. Setting lower than 0.0 dBFS can be useful if any tool in
+ the audio chain has problems near 0.0 dBFS.
+
+
+ Waveform scale: when waveforms are shown in audio regions,
+ they can be displayed using a linear or a logarithmic
+ scale. See Waveform display.
+
+
+ Waveform shape: when waveforms are shown in audio regions,
+ they can be displayed using a traditional or a rectified
+ shape. See Waveform display.
+
+
+
+
+ Editor Meters
+
+
+ Show meters in track headers, when enabled, shows
+ a small meter in the Editor's track headers.
+ The meter is shown on the right side area of the header and provides an
+ instant, if unprecise, view of the levels on this track/bus.
+
+
+ Limit track header meters to stereo: if a track has more than
+ two outputs (e.g. with a drum plugin), limits the number of meters in the
+ track header to the first two ones. Only affects audio meters, not MIDI.
+
+
+
+
+ MIDI Regions
+
+
+ Display first MIDI bank/program as 0: when patches and bank changes
+ are displayed in the editor, if this option is checked, the numbering will
+ be zero-based instead of one-based, i.e. banks/programs will be numbered
+ O, 1 ,2… instead of 1, 2, 3…
+
+
+ Don't display periodic (MTC, MMC) SysEx messages in MIDI Regions:
+ if checked, will hide these control messages from the MIDI regions for better
+ legibility.
+
+
+ Show velocity horizontally inside notes: when on, each note
+ of a MIDI region (in Sustained mode) displays its velocity
+ (0-127) with a darker fill proportional to its value.
+
+
+ Use colors to show note velocity: if checked, makes the
+ saturation of the notes color proportional to its velocity, hence making
+ a more veloce note more intense in color.
+
+
Mixer
+
+
+
+ Mixer Strip
+
+
+ This table enables (checked) or disables (unchecked) the display of controls
+ in the mixer strip. Controls whose
+ display can be toggled are:
+ Input, Phase Invert,
+ Record & Monitor, Solo Iso/Lock,
+ Output, Comments and VCA Assigns.
+
+
+ Use narrow strips in the mixer for new strips by default When
+ enabled, new mixer strips are created in narrow format. When disabled,
+ they are created in wide format. Existing mixer strips width can be toggled
+ with the width control at the top left of the mixer strip.
+
+
+ Limit inline-mixer-strip controls per plugin : Whether or
+ not, and how many, controls each plugin can show in the mixer strip.
+ These mixer-strip controls are added by checking plugin context-menu
+ > Controls > □ control parameter.
+
+
+
+
+
+
Toolbar
+
+
+
+ Main Transport Toolbar Items: this section allows to toggle the
+ visibility of some elements of the main toolbar:
+
+
+ Display Record/Punch Options toggles the visibility of the
+ punch and record slice of
+ the main toolbar.
+
+
+ Display Latency Compensation Info toggles the visibility of the
+ Latency Compensation slice of the main toolbar.
+
+
+ Display Secondary Clock toggles the visibility of the
+ secondary clocks slice of
+ the main toolbar.
+
+
+ Display Selection Clock toggles the visibility of the
+ selection clocks slice of
+ the main toolbar.
+
+
+ Display Monitor Section Info toggles the visibility of the
+ Monitor Info slice of the main toolbar.
+
+
+ Display Navigation Timeline toggles the visibility of the
+ navigation/mini timeline slice of
+ the main toolbar.
+
+
+ Display Master Level Meter toggles the visibility of the
+ selection clocks slice of
+ the main toolbar.
+
+
+
+
+ Display Action-Buttons
+
+
+ Column n enables or disables the visibility
+ of the six possible columns of Lua script buttons.
+ Each columns contains two user-assignable buttons.
+
+
+
+
+
+
Size and Scale
+
+
+
+ User Interface Size and Scale
+
+
+ GUI and Font scaling: allows the display size of most of the
+ text and buttons in the user interface to be scaled up or down. May
+ require a restart to take effect.
+
+
+
+
+
+
Colors
+
+
+
+ Colors
+
+
+ Color Theme allows to switch between some presets bundled with
+ Ardour, changing both the palette and items colors, hence styling Ardour
+ all at once.
+
+
+ The table allows to change the color settings in Ardour by acting on three
+ parameters:
+
+
+ Items that allow to choose any color from the palette (see below)
+ to color a UI element. Clicking on a color sample in the Color
+ column bring up the Palette, to choose from.
+
+
+ Palette that allows to create a set of colors that will be used
+ in the UI. Using a palette allows for better consistency, instead of
+ picking "free" colors for each UI element. Clicking on a color patch brings
+ up a full color selector, to assign this color to this patch of the palette.
+
+
+ Transparency where possible, allows to select, with a slider,
+ the transparency of the UI element, with 0 (slider to the left) being
+ fully opaque.
+
+
+
+
+ Restore Defaults turns all the palette, item colors and transparency
+ back to Ardour's default base setting, in case Ardour's appearance has turned
+ into a toddler's toy.
+
+
+
+
+
+
Quirks
+
+
+
+ Various Workarounds for Windowing Systems: As Ardour is available
+ on a number of platforms and windowing systems, some specific workarounds are
+ sometimes required to provide a smooth experience to the user.
+
+
+ Use visibility information provided by your Window Manager/Desktop
+ allows the system window manager's rules for the windows visibility to
+ supersede Ardour's.
+
+
+ All floating windows are dialogs: when enabled, Ardour will
+ use type "Dialog" for all floating windows instead of using type
+ "Utility" for some of them. This may help usability with some
+ window managers. This setting requires a restart of Ardour to take effect.
+
+
+ Transient windows follow front window.: when enabled,
+ transient windows will follow the front window when toggling between the
+ editor and mixer. This setting requires a restart of Ardour to take effect.
+
+
+ Float detached monitor-section window: as the
+ monitor section can be detached from the mixer, this option makes it a
+ floating window, which may be handled differently by the windowing system
+ and easier to access.
+
+
+
+
+
+
Translation
-
Translation
Internationalization
@@ -186,28 +580,33 @@
-
-
+
+
Editor
+
- General
-
+ Region Information
+
+
+ Show xrun markers in regions puts a marker on the region(s)
+ while recording, when a buffer over/underflow happens.
+
- Prompt for new marker names when enabled, popup a dialog
- when a new marker is created. This allows
- markers to be named as they are created.
-
+ Show cue markers in regions determines if cue markers,
+ that are bounded to regions, are displayed or not.
+
- Auto-scroll speed when dragging playhead: chooses how fast the canvas
- scrolls when dragging the playhead outside of the visible canvas.
-
-
- Limit zooming & summary view to X minutes beyond session extents:
- prevents the zoom out both in the editor and the summary, to show anything past
- the chosen time after the end marker, restraining the vision to only useful
- content.
+ Show gain envelopes in audio regions: sets in which
+ modes the gain envelope is displayed in audio regions.
+ The gain envelope is superimposed over the region in the selected modes, and
+ hidden otherwise for a better legibility.
+
+
+
+ Scroll and Zoom Behaviors
+
Zoom to mouse position when zooming with scroll wheel: by default,
Ardour zooms to the edit point. When this
@@ -237,24 +636,23 @@
Auto-scroll editor window when dragging near its edges
when enabled will scroll the editor window automatically when dragging a
region. This can make it easier to see where to position the region.
+
+
+ Auto-scroll speed when dragging playhead: chooses how fast the canvas
+ scrolls when dragging the playhead outside of the visible canvas.
- Show gain envelopes in audio regions: sets in which
- modes the gain envelope is displayed in audio regions.
- The gain envelope is superimposed over the region in the selected modes, and
- hidden otherwise for a better legibility.
-
-
- Show xrun markers in regions puts a marker on the region(s)
- while recording, when a buffer over/underflow happens.
+ Limit zooming & summary view to X minutes beyond session extents:
+ prevents the zoom out both in the editor and the summary, to show anything past
+ the chosen time after the end marker, restraining the vision to only useful
+ content.
-
- Editor Behavior
-
-
+ Editor Behaviour
+
+
Move relevant automation when audio regions are moved,
when enabled, causes automation data to stay with a region when the
region is moved inside the playlist. When disabled, the automation is
@@ -266,6 +664,12 @@
using the Y-position as the value, hence creating a new automation point at
its present value.
+
+ Automation edit cancels auto hide determines wether automation
+ lanes that have been automatically shown because of the
+ Edit > Show Automation Lane on Touch
+ option should be kept visible if the automation has been touched.
+
Default fade shape: sets which
fade shape is the default.
@@ -282,7 +686,6 @@
-
Split/Separate
@@ -317,7 +720,64 @@
-
Modifiers
+
Snap
+
+
+
+ General Snap options:
+
+
+ Snap Threshold (pixels): is the maximum distance between
+ a snap anchor and an object for Ardour to force the object to be
+ placed precisely at that anchor.
+
+
+ Approximate Grid/Ruler granularity (pixels): Ardour tries
+ to show a reasonable number of grid lines at the current zoom level
+ and in the available screen estate. This value tells Ardour what the
+ approximate absolute distance between two closest grid lines should
+ be, so that it displays the most relevant grid scale to approximately
+ fit this distance.
+
+
+ Show "snapped cursor" If the Edit point is not the playhead,
+ shows the currently selected Edit point as a blue line, to indicate
+ where the next editing operation will occur.
+
+
+ Snap rubberband selection to grid makes the highlighted
+ zone created by an area selection also snap to grid, i.e. the beginning
+ and end of the resulting selecting box will both be grid anchors.
+
+
+ Grid switches to alternate selection for Internal Edit Tools
+ Two levels of grid mode can coexist in Ardour, one for global regions
+ manipulations, and one for finer, in-region editing (e.g. for placing
+ MIDI events in a MIDI region). When this option is checked, entering
+ Internal Edit mode makes the grid mode switch from one mode to the other.
+
+
+ Rulers automatically change to follow the Grid mode selection
+ If enabled, changing the Grid mode also makes the relevant
+ ruler visible, while hiding the other ones.
+
+
+
+
+ When "Snap" is enabled, snap to:
+ Lists the different possible anchors to which an object should snap to, among:
+
+
Markers
+
Region Sync points
+
Region Starts
+
Region Ends
+
Grid
+
+
+
+
+
Modifiers
+
This page allows to choose how things are done in the editor. This is a very
flexible way for Ardour to match an existing workflow, or speed up the editing
@@ -327,10 +787,522 @@
The Reset to recommended defaults button at the bottom
provides a way to revert any user made change to its default value.
-
-
Mixer
+
+
MIDI
+
+ Session
+
+
+ Allow non quarter-note pulse: by default, Ardour understands the tempo as the number of quarter notes in a minute.
+ Checking this option allows to set the tempo based on any division of the note,
+ from whole to 1/128th. This is reflected in the Edit
+ Tempo window (accessed by double clicking a tempo marker) that shows a
+ "Pulse" menu when this option is checked.
+
+
+ Initial program change: Ardour will send a MIDI program
+ change message on the ardour:MMC out MIDI port when a session
+ is loaded and whenever this field is changed. A value of -1 means don't
+ send any program change message.
+
+
+
+
+ Audition
+
+
+ Sound MIDI notes as they are selected in the editor will play
+ any selected or added MIDI note when in Draw or Internal Edit modes. The
+ note is sent as MIDI as if Ardour was playing it withe the session, so the
+ processors and signal routing will be applied.
+
+
+
+
+ Virtual Keyboard
+
+
+ Virtual Keyboard Layout: selects which (if any) computer
+ keyboard layout is used to be mapped on the keys of the musical
+ keyboard of the Virtual Keyboard (Window > Virtual Keyboard).
+
+
+
+
+
+ MIDI Port Options
+
+
+ MIDI input follows MIDI track selection allows Ardour to automatically
+ connect the MIDI input to the selected track. Selecting a different MIDI
+ track results in Ardour disconnecting the MIDI device from the former track
+ and connecting it to the newly selected one, so that the MIDI device is
+ always connected to the selected track. Which MIDI device will follow
+ selection can be chosen below.
+
+
+
+
+
+
Transport
+
+
+
+ General
+
+
+ Prompt for new marker names when enabled, popup a dialog
+ when a new marker is created. This allows
+ markers to be named as they are created.
+
+
+ Stop at the end of the session causes the transport to
+ stop during playback when it reaches the end marker. Behavior during
+ recording is not changed.
+
+
+ Keep record-enable engaged on stop leaves the global
+ record-enable engaged after transport is stopped. Does not affect track
+ level record-enable which is never changed on stop.
+
+
+ Reset default speed on stop when the
+ Shuttle speed control is in wheel
+ mode, i.e. the transport speed can be constantly changed, enabling this
+ option makes these changes temporary, and the transport speed reset
+ each time the transport is stopped.
+
+
+ Disable per-track record disarm while rolling, when
+ enabled, will not allow the any track's record-enable to be disarmed
+ during record, preventing accidentally stopping the recording of a take.
+
+
+ 12dB gain reduction during fast-forward and fast-rewind
+ when enabled will reduce the unpleasant increase in perceived volume
+ that occurs when fast-forwarding or rewinding through some kinds of audio.
+
+
+ Rewind/Fast-forward buttons change direction immediately
+ sets wether Rewind and Fast-forward transport operations
+ (Transport > Forward/Rewind) changes the
+ playback direction and speed abruptly, or gradually.
+
+
+ Allow auto-return after rewind/ffwd operations
+ if Auto returnis engaged, sets wether
+ it applies to rewind and fast-forward operations.
+
+
+ Preroll: sets the duration of the preroll for playing and
+ recording when using a preroll. Can be a musical duration (in bars) or a
+ duration in seconds.
+
+
+
+
+ Looping
+
+
+ Play loop is a transport mode changes the behavior of the
+ loop button, turning it into a toggle. When enabled, the loop button does
+ not start playback but forces playback to always play the loop. Looping
+ stays engaged when the transport is stopped. Playback continues where the
+ transport stopped and continues to loop. When disabled, the loop button
+ starts playing the loop but stop then cancels loop playback.
+
+
+ Loop Fades: when the transport moves from the end of the loop
+ range back to the beginning, clicks might be audible. This parameter
+ allows for adding fades (in, out or cross-) to prevent those clicks.
+
+
+
+
+ Dropout (xrun) Handling
+
+
+ Stop recording when an xrun occurs will stop the transport
+ when an xrun occurs during recording, ensuring no audible glitches are
+ recorded.
+
+
+ Create markers where xruns occur will create a new
+ marker when an xrun occurs during
+ recording at the location of the xrun. This marks where possible xruns
+ might produce audible glitches.
+
+
+ Reset x-runs counter when starting to record, when enabled,
+ sets the x-run counter in the Status bar
+ to 0 each time a recording is started, hence showing only the relevant
+ number of x-run while recording.
+
+
+
+
+ Plugins
+
+
+ Silence plugins when the transport is stopped when stopping
+ playback or recording, if this option is checked, the plugins that still
+ emit sound (reverbs, etc…) will be stopped. If unchecked, the plugins
+ will continue playing after the transport stop.
+
+
+
+
+
+
Chase
+
+
+
+ MIDI Machine Control (MMC)
+
+
+ Respond to MMC commands when enabled Ardour will respond
+ to MIDI Machine Control commands received on the ardour:MMC in
+ MIDI port.
+
+
+ Inbound MMC device ID: is the only device ID Ardour will
+ respond to when an MMC command is received on the ardour:MMC in
+ MIDI port.
+
+
+
+
+ Transport Masters
+
+
+ Show Transport Master Window Opens the Transport masters
+ window, where all the timecode sources are shown to be selected
+ and/or synchronized; same as clicking Window >
+ Transport Masters
+
+
+ Match session video frame rate to external timecode
+ controls the value of the video frame rate while chasing
+ an external timecode source. When enabled, the session video frame rate will be
+ changed to match that of the selected external timecode source. When disabled,
+ the session video frame rate will not be changed to match that of the selected
+ external timecode source. Instead, the frame rate indication in the main clock
+ will flash red and Ardour will convert between the external timecode standard
+ and the session standard.
+
+
+
+
+
+
Generate
+
+
+
+ Linear Timecode (LTC) Generator
+
+
+ Enable LTC generator when enabled Ardour will
+ output an LTC timecode signal on its LTC-out port.
+ If this option is checked, the two options below are active:
+
+
+ Send LTC while stopped, (only available when the previous
+ Enable LTC generator is on) when enabled Ardour will
+ continue to send LTC information even while the transport (playhead)
+ is not moving.
+
+
+ LTC generator level [dBFS]: specifies the peak volume of
+ the generated LTC signal in dbFS. A good value is 0dBu=−18dbFS
+ in an EBU calibrated system.
+
+
+ LTC Output Port: selects to which port (if any) the
+ LTC generator will be connected by default.
+
+
+
+
+ MIDI Time Code (MTC) Generator
+
+
+ Enable MTC Generator when enabled Ardour will generate MIDI
+ time code on the ardour:MTC out MIDI port.
+
+
+ Max MTC varispeed (%):
+ MIDI time code generation will be disabled when the transport speed is
+ greater than normal speed plus this percentage or less than normal minus
+ this percentage.
+
+
+
+
+ MIDI Machine Control (MMC)
+
+
+ Send MMC commands when enabled Ardour will send MIDI Machine
+ Control commands on the ardour:MMC out
+ MIDI port.
+
+
+ Outbound MMC device ID: is the MIDI device ID Ardour will
+ use when it sends MMC commands.
+
+
+
+
+ MIDI Beat Clock (Mclk) Generator
+
+
+ Enable Mclk generator when enabled Ardour will generate a
+ (tempo dependant) beat clock at a rate of 24 pulses per quarter note on
+ the ardour:MIDI clock out port.
+
+
+
+
+
+
Plugins
+
+
+ The content of this preference page varies heavily between versions or Ardour:
+ both the platform and the build-time options can make Ardour support some types
+ of plugins and not others. While this documentation tries to show all possible
+ options, most systems will only show a subset of the options hereunder, e.g.
+ AudioUnits are macOS only…
+
+
+
+
+ Scan/Discover
+
+
+ Scan for Plugins will initiate an immediate scan of the system
+ for available plugins. Useful to get a newly installed plugin recognised
+ by Ardour.
+
+
+
+
+ General
+
+
+ Always Display Plugin Scan Progress When enabled a
+ popup window showing plugin scan progress is displayed for indexing
+ (cache load) and discovery (detect new plugins).
+
+
+ Make new plugins active when enabled, any plugin added to a track
+ will be in active mode. If unchecked, the plugins will be added in inactive
+ mode by default, hence have no processing effect on the track/bus.
+
+
+
+
+ LV1/LV2
+
+
+ Conceal LADSPA (LV1) Plugins if matching LV2 exists When
+ enabled, gives precedence to the LV2 (more up-to-date) version of
+ a plugin over its LV1 version, if both exists.
+
+
+
+
+ Plugin GUI
+
+
+ Automatically open the plugin GUI when adding a new plugin
+ shows the plugins GUI as soon as it is added to the processing box. If
+ unchecked, the plugin will be added in the processor box but the GUI will
+ only be shown when double clicking it.
+
+
+ Show Plugin Inline Display on Mixer strip by default allows Ardour
+ to show, in the mixer strips, a
+ visual rendering of the effect. These Inline Display are a special feature
+ of Ardour, so not all plugins are able to show this display. Most of Ardour's
+ own plugins have an Inline Display.
+ At any time, the plugin's Inline Display can be toggled on or off by
+ double-clicking it.
+
+
+ Don't automatically open the plugin GUI when the plugin has an inline
+ display mode: this option, available only if
+ Automatically open the plugin GUI when adding a new plugin
+ is checked, supercedes it and hides the plugin GUI at creation if it has an
+ Inline Display, like Ardour's own ACE * plugins.
+
+
+
+
+ Instrument
+
+
+ Ask to replace existing instrument plugin: if a MIDI track already
+ has an instrument (i.e. MIDI to audio converter of some sort) and this
+ option is checked, Ardour will detect it and offer to replace the existing
+ instrument with the newly added one, avoiding a possible conflict.
+
+
+ Interactively configure instrument plugins on insert: when inserting
+ a multichannel instrument plugin, if this option is checked, prompts the
+ user for the channel configuration for this plugin.
+
+
+
+
+ Statistics
+
+
+ Reset Statistics: clears the statistics used to determine
+ the most used and most recently used plugins.
+
+
+ Plugin chart (use-count) length: In the Mixer view's
+ favorite plugins section,
+ determines how many plugins are displayed when in Top-10 Plugins
+ mode.
+
+
+ Plugin recent list length: Same as above,
+ when in Recent Plugins mode.
+
+
+
+
+
+
VST
+
+
+
+ VST
+
+
+ Enable Mac VST support (requires restart or re-scan) makes a
+ MacOs system able to run VST-Mac plugins. As stated, a new scan for plugins
+ is required, be it manually or by restarting Ardour.
+
+
+ Scan for [new] VST Plugins on Application Start When
+ enabled new VST plugins are searched, tested and added to the cache
+ index on application start. When disabled new plugins will only be
+ available after triggering a 'Scan' manually.
+
+
+ Verbose Plugin Scan: adds information about the plugin in the
+ Log window.
+
+
+ Scan Time Out Specifies the default timeout for plugin
+ instantiation. Plugins that require more time to load will be
+ blacklisted. A value of ∞ disables the timeout.
+
+
+
+
+ VST 2.x
+
+
+ VST 2 Cache: Clicking the Clear button
+ removes all VST plugins from the list of plugins available to be
+ inserted into the processor box. A new VST plugin scan is then required.
+
+
+ VST 2 Blacklist: Clicking the Clear
+ button makes blacklisted VST plugins available to be added to the processor
+ box.
+
+
+ Linux VST2 Path: Clicking the Edit button
+ pops up a dialog to manage the directories that will be searched for Linux
+ VST plugins. When modified, Ardour will offer to scan those paths for plugins.
+
+
+ Path: are the paths chosen above.
+
+
+ Windows VST Path: Clicking the Edit button
+ pops up a dialog to manage the directories that will be searched for Windows
+ VST plugins. When modified, Ardour will offer to scan those paths for plugins.
+
+
+ Path: are the paths chosen above.
+
+
+
+
+ VST 3
+
+
+ VST 3 Cache: Same as above, for VST 3
+
+
+ VST 3 Blacklist: Same as above, for VST 3
+
+
+ Additional VST3 Path: The VST 3 specs clearly define where
+ the host application should look for plugins. Although Ardour provides a
+ way to search other directories for plugin, it is out of spec and not
+ recommanded.
+
+
+ Conceal VST2 Plugin if matching LV3 exists When
+ enabled, gives precedence to the VST3 (more up-to-date) version of
+ a plugin over its VST2 version, if both exists.
+
+
+
+
+
+
Audio Unit
+
+
+
+ Audio Unit
+
+
+ Scan for [new] AudioUnit Plugins on Application Start When
+ enabled, new AU plugins are searched, tested and added to the cache
+ index on application start. When disabled, new plugins will only be
+ available after triggering a 'Scan' manually.
+
+
+ AU Cache: Clicking the Clear button
+ removes all AU plugins from the list of plugins available to be
+ inserted into the processor box. A new AU plugins scan is then required.
+
+
+ AU Blacklist: Clicking the Clear
+ button makes blacklisted AU plugins available to be added to the processor
+ box.
+
+
+
+
+
+
Monitoring
+
+
+
+ Monitoring
+
+
+ Record monitoring handled by: determines whether Ardour provides
+ monitoring of incoming audio or whether monitoring is provided by hardware.
+ See Monitoring for more information.
+
+
+ Auto Input does 'Talkback' when enabled, the
+ Transport > Auto Input option also sets
+ the tracks to monitor its audio input when transport is not rolling.
+
+
+
Solo contains settings that affect the use of
solo, muting, and
@@ -381,7 +1353,11 @@
+
+
Signal Flow
+
+
Master
@@ -393,7 +1369,6 @@
-
Default Track / Bus Muting Options sets the muting options
for a newly created tracks or bus. The mute options for an existing track
@@ -417,7 +1392,6 @@
- Record monitoring handled by: determines whether Ardour provides
- monitoring of incoming audio or whether monitoring is provided by hardware.
- See Monitoring for more information.
+
+ Replicate missing region channels: if a track is N-channel,
+ and the region has fewer channels, this option copies the existing
+ channel's data for this non-existent one. If left unchecked, the missing
+ channels will stay silent.
-
- Auto Input does 'Talkback' when enabled, the
- Transport > Auto Input option also sets
- the tracks to monitor its audio input when transport is not rolling.
-
-
+
-
Track and Bus Connections
@@ -483,124 +1446,6 @@
-
Audio
-
-
-
- Buffering settings determine how many seconds of audio off of disk
- will be buffered in memory. Longer settings reduce the risk of buffer
- under-runs but consume more memory.
-
-
- Preset: will automatically choose the values for the playback
- and recording buffer based on the chosen size of the session. The
- Custom option allows to manually select the buffers with
- the two sliders below.
-
-
- Playback (seconds of buffering): sets how many seconds of
- audio Ardour will buffer during playback.
-
-
- Recording (seconds of buffering): sets how many seconds of
- audio Ardour will buffer during recording.
-
-
-
-
-
- Denormals are a specific type of very small numbers that
- can cause issues with CPU consumption when using some plugins in some
- circumstances.
- Ardour provides two methods of handling the issue. Trying different
- combinations of these settings may minimize CPU consumption.
-
-
- Use DC bias to protect against denormals adds a small
- constant value to numbers to move the numbers away from zero.
-
-
- Processor handling:, if the computer's hardware
- supports it, offers two methods that can be used individually or
- combined. Flush to zero and denormals are zero.
-
-
-
-
-
- Regions
-
-
- Enable automatic analysis of audio generates the transient
- values (used in e.g. the Rhythm Ferret)
- automatically. When unchecked, the transient values will be generated
- on demand.
-
-
- Replicate missing region channels: if a track is N-channel,
- and the region has fewer channels, this option copies the existing
- channel's data for this non-existent one. If left unchecked, the missing
- channels will stay silent.
-
-
-
-
-
-
MIDI
-
-
-
- Session
-
-
- Initial program change: Ardour will send a MIDI program
- change message on the ardour:MMC out MIDI port when a session
- is loaded and whenever this field is changed. A value of -1 means don't
- send any program change message.
-
-
-
-
-
- Audition
-
-
- Sound MIDI notes as they are selected in the editor will play
- any selected or added MIDI note when in Draw or Internal Edit modes. The
- note is sent as MIDI as if Ardour was playing it withe the session, so the
- processors and signal routing will be applied.
-
-
-
-
-
-
- Virtual Keyboard
-
-
- Virtual Keyboard Layout: selects which (if any) computer
- keyboard layout is used to be mapped on the keys of the musical
- keyboard of the Virtual Keyboard (Window > Virtual Keyboard).
-
-
-
-
-
-
- MIDI Port Options
-
-
- MIDI input follows MIDI track selection allows Ardour to automatically
- connect the MIDI input to the selected track. Selecting a different MIDI
- track results in Ardour disconnecting the MIDI device from the former track
- and connecting it to the newly selected one, so that the MIDI device is
- always connected to the selected track. Which MIDI device will follow
- selection can be chosen below.
-
+ It lists all the Control Surface protocols Ardour knows. To enable a
+ Control Surface Protocol, the Enable checkbox
+ next to its name should be ticked. Editing the settings related to this protocol
+ can be done by double-clicking its name or clicking the Show
+ protocol settings (only for Generic MIDI and Open Sound Control).
+
+
Metering
@@ -685,7 +1543,6 @@
-
Default Meter Types sets the default meters when creating a session
or track. These meters can be changed afterwards by
@@ -706,280 +1563,103 @@
-
- Post Export Analysis
+ Region Analysis
- Save loudness analysis as image file after export allows, when the
- Analyze Exported Audio is checked in the
- Export dialog, to save the analysis graph
- as a file named session.png alongside the exported audio
- file(s) (in the same folder).
-
-
- Save Mixer screenshot after export creates and exports
- a graphical image of the Mixer window as a file named
- session-mixer.png alongside the exported audio file(s)
- (in the same folder).
-
+ Enable automatic analysis of audio generates the transient
+ values (used in e.g. the Rhythm Ferret)
+ automatically. When unchecked, the transient values will be generated
+ on demand.
+
-
Transport
+
Performance
-
+
- General
+ DSP CPU Utilization
- Stop at the end of the session causes the transport to
- stop during playback when it reaches the end marker. Behavior during
- recording is not changed.
-
-
- Keep record-enable engaged on stop leaves the global
- record-enable engaged after transport is stopped. Does not affect track
- level record-enable which is never changed on stop.
-
-
- Reset default speed on stop when the
- Shuttle speed control is in wheel
- mode, i.e. the transport speed can be constantly changed, enabling this
- option makes these changes temporary, and the transport speed reset
- each time the transport is stopped.
-
-
- Disable per-track record disarm while rolling, when
- enabled, will not allow the any track's record-enable to be disarmed
- during record, preventing accidentally stopping the recording of a take.
-
-
- 12dB gain reduction during fast-forward and fast-rewind
- when enabled will reduce the unpleasant increase in perceived volume
- that occurs when fast-forwarding or rewinding through some kinds of audio.
-
-
- Preroll: sets the duration of the preroll for playing and
- recording when using a preroll. Can be a musical duration (in bars) or a
- duration in seconds.
+ Signal processing uses: sets how many cpu processors can be
+ used to do signal processing. It can be set to use one up to all
+ processors.
-
- Looping
+ CPU/FPU Denormals are a specific type of very small numbers that
+ can cause issues with CPU consumption when using some plugins in some
+ circumstances. Ardour provides two methods of handling the issue.
+ Trying different combinations of these settings may minimize CPU consumption.
- Play loop is a transport mode changes the behavior of the
- loop button, turning it into a toggle. When enabled, the loop button does
- not start playback but forces playback to always play the loop. Looping
- stays engaged when the transport is stopped. Playback continues where the
- transport stopped and continues to loop. When disabled, the loop button
- starts playing the loop but stop then cancels loop playback.
-
-
- Loop Fades: when the transport moves from the end of the loop
- range back to the beginning, clicks might be audible. This parameter
- allows for adding fades (in, out or cross-) to prevent those clicks.
-
-
-
-
-
- Dropout (xrun) Handling
-
-
- Stop recording when an xrun occurs will stop the transport
- when an xrun occurs during recording, ensuring no audible glitches are
- recorded.
-
-
- Create markers where xruns occur will create a new
- marker when an xrun occurs during
- recording at the location of the xrun. This marks where possible xruns
- might produce audible glitches.
-
-
- Reset x-runs counter when starting to record, when enabled,
- sets the x-run counter in the Status bar
- to 0 each time a recording is started, hence showing only the relevant
- number of x-run while recording.
-
-
-
-
-
- Transport Masters
-
- This section defines which time source(s) Ardour should use (LTC, MTC, JACK or MIDI),
- and the options linked to this transport master.
-
-
-
-
- Keep rolling if sync is lost, when checked, forces Ardour to
- keep its transport speed even if a transport master signal is lost.
- Unchecking this option makes Ardour stop transport if it looses the
- signal.
+ Use DC bias to protect against denormals adds a small
+ constant value to numbers to move the numbers away from zero.
- Match session video frame rate to external timecode
- controls the value of the video frame rate while chasing
- an external timecode source. When enabled, the session video frame rate will be
- changed to match that of the selected external timecode source. When disabled,
- the session video frame rate will not be changed to match that of the selected
- external timecode source. Instead, the frame rate indication in the main clock
- will flash red and Ardour will convert between the external timecode standard
- and the session standard.
+ Processor handling:, if the computer's hardware
+ supports it, offers two methods that can be used individually or
+ combined. Flush to zero and denormals are zero.
+
+
+
+
+ Disk I/O Buffering settings determine how many seconds of
+ audio off of disk will be buffered in memory. Longer settings reduce
+ the risk of buffer under-runs but consume more memory.
+
+
+ Preset: will automatically choose the values for the playback
+ and recording buffer based on the chosen size of the session. The
+ Custom option allows to manually select the buffers with
+ the two sliders below.
+
+
+ Playback (seconds of buffering): sets how many seconds of
+ audio Ardour will buffer during playback.
+
+
+ Recording (seconds of buffering): sets how many seconds of
+ audio Ardour will buffer during recording.
+
+
+
+
+ Memory Usage
+
+
+ Waveform image cache (megabytes): sets the maximum amount of ram that
+ can be used to store the images representing the waveforms in the editor. Past
+ this amount, the images will be regenerated when needed, which can significantly
+ decrease the system's performance.
+
+
+
+
+ Automation
+
+
+ Thinning factor ranges from 0 to 1000 with larger
+ values sending fewer automation changes. Thinning is like lossy
+ audio compression, removing data that is less likely to be noticed,
+ although the more is removed, the more likely the loss will be noticed.
+ The advantage to thinning is reduced CPU usage.
-
-
-
-
-
LTC
-
-
-
-
- Linear Timecode (LTC) Generator
-
- Enable LTC generator when enabled Ardour will
- output an LTC timecode signal on its LTC-out port.
- If this option is checked, the two options below are active:
-
-
- Send LTC while stopped, when enabled Ardour will
- continue to send LTC information even while the transport (playhead) is
- not moving.
-
-
- LTC generator level [dBFS]: specifies the peak volume of
- the generated LTC signal in dbFS. A good value is 0dBu=−18dbFS
- in an EBU calibrated system.
-
-
- LTC Output Port: selects to which port (if any) the
- LTC generator will be connected by default.
+ Automation sampling interval ranges from 1 to
+ 1000 ms. Determines how frequently the automation input is
+ sampled. The shorter the interval the higher the accuracy but also
+ the higher the CPU requirements.
-
-
-
MIDI
-
-
- MIDI Beat Clock (Mclk) Generator
+ Automatables
-
- Enable Mclk generator when enabled Ardour will generate a
- (tempo dependant) beat clock at a rate of 24 pulses per quarter note on
- the ardour:MIDI clock out port.
-
-
-
-
-
- MIDI Time Code (MTC) Generator
-
-
- Enable MTC Generator when enabled Ardour will generate MIDI
- time code on the ardour:MTC out MIDI port.
-
-
- Percentage either side of normal transport speed to transmit MTC:
- MIDI time code generation will be disabled when the transport speed is
- greater than normal speed plus this percentage or less than normal minus
- this percentage.
-
-
-
-
-
- MIDI Machine Control (MMC)
-
-
- Respond to MMC commands when enabled Ardour will respond
- to MIDI Machine Control commands received on the ardour:MMC in
- MIDI port.
-
-
- Send MMC commands when enabled Ardour will send MIDI Machine
- Control commands on the ardour:MMC out
- MIDI port.
-
-
- Inbound MMC device ID: is the only device ID Ardour will
- respond to when an MMC command is received on the ardour:MMC in
- MIDI port.
-
-
- Outbound MMC device ID: is the MIDI device ID Ardour will
- use when it sends MMC commands.
-
- It lists all the Control Surface protocols Ardour knows. To enable a
- Control Surface Protocol, the Enable checkbox
- next to its name should be ticked. Editing the settings related to this protocol
- can be done by double-clicking its name or clicking the Show
- protocol settings (only for Generic MIDI and Open Sound Control).
-
-
-
-
Plugins
-
-
- The content of this preference page varies heavily between versions or Ardour:
- both the platform and the build-time options can make Ardour support some types
- of plugins and not others. While this documentation tries to show all possible
- options, most systems will only show a subset of the options hereunder, e.g.
- AudioUnits are macOS only…
-
-
-
-
- Scan/Discover
-
-
- Scan for Plugins will initiate an immediate scan of the system
- for available plugins. Useful to get a newly installed plugin recognised
- by Ardour.
-
-
-
-
-
- General
-
-
- Always Display Plugin Scan Progress When enabled a
- popup window showing plugin scan progress is displayed for indexing
- (cache load) and discovery (detect new plugins).
-
-
- Silence plugins when the transport is stopped when stopping
- playback or recording, if this option is checked, the plugins that still
- emit sound (reverbs, etc…) will be stopped. If unchecked, the plugins
- will continue playing after the transport stop.
-
-
- Make new plugins active when enabled, any plugin added to a track
- will be in active mode. If unchecked, the plugins will be added in inactive
- mode by default, hence have no processing effect on the track/bus.
-
-
+
Limit automatable parameters per plugin: as some plugins
(synthesizers, …) have a lot of parameters, and those parameters
can be automated by Ardour, checking this will limit the number of parameters
@@ -988,580 +1668,6 @@
-
-
- LV1/LV2
-
-
- Conceal LADSPA (LV1) Plugins if matching LV2 exists When
- enabled, gives precedence to the LV2 (more up-to-date) version of
- a plugin over its LV1 version, if both exists.
-
-
-
-
-
- Plugin GUI
-
-
- Automatically open the plugin GUI when adding a new plugin
- shows the plugins GUI as soon as it is added to the processing box. If
- unchecked, the plugin will be added in the processor box but the GUI will
- only be shown when double clicking it.
-
-
- Show Plugin Inline Display on Mixer strip by default allows Ardour
- to show, in the mixer strips, a
- visual rendering of the effect. These Inline Display are a special feature
- of Ardour, so not all plugins are able to show this display. Most of Ardour's
- own plugins have an Inline Display.
- At any time, the plugin's Inline Display can be toggled on or off by
- double-clicking it.
-
-
- Don't automatically open the plugin GUI when the plugin has an inline
- display mode: this option, available only if
- Automatically open the plugin GUI when adding a new plugin
- is checked, supercedes it and hides the plugin GUI at creation if it has an
- Inline Display, like Ardour's own ACE * plugins.
-
-
-
-
-
- Instrument
-
-
- Ask to replace existing instrument plugin: if a MIDI track already
- has an instrument (i.e. MIDI to audio converter of some sort) and this
- option is checked, Ardour will detect it and offer to replace the existing
- instrument with the newly added one, avoiding a possible conflict.
-
-
- Interactively configure instrument plugins on insert: when inserting
- a multichannel instrument plugin, if this option is checked, prompts the
- user for the channel configuration for this plugin.
-
-
-
-
-
- Statistics
-
-
- Reset Statistics: clears the statistics used to determine
- the most used and most recently used plugins.
-
-
- Plugin chart (use-count) length: In the Mixer view's
- favorite plugins section,
- determines how many plugins are displayed when in Top-10 Plugins
- mode.
-
-
- Plugin recent list length: Same as above,
- when in Recent Plugins mode.
-
-
-
-
-
-
VST
-
-
-
- VST
-
-
- Enable Mac VST support (requires restart or re-scan) makes a
- MacOs system able to run VST-Mac plugins. As stated, a new scan for plugins
- is required, be it manually or by restarting Ardour.
-
-
- Scan for [new] VST Plugins on Application Start When
- enabled new VST plugins are searched, tested and added to the cache
- index on application start. When disabled new plugins will only be
- available after triggering a 'Scan' manually.
-
-
- Verbose Plugin Scan: adds information about the plugin in the
- Log window.
-
-
- Scan Time Out Specifies the default timeout for plugin
- instantiation. Plugins that require more time to load will be
- blacklisted. A value of ∞ disables the timeout.
-
-
-
-
-
- VST 2.x
-
-
- VST 2 Cache: Clicking the Clear button
- removes all VST plugins from the list of plugins available to be
- inserted into the processor box. A new VST plugin scan is then required.
-
-
- VST 2 Blacklist: Clicking the Clear
- button makes blacklisted VST plugins available to be added to the processor
- box.
-
-
- Linux VST2 Path: Clicking the Edit button
- pops up a dialog to manage the directories that will be searched for Linux
- VST plugins. When modified, Ardour will offer to scan those paths for plugins.
-
-
- Path: are the paths chosen above.
-
-
- Windows VST Path: Clicking the Edit button
- pops up a dialog to manage the directories that will be searched for Windows
- VST plugins. When modified, Ardour will offer to scan those paths for plugins.
-
-
- Path: are the paths chosen above.
-
-
-
-
-
- VST 3
-
-
- VST 3 Cache: Same as above, for VST 3
-
-
- VST 3 Blacklist: Same as above, for VST 3
-
-
- Additional VST3 Path: The VST 3 specs clearly define where
- the host application should look for plugins. Although Ardour provides a
- way to search other directories for plugin, it is out of spec and not
- recommanded.
-
-
- Conceal VST2 Plugin if matching LV3 exists When
- enabled, gives precedence to the VST3 (more up-to-date) version of
- a plugin over its VST2 version, if both exists.
-
-
-
-
-
-
Audio Unit
-
-
-
- Audio Unit
-
-
- Scan for [new] AudioUnit Plugins on Application Start When
- enabled, new AU plugins are searched, tested and added to the cache
- index on application start. When disabled, new plugins will only be
- available after triggering a 'Scan' manually.
-
-
- AU Cache: Clicking the Clear button
- removes all AU plugins from the list of plugins available to be
- inserted into the processor box. A new AU plugins scan is then required.
-
-
- AU Blacklist: Clicking the Clear
- button makes blacklisted AU plugins available to be added to the processor
- box.
-
-
-
-
-
-
Appearance
-
-
-
- Graphics Acceleration
-
-
- Disable Graphics Hardware Acceleration (requires restart)
- Ardour uses hardware accelerated UI rendering by default for speed.
- Sometimes though, a buggy driver can cause this to make the system slow or
- unstable. Checking this will make Ardour draw its UI without
- hardware acceleration, in software, improving stability and responsiveness
- on those buggy systems at the expense of speed.
-
-
- Possibly improve slow graphical performance (requires restart)
- Wherever gradients appear in the UI, Ardour uses hardware accelerated
- gradients creation. Checking this will make Ardour draw its own gradients without
- hardware acceleration for stability on systems with buggy drivers.
-
-
-
-
-
- Graphical User Interface
-
-
- Highlight widgets on mouseover, when checked, makes Ardour's
- widgets (buttons, sliders, …) slightly change color when the mouse
- hovers them, visually indicating what a mouse action would interact with.
-
-
- Show tooltips if mouse hovers over a control when checked,
- displays a little help bubble about the control the mouse hovers. The mouse
- pointer needs to stay idle for about 1 sec for the tooltip to appear.
-
-
- Update clocks at TC Frame rate: Ardour updates its clocks every
- 100 ms. Checking this will make the clock refresh at every TimeCode
- frame which is more responsive, at the cost of a bit more system stress.
-
-
- Blink Rec-Arm buttons: when enabled, the record-armed
- buttons on tracks will blink when they are armed but not currently recording.
- When disabled, the record-armed buttons on tracks will be outlined in red
- instead of blinking. The global record-arm button in the
- Transport bar is unaffected.
-
-
- Blink Alert indicators: when enabled, the Alert indicators (like
- the Error Log or the Feedback
- button) will blink when they are active (when an error or feedback
- has been detected, respectively). When disabled, the indicators will turn red instead of
- blinking.
-
-
- GUI and Font scaling: allows the display size of most of the
- text and buttons in the user interface to be scaled up or down. May
- require a restart to take effect.
-
-
-
-
-
-
Editor
-
-
-
- General
-
-
- Use name highlight bars in region displays (requires a restart):
- when enabled, the region name is displayed, in the editor, in its own opaque bar
- at the bottom of the region. When disabled, the region name is overlaid
- at the top of the region, possibly over audio waveforms or MIDI notes.
-
-
- Region color follows track color: when enabled,
- the background color of regions in the editor will be displayed using
- the color assigned to the track. When disabled the default region
- background color will be used.
-
-
- Show Region Names: when enabled, overlays the name of
- the region over its waveform representation, in the top-left.
-
-
- Track name ellipsis mode: when the track header is not
- wide enough to display the track's name in full, selects how the
- name will be shorten between:
-
-
Ellipsize start of name will show only the end of the name
-
Ellipsize middle of name will show only the start and end of the name
-
Ellipsize end of name will show only the start of the name
-
-
-
- Add a visual gap below Audio Regions: selects whether or
- not the audio regions fit the height of the track or leave a gap at
- the bottom, either small or large.
-
-
-
-
-
- Waveforms
-
-
- Show waveforms in regions when enabled shows a visual
- representation of the region's audio waveform.
-
-
- Show waveform while recording when
- enabled, will draw the audio waveform in regions being recorded, in near
- real time. When disabled, only a region block will be drawn while recording,
- reducing CPU requirements.
-
-
- Show waveform clipping: when enabled the waveform
- displayed will show peaks marked in red if they exceed the clip level.
-
-
- Waveform Clip Level (dBFS): sets the level at which the
- waveform shown in an audio region will be drawn in red to indicate
- clipping. Setting lower than 0.0 dBFS can be useful if any tool in
- the audio chain has problems near 0.0 dBFS.
-
-
- Waveform scale: when waveforms are shown in audio regions,
- they can be displayed using a linear or a logarithmic
- scale. See Waveform display.
-
-
- Waveform shape: when waveforms are shown in audio regions,
- they can be displayed using a traditional or a rectified
- shape. See Waveform display.
-
-
-
-
-
- Editor Meters
-
-
- Show meters in track headers, when enabled, shows
- a small meter in the Editor's track headers.
- The meter is shown on the right side area of the header and provides an
- instant, if unprecise, view of the levels on this track/bus.
-
-
- Limit track header meters to stereo: if a track has more than
- two outputs (e.g. with a drum plugin), limits the number of meters in the
- track header to the first two ones. Only affects audio meters, not MIDI.
-
-
-
-
-
- MIDI Regions
-
-
- Display first MIDI bank/program as 0: when patches and bank changes
- are displayed in the editor, if this option is checked, the numbering will
- be zero-based instead of one-based, i.e. banks/programs will be numbered
- O, 1 ,2… instead of 1, 2, 3…
-
-
- Don't display periodic (MTC, MMC) SysEx messages in MIDI Regions:
- if checked, will hide these control messages from the MIDI regions for better
- legibility.
-
-
- Show velocity horizontally inside notes: when on, each note
- of a MIDI region (in Sustained mode) displays its velocity
- (0-127) with a darker fill proportional to its value.
-
-
- Use colors to show note velocity: if checked, makes the
- saturation of the notes color proportional to its velocity, hence making
- a more veloce note more intense in color.
-
-
-
-
-
-
Mixer
-
-
-
- Mixer Strip
-
-
- This table enables (checked) or disables (unchecked) the display of controls
- in the mixer strip. Controls whose
- display can be toggled are:
- Input, Phase Invert,
- Record & Monitor, Solo Iso/Lock,
- Output, Comments and VCA Assigns.
-
-
- Use narrow strips in the mixer for new strips by default When
- enabled, new mixer strips are created in narrow format. When disabled,
- they are created in wide format. Existing mixer strips width can be toggled
- with the width control at the top left of the mixer strip.
-
-
- Limit inline-mixer-strip controls per plugin : Whether or
- not, and how many, controls each plugin can show in the mixer strip.
- These mixer-strip controls are added by checking plugin context-menu
- > Controls > □ control parameter.
-
-
-
-
-
-
Toolbar
-
-
-
- Main Transport Toolbar Items: this section allows to toggle the
- visibility of some elements of the main toolbar:
-
-
- Display Record/Punch Options toggles the visibility of the
- punch and record slice of
- the main toolbar.
-
-
- Display Monitoring Options toggles the visibility of the
- monitor options slice of
- the main toolbar.
-
-
- Display Latency Compensation Info toggles the visibility of the
- Latency Compensation slice of the main toolbar.
-
-
- Display Secondary Clock toggles the visibility of the
- secondary clocks slice of
- the main toolbar.
-
-
- Display Selection Clock toggles the visibility of the
- selection clocks slice of
- the main toolbar.
-
-
- Display Monitor Section Info toggles the visibility of the
- Monitor Info slice of the main toolbar.
-
-
- Display Navigation Timeline toggles the visibility of the
- navigation/mini timeline slice of
- the main toolbar.
-
-
- Display Master Level Meter toggles the visibility of the
- selection clocks slice of
- the main toolbar.
-
-
-
-
-
- Display Action-Buttons enables or disables the visibility
- of the six possible columns of Lua script buttons.
- Each columns contains two user-assignable buttons.
-
-
-
-
Theme
-
-
-
- Theme
-
-
- Draw "flat" buttons: when enabled, button controls
- in the user interface will be drawn with a flat look. When disabled button
- controls will have a slight 3D appearance.
-
-
- Draw "boxy" buttons: when enabled, button controls
- in the user interface will have square corners instead of being slightly
- rounded.
-
-
- LED meter style if checked, the bar meters in the editor and
- mixer will be styled to look like if they were made of LEDs, with a dotted
- bar. Unchecking this option makes the bars flat and continuous.
-
-
- Waveforms color gradient depth: determines how much gradient
- effect is applied to the inner of audio waveforms displayed in the editor.
- Values range from 0.0, no gradient effect, to 1.0, maximum effect.
-
-
- Timeline item gradient depth: Determines how much
- gradient effect is applied to the backgrounds of regions displayed in the
- editor. Values range from 0.0, no gradient effect, to 1.0, maximum effect.
-
-
- Icon Set: Changes the mouse cursor icons used to indicate
- different tool modes in the editor. An example would be the icons used to
- indicate whether the cursor will select a region or change the length of a
- region.
-
-
-
-
-
-
Colors
-
-
-
- Colors
-
-
- Color Theme allows to switch between some presets bundled with
- Ardour, changing both the palette and items colors, hence styling Ardour
- all at once.
-
-
- The table allows to change the color settings in Ardour by acting on three
- parameters:
-
-
- Items that allow to choose any color from the palette (see below)
- to color a UI element. Clicking on a color sample in the Color
- column bring up the Palette, to choose from.
-
-
- Palette that allows to create a set of colors that will be used
- in the UI. Using a palette allows for better consistency, instead of
- picking "free" colors for each UI element. Clicking on a color patch brings
- up a full color selector, to assign this color to this patch of the palette.
-
-
- Transparency where possible, allows to select, with a slider,
- the transparency of the UI element, with 0 (slider to the left) being
- fully opaque.
-
-
-
-
- Restore Defaults turns all the palette, item colors and transparency
- back to Ardour's default base setting, in case Ardour's appearance has turned
- into a toddler's toy.
-
-
-
-
-
-
Quirks
-
-
-
- Various Workarounds for Windowing Systems: As Ardour is available
- on a number of platforms and windowing systems, some specific workarounds are
- sometimes required to provide a smooth experience to the user.
-
-
- Use visibility information provided by your Window Manager/Desktop
- allows the system window manager's rules for the windows visibility to
- supercede Ardour's.
-
-
- All floating windows are dialogs: when enabled, Ardour will
- use type "Dialog" for all floating windows instead of using type
- "Utility" for some of them. This may help usability with some
- window managers. This setting requires a restart of Ardour to take effect.
-
-
- Transient windows follow front window.: when enabled,
- transient windows will follow the front window when toggling between the
- editor and mixer. This setting requires a restart of Ardour to take effect.
-
-
- Float detached monitor-section window: as the
- monitor section can be detached from the mixer, this option makes it a
- floating window, which may be handled differently by the windowing system
- and easier to access.
-
+ 
-