diff --git a/include/preferences.html b/include/preferences.html
index cc5067bf..b703214c 100644
--- a/include/preferences.html
+++ b/include/preferences.html
@@ -26,9 +26,7 @@
Metronome
Metering
Transport
- Sync
Control Surfaces
- MIDI Ports
Plugins
Appearance
Video
@@ -109,6 +107,12 @@
The GUI can also be locked with . When
locked, a dialog will display a "Click to unlock" button.
+
+ System Screensaver Mode:can be used to prevent the
+ screensaver to be launched by the system, either while recording
+ (e.g. for long and unattended recording session), when Ardour is
+ simply started, or never (the screensaver is then able to start).
+
@@ -149,9 +153,9 @@
saved.
- Always copy imported files selects, and then disables
- changes to, the Copy files to session option in the
- Add Existing Media dialog.
+ 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.
Default folder for new sessions: defaults the folder
@@ -185,31 +189,21 @@
Editor
-
-
General
- -
- Snap rubberband to grid when
- enabled uses the grid when selecting regions
- with a rubberband rectangle.
-
-
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.
-
- Allow dragging of the playhead, when enabled, allows
- dragging the playhead with the mouse in the Editor window.
-
- -
- Playhead dragging speed (%): chooses how fast the canvas
+ 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
+ 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.
@@ -250,11 +244,15 @@
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.
+
-
- Editor Behaviour
+ Editor Behavior
-
Move relevant automation when audio regions are moved,
@@ -273,7 +271,7 @@
fade shape is the default.
-
- Regions in edit groups are edited together: sets
+ Regions in active edit groups are edited together: sets
the criteria to see if editing actions apply to tracks grouped together
in an group.
@@ -282,18 +280,44 @@
multiple regions in the same track. This selector defines how these layers are
managed, either manually or by placing the latest on top.
+
+
+
+
+ Split/Separate
+
-
- After splitting selected regions, select: determines which,
- if any, regions are selected after a split operation. The options are no
- regions, the regions created by the split, and if more than one region
- was selected to start with, the existing selection and the new regions.
+ After a Separate operation, in Range mode: determines what
+ should become of the Range selection after a Separate operations:
+
+ - Clear the Range Selection: nothing is selected anymore
+ - Preserve the Range Selection: the range selection is kept
+ - Force-Select the regions under the range: the regions that
+ were in the range selection are selected in Grab/Object mode
+
+
+ -
+ After a Split operation, in Object mode: determines which,
+ if any, regions are selected after a split operation. The options are:
+
+ - Clear the Region Selection: nothing is selected anymore
+ - Select only the newly-created regions BEFORE the split point:
+
if regions have been affected by the split, then the regions
+ created by the split before the split point is selected
+ - Select only the newly-created regions BEFORE the split point:
+ same as above, for the regions created after the split point
+ - Select the newly-created regions: sum of the two above, i.e. all
+ the regions that are created as a result of the split are selected.
+ - Preserve the existing selection, AND select all newly-created regions:
+ same as above (all the parts that have been created by the split) plus
+ the unaffected regions that were selected before the split.
+
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
@@ -358,6 +382,18 @@
+
+ Master
+
+ -
+ Enable master-bus output gain control adds a gain-stage to
+ the master-bus and a Loudness Analyzer & Normalizer button that
+ calculates the Loudness (LUFS) of the session (or a range selection),
+ and normalizes the loudness according to various standards.
+
+
+
+
Default Track / Bus Muting Options sets the muting options
for a newly created tracks or bus. The mute options for an existing track
@@ -409,9 +445,9 @@
See Monitoring for more information.
- Tape machine mode when enabled defaults new audio tracks to
- tape machine mode. See Track Types 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.
@@ -513,18 +549,6 @@
MIDI
- -
- Buffering
-
- -
- MIDI read-ahead time (seconds): defines how much time of MIDI data
- must be read in advance by Ardour and put in the buffer. More time means more
- stability while playing back, at the expense of more time to buffer the data.
- This should be set to a low value for a reasonably capable machine.
-
-
-
-
-
Session
@@ -546,10 +570,32 @@
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
+
-
- Midi Audition Synth (LV2): allows to select in the list of LV2
- instruments, which one will be used to audition MIDI when e.g. in the
- import dialog.
+ 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 ().
+
+
+
+
+
+
+ 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.
@@ -665,12 +711,18 @@
Post Export Analysis
-
- Save loudness analysis as image file allows, when the
+ 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).
+
@@ -691,6 +743,13 @@
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
@@ -721,9 +780,9 @@
starts playing the loop but stop then cancels loop playback.
- Do seamless looping removes any clicks that might
- otherwise be audible when the transport moves from the end of the loop
- range back to the beginning.
+ 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.
@@ -742,55 +801,39 @@
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.
+
-
-
-Sync
-
-
+
-
- External Synchronization
+ 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.
+
-
- External timecode source determines which external source to
- use when Ardour is using an external
- synchronization source.
- Depending on the timecode source chosen, the additional preference options
- below are available.
-
- -
- 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.
-
- -
- Sync-lock timecode to clock (disable drift compensation)
- When enabled, Ardour will never varispeed when slaved to external
- timecode. Sync Lock indicates that the selected external timecode
- source shares clock-sync (Black & Burst, Wordclock, etc) with
- the audio interface. This options disables drift compensation.
- The transport speed is fixed at 1.0. Vari-speed LTC will be ignored
- and cause drift. When disabled, Ardour will compensate for potential
- drift regardless if the timecode sources shares clock sync.
-
- -
- Lock to 29.9700 fps instead of 30000/1001, when
- enabled, will force Ardour to assume the external timecode source
- uses 29.97 fps instead of 30000/1001.
- SMPTE 12M-1999 specifies 29.97 df as 30000/1001. The spec
- further mentions that drop-frame timecode has an accumulated error
- of -86 ms over a 24 hour period. Drop-frame timecode would
- compensate exactly for an NTSC color frame rate of 30 × 0.9990 (i.e.
- 29.970000). That is not the actual rate. However, some vendors use
- that rate—despite it being against the specs—because the
- variant of using exactly 29.97 fps has zero timecode drift.
-
+ 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.
+
@@ -798,15 +841,6 @@
LTC
- -
- Linear Timecode (LTC) Reader
-
- -
- LTC incoming port: specifies which physical incoming port of
- the system will provide the LTC signal.
-
-
-
-
Linear Timecode (LTC) Generator
@@ -826,6 +860,10 @@
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.
+
@@ -899,58 +937,6 @@
protocol settings (only for Generic MIDI and Open Sound Control).
-MIDI Ports
-
-
- -
- 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.
-
-
-
-
- -
- MIDI Inputs This is a list of all the MIDI devices connected as
- inputs (capture devices) to Ardour. For each devices, there are 3 checkboxes:
-
- -
- Music Data if checked, Ardour will consider this device as a source
- for musical data input (notes, etc…)
-
- -
- Control Data if checked, Ardour will consider this device as a source
- for control data input (play/stop, etc…)
-
- -
- Follow selection if the above
- MIDI input follows MIDI track selection is
- checked, Ardour will make this device follow track selection.
-
-
-
-
- -
- MIDI Outputs This is a list of all the MIDI devices connected as
- outputs (playback devices) to Ardour. For each devices, there are 2 checkboxes:
-
- -
- Music Data if checked, Ardour will consider this device as a target
- for musical data output (notes, etc…)
-
- -
- Control Data if checked, Ardour will take this device as a target
- for control data output (play/stop, etc…)
-
-
-
-
Plugins
@@ -1002,6 +988,17 @@
+
+
+ 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
@@ -1026,7 +1023,7 @@
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 a-*
plugins.
+ Inline Display, like Ardour's own ACE *
plugins.
@@ -1047,6 +1044,26 @@
+
+
+ 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
@@ -1075,18 +1092,24 @@
instantiation. Plugins that require more time to load will be
blacklisted. A value of ∞ disables the timeout.
+
+
+
+
+ VST 2.x
+
-
- VST Cache: Clicking the button
+ VST 2 Cache: Clicking the 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 Blacklist: Clicking the
+ VST 2 Blacklist: Clicking the
button makes blacklisted VST plugins available to be added to the processor
box.
-
- Linux VST Path: Clicking the button
+ Linux VST2 Path: Clicking the 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.
@@ -1103,6 +1126,29 @@
+
+
+ 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
@@ -1137,13 +1183,19 @@
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)
- Ardour uses hardware accelerated gradient creation 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 own gradients without
- hardware acceleration, improving stability and responsiveness on those
- buggy systems.
+ 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.
@@ -1207,6 +1259,25 @@
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.
+
@@ -1277,6 +1348,16 @@
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.
+
@@ -1301,6 +1382,12 @@
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.
+
@@ -1318,19 +1405,27 @@
the main toolbar.
- Display Monitor Options toggles the visibility of the
+ 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 Secondary Clock toggles the visibility of the
- secondary 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
@@ -1346,8 +1441,8 @@
- Lua Action Script Button Visibility enables or disables the visibility
- of the four columns of Lua script buttons.
+ Display Action-Buttons enables or disables the visibility
+ of the six possible columns of Lua script buttons.
Each columns contains two user-assignable buttons.
@@ -1363,6 +1458,11 @@
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