Setlists

Status: draft. Concrete reference content + structural placeholders; flesh out the prose + screenshots when ready.

Purpose

A Setlist is an ordered sequence of entries you'll perform through. Each entry is one of three types:

• A song (a full cue timeline — fires through its cues in Performer Mode).
• A preset (a single preset to load, with optional notes for context).
• A talk (talk-break — fires the TALK preset, with an optional per-entry slot override).

Setlists let you assemble a gig-night running order without authoring a single mega-song. Songs stay reusable across multiple setlists; talk-breaks are first-class entries so they're as easy to drop in as song transitions.

VL Studio difference — setlists vs Favorites

The VL3X's closest equivalent is the Favorites Genre: flag presets as Favorites, then select the Favorites Genre to filter the preset list to just those. It's a flat, unordered filter — you still scroll through Favorites with Preset Up/Down at the gig, with no sense of show order, no talk-breaks, no per-entry notes.

VL Studio setlists are a real running order. Drag entries up and down, mix songs, standalone presets, and talk-breaks freely, add notes per entry for context, and keep multiple setlists side-by-side so the same songs can be reused across different shows.

Walk-through

1. Create a setlist — Setlists page → New Setlist → name. The empty list appears.
2. Add entries — three buttons: + Song, + Preset, + Talk.
   • + Song — picker from your Songs library; the song's full cue list comes along. Per-entry notes field for performance context.
   • + Preset — picker from your Library; useful for one-shot pieces that don't need a cue timeline.
   • + Talk — adds a talk-break. By default it fires the global TALK preset (Settings → TALK Preset); set a per-entry preset to override.
3. Reorder — drag entries up and down. Order is performance order.
4. Run the setlist — open it, then enter Performer Mode. Performer Mode starts with the first entry, walks through it (cue-by-cue for a song, single-load for a preset, TALK fire for a talk-break), then advances to the next entry on NEXT.
5. Sharing & backups — setlists export as .setlist.jsong files for archiving and sharing, and are also included in the full backup format that round-trips across machines. See Setlists (.setlist.jsong) for the format spec and the standalone-import caveat.

Reference

Entry types

Type	What it does in Performer Mode
Song	Loads the song, arms cue 0, walks cues on NEXT.
Preset	Loads the preset directly — no cue timeline.
Talk	Fires the global TALK preset (or a per-entry override) and shows the talk-break label in the UI.

Talk-break preset precedence

When a Talk entry runs:

1. If the entry has a per-entry preset set, that wins.
2. Otherwise, the global TALK preset (Settings → TALK Preset) is used.
3. If neither is set, the entry just shows its label and doesn't change the device.

Same precedence applies to a song cue's TALK action.

Troubleshooting

Symptom	Fix
Setlist NEXT skips ahead too far	Check whether the song has zero cues — Performer Mode falls through to the next entry when a song has no cues to advance through. Add at least one cue to the song.
Talk-break doesn't switch presets	No global TALK slot is set in Settings, and no per-entry override either. Settings → TALK Preset → set a default slot, or set a per-entry preset on the talk-break entry.
Setlist disappears after restoring a backup	The restore may have failed mid-way. Check Settings → Backups for any failed-restore status and restore from a known-good backup.

See also

• Songs — authoring cue timelines that go inside song-type setlist entries.
• Performer Mode — the surface that walks the setlist live.
• Sharing & Files — .setlist.jsong export format and what it references.
• Device — TALK button + per-cue TALK action share the same underlying slot configuration.