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.

Javaslat

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.

Javaslat

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

Megjegyzés

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