A1R Guide

Locator Notation

A1R reads your song structure from Ableton locator names. Add simple flags to a locator name to control how A1R treats it.

In Ableton's Arrangement, a locator marks a point in time. A1R turns your locators into a setlist:

Everything below is optional — a plain name just works. Flags are case-insensitive.

Duration & colour

FlagExampleWhat it does
[m:ss]Chorus [3:20]Sets an explicit duration for the song/section.
[color]Way Maker [amber]Colours the song. Use a colour name (e.g. amber, emerald, blue, rose…).
[.class]Drop [.big]Adds a custom CSS class for Custom Styles.
[text]Verse [capo 2]Any other bracketed text becomes a small note shown on the section.

Flow control

FlagExampleWhat it does
+SKIP / [skip]Verse 2 +SKIPSkips this section during playback (shown crossed-out). A1R jumps over it.
>>>TargetChorus >>>BridgeAfter this section, jump to the section named Target.
+PAUSEInterlude +PAUSEPauses at this section instead of continuing automatically.
+JUMP / +STAYOutro +STAYOverride auto-advance: force a jump, or force staying.
+ENDChorus +ENDMarks the end zone of the song.

Looping All tiers

FlagExampleWhat it does
+LOOP:NChorus +LOOP:4Loop this section N times (2–99), then continue.
+LOOPVamp +LOOPLoop indefinitely (∞) until you move on manually.
+LOOPFULLBridge +LOOPFULLLoop indefinitely (∞), but always complete the current full pass before advancing.

Song boundaries

NameWhat it does
SONG ENDEnds the current song here (anything after belongs to the next song).
STOP / AUTOSTOPStops transport at this point.
[nosong]This locator is not counted as a song (e.g. a utility marker).
>NameForce this locator to be a section (not a song).
>>NameA quick-access section — shown with a » badge for fast jumping.
*NameIgnore this marker entirely.

Tags & search

Add #tag anywhere in a locator name to categorise it — e.g. Chorus #uptempo. Tags are handy for filtering and organising large sets.

Combine flags freely: Chorus [emerald] +LOOP:2 #big >>>Outro — an emerald Chorus that loops twice then jumps to Outro, tagged #big.