Timeline#

Overview#

Editing in the timeline is the most common workflow inside Zrythm. The timeline section consists of the tracklist on the left and the ruler/arranger on the right, along with a timeline-specific toolbar at the top.

../_images/timeline.png

Minimap#

The timeline minimap is a little box that represents the current visible area of the timeline. It can be moved around and resized to change the visible area.

../_images/timeline-minimap.png

Ruler#

The ruler is mainly used to control looping and playback.

../_images/ruler.png

The ruler will display more or less information depending on the current zoom level. It will also display the following markers/indicators discussed in Loop Points.

Cue point

Displayed as a blue, right-pointing arrow.

Playhead position

Shown as a grey, down-facing arrow.

Loop points

Shown as 2 green arrows, and the area between them is shown in bright green if loop is enabled, or grey if disabled. Can be dragged to reposition.

Tip

Looping can be enabled/disabled using the loop button in the transport controls.

Clicking and dragging on empty space in the bottom half of the ruler will allow you to reposition the playhead.

Tip

You can Control-click and drag the loop region to move it.

Setting the Cue Point#

Double click inside the ruler to set the cue point. This will be used to return to when playback is stopped.

Range Selection#

Clicking and dragging in the top half of the ruler will create a range selection. If an existing range exists, you can click an drag it to move it.

../_images/ranges.png

Range selection#

Arranger#

The timeline arranger is the main area where the song is composed. It consists of a collection of events, such as regions, positioned against time. Some events (such as regions) will open separate windows for further editing when clicked.

../_images/timeline-arranger.png

The timeline arranger is split into a top arranger that remains fixed on top and a bottom arranger below it. This way you can pin tracks you want to always be visible at the top.

Arranger Objects#

The following arranger objects can exist inside the timeline.

Regions#

Regions (or clips) are containers for events or data (such as MIDI notes and audio clips - see below) that can be edited in an editor. Regions can be repeated, like below.

../_images/region.png

Region#

The following types of regions exist.

Audio Regions#

Audio regions contain audio clips from audio files.

../_images/audio-region.png

Audio region#

Audio regions belong to track lanes and appear inside Audio tracks.

../_images/audio-track-with-region.png

Audio track with audio region#

Double-clicking an audio region will bring up the audio editor.

MIDI Regions#

MIDI regions contain MIDI notes.

../_images/midi-region.png

MIDI region#

MIDI regions belong to track lanes and appear inside MIDI or Instrument tracks.

../_images/midi-track-with-region.png

MIDI track with MIDI region#

Double-clicking a MIDI region will bring up the piano roll.

Automation Regions#

Automation regions contain automation events.

../_images/automation-region.png

Automation region#

Automation regions appear inside automation lanes.

../_images/automation-lane-with-region.png

Automation lane with automation region#

Double-clicking an automation region will bring up the automation editor.

Chord regions#

Chord regions contain sequences of chords.

../_images/chord-region.png

Chord region#

Chord regions appear inside the chord track.

../_images/chord-track-with-region.png

Chord track with chord region#

Double-clicking a chord region will bring up the chord editor.

Markers#

Markers are used to mark the start of a logical section inside the song, such as Chorus or Intro.

../_images/marker.png

Marker#

Markers appear inside the marker track.

../_images/marker-track-with-marker.png

Marker track with marker#

There are two special markers that signify the start and end of the song that are used for exporting the song and cannot be deleted.

Scales#

Scales are used to indicate the start of a section using a specific musical scale.

../_images/scale-object.png

Scale#

Scales appear inside the Chord track.

../_images/chord-track-with-scale.png

Chord track with scale#

Editing Regions#

The following operations apply to regions.

Renaming#

Regions can be renamed by selecting them and pressing F2.

../_images/region-rename.png

Renaming a region#

Adjusting Fades#

Audio regions can have fades. Fades are gradual increases or decreases in the level of the audio signal, and their positions can be adjusted by clicking and dragging the top left/right corners of the region.

../_images/audio-region-fade-out1.png

Adjusting fade out point (click & drag)#

../_images/audio-region-fade-out2.png

Adjusting fade out point (drop)#

Clicking and dragging the grey part up or down will adjust the curviness of the fade.

../_images/audio-region-fade-out-curviness.png

Adjusting curviness#

The type of fade algorithm used can also be changed by right-clicking on the fade and selecting Fade preset.

../_images/audio-region-fade-context-menu.png

Fade context menu#

Fade Types#

The various types of fade algorithms available are illustrated below.

Fade algorithms#
../_images/fade-linear.png

Linear#

../_images/fade-exponential.png

Exponential#

../_images/fade-superellipse.png

Elliptic (Superellipse)#

../_images/fade-vital.png

Vital#

Note

All audio regions have some additional, built-in fade in and fade out that cannot be disabled. This is used to avoid clipping and should be unnoticable.

Editing Region Contents#

Displaying Region Contents#

When regions are selected in the timeline, their contents will be shown inside the Editor tab in the Bottom Panel. Although there are some common elements shared amongst each type of editor, the editor section will differ depending on the type of region selected.

../_images/editor-tab.png

Editor Ruler#

The editor ruler is similar to the timeline ruler.

../_images/editor-ruler.png

Editor ruler#

The ruler will display more or less information depending on the current zoom level. It will also display the following indicators.

Editor Ruler Indicators#

Song Markers

Markers created in the Marker track will be displayed here as read-only.

Clip Start

Controls the position where the clip will start playback from. Displayed as a red, right-pointing arrow.

Playhead

Current position of the playhead. Displayed as a grey, down-facing arrow.

Loop Points

These control the range where the clip will loop after it reaches the loop end point. Displayed as 2 green arrows.

You can move these markers by clicking and dragging.

Clicking and dragging on empty space will allow you to reposition the playhead.

Regions in the Editor Ruler#

All regions in the same track as the active region will be shown inside the ruler. The active region will be displayed in a more prominent color.

../_images/editor-ruler-regions.png

Regions in the editor ruler#