Edit Tools#

When working in each editor or arranger, you will most likely be using the cursor tools provided by Zrythm to create, edit and delete objects. Each cursor signifies a separate tool, and Zrythm offers the following tools.

Select Tool#

In select mode, you can make object selections and create, move, clone and resize objects. This is the most common mode and the most common operations can be accomplished by just using this.

Creating Objects#

Using the select (default) tool, all objects are created by double clicking inside their corresponding arranger and dragging, then releasing when you are satisfied with the position/size.

../_images/creating-midi-region.png — Creating a region#

Selecting Objects#

To select objects, you can either click on them, click in empty space and keep dragging to make a selection, or Control-click to add/remove objects to/from the selection.

Selected objects will have brighter color than non-selected objects.

../_images/object-selection.png — Selecting objects#

Moving Objects#

Objects are moved by clicking and dragging them around. You can move regions to other tracks if the track types are compatible.

../_images/moving-midi-region.png — Moving a region#

Cloning (Copy-Moving) Objects#

Holding down Ctrl while moving objects will allow you to copy-and-move the objects to the new location.

../_images/copy-moving-midi-region.png — Copy-moving a region#

Linking (Link-Moving) Objects#

Regions can be linked by holding down Alt while moving. Changes made in a linked region will be propagated to all other regions in the same link group.

Tip

This is useful for re-using the exact same regions across a song without having to re-copy the regions when new changes are made.

../_images/link-moving-regions.png — Link-moving a MIDI region#

Linked regions will display a link icon in their top-right edge.

../_images/linked-regions.png — Linked regions#

Resizing Objects#

Objects that have length, such as regions and MIDI notes, can be resized by clicking and dragging their edges.

Repeating Objects#

Regions can be repeated (looped) by moving the cursor on the bottom half of the object, then clicking and dragging.

Regions that are repeated will display dashed lines at points where looping occurs, and a loop icon in their top right corner.

../_images/repeated-object.png — A repeated region#

The position where the region will initially start playback (the clip start position) and the start/end loop points, can be adjusted in the clip editor.

Warning

If the region is already repeated, it cannot be resized anymore until its loop points match exactly the region's start and end points.

Stretching Objects#

To stretch one or more regions, hold Control while hovering the cursor at a top edge of a region, then click and drag.

Note

Only non-repeated objects can be stretched.

Cutting Objects#

You can Alt-click inside objects to break them up.

Erasing Objects#

Clicking and holding the right mouse button while hovering over objects in select mode will delete them.

Edit Tool#

This tool is used to quickly create or delete objects. While you can still create objects using the Select tool by double clicking and dragging, with the Edit tool this is accomplished by single clicking and dragging, which is more efficient when creating a large number of objects.

Brush Mode#

Holding down Control while clicking will allow you to create multiple objects in a row (where applicable) with a length specified by the snap settings corresponding to each editor.

Cut Tool#

The Cut tool behaves similarly to what is mentioned in Cutting Objects, with the exception that you can just click instead of Alt-clicking.

Erase Tool#

Using the Erase tool you can just click on objects to delete them, or click and drag to make a selection, deleting all objects inside it.

Ramp Tool#

This tool is currently only used for editing velocities for MIDI notes. You can click and drag in the velocity editor to create velocity ramps.

Audition Tool#

The Audition tool is used to listen to specific parts of the song quickly. After enabling the audition tool, click anywhere to start playback from the position of the cursor and release the mouse button to stop.