Automation

Automation Editor not connected to a segment

The Automation Editor allows you to control the value of any automatable control at any point in time during the song. This allows you anything from very simple effects like turning up the volume of an instrument at the start of the song, to very complex manipulation of envelopes or instrument filters. Even the controls in LADSPA effects and VST effects can be automated!

As the Piano Roll, you must connect the Automation Editor to a segment, in this case an Automation segment. If you open the Automation Editor (shortcur F8), and it looks like the image, close it and double-click on an Automation track segment to connect to.

What Can Be Automated?

Controls are the knobs, sliders, light switches, digital readouts, etc, that can be found in the LMMS GUI. All controls on default LMMS GUI can be automated, including the following types

  • Light switches:

  • Digital readout (FX numbers, pitch range):

  • Option buttons:

  • Sliders:

  • Knobs:

If you're unsure if a control can be automated, right-click on its icon and look for a contex menu item called Edit song-global automation. If it's there, the item probably can be automated. Most ZynAddSubFX controls do not support automation. You can automate any controls on third-party VST instruments by clicking on the "Control VST plugin" icon Track op menu.png.

Toolbar

Automation Editor toolbar

The toolbar controls much of the functionality, and is similar in many ways to the toolbars of other windows. The fundamental tools are similar in behavior to their equivalents in the Piano Roll Editor. Additional tools are:

  • The line progression tools

  • Tension knob

Editing Automation

Editing automation

The image shows a typical view of the automation window. The window title Automation Editor-Lead>Volume tells you that you are editing the automation graph of the "Volume" control that belongs to the track named "Lead". The image does not show this correctly because the automation is not connected to a control.

The main part of the window is a graph of the value of the control over time. Time is listen along the horizontal axis (at the top of the window) in the units of bars (a.k.a. the "timeline"). The value of the control is listed along the vertical axis at the left of the window in whatever units the control uses. Within the graphing area, the mouse cursor is linked to the horizontal and vertical axes by red lines to make it easier to see where you are working in both dimensions. How you should interpret the bar numbers in the Automation Editor depends on which method you are using to automate a control - Song-global or Automation track.

The blue part of the graph provides an easy way to see the curve of the graph. The area between the curve and zero is shaded blue. In the case of a volume control, all the values are zero or greater, so zero is at the bottom of the value scale. For controls where the value can be negative, for example, a stereo pan control, the "zero line" is in the middle of the graph and blue shading can occur on either side of the zero line.

Control Points

The red circle () is the control point. The automation graph must always go through these points. After the last point the automation graph will be a straight line, the value of the last point could last in infinity, but is limited by the length of the segment in the Song Editor.

Drawing Control Points

Using the Draw mode tool (pencil - ), you can create new control points simply by clicking on (or near) a vertical line. In all cases, if control point already exists somewhere on that vertical line, it will be removed to where you clicked. If a control point does not exist on that vertical line, it will be created there. You can move an existing point up/down its vertical line by dragging it directly - you are reshaping the graph.

You can delete a control point by right-clicking (same as deleting a note in the Piano Roll Editor).

The timeline spacing of control points as you draw is set by the Q (quantization) setting (). By default this is set to 1/16 which means 16 control points per bar (or a control point vertical line every 1/16th of a bar). You don't have to have a control point at every point that is possible - a horizontal line only requires 2 control points (one at each end).

Working with Selections

Operations such as cut, copy, paste, delete, and move selection operate on 1+ selected control points.

The Select mode tool allows you to drag a rectangular area around 1+ points to select them. The vertical orange bar of the point(s) will turn blue. You can also use Ctrl+A which will select all the control points in the Automation Editor. You can the cut, copy, delete, and/or paste the selected points.

Use the Delete key on the computer keyboard to delete the selected points.

The Paste operation uses both the timeline position (horizontal value) and the control value (vertical value) of the control points when pasting them into a new (or the same) automation track block. Beware the vertical value might not make sense for a different control. After pasting, the pasted points are still selected, which allows you to move them as a group. For example, if you copied the control points from bars 20 to 30 from one automation block and pasted them into a different automation block, the points will occupy bars 20 to 30 in the new block, but, because they are still selected, you can move them to a different location.

LMMS-move-tool.pngThe Move selection mode tool allow you to move (by dragging) the selected control points and without regard for the Q setting. The selection will move at the maximum Q of 1/192. This is similar to the "free drag" (Alt+drag) of notes in the Piano Roll. Beware while moving a selection that any existing points that the selection passes over will be deleted!

Erasing Control Points

The Erase mode tool can delete control points, as can right-clicking on them.