Fusor Studio/Docs
Home

The Set List Builder

The Set List Builder is a dedicated window for adding tracks to a set list by walking the graph of available transitions. Open it from any track row in the set list contents view: right-click and pick Insert Before or Insert After. The same options appear on every row (including the first), so right-clicking the first track and choosing Insert Before is the way to add tracks at the head of an existing set list.

The builder shows the current set list on the left and a tracks panel on the right. The right panel filters the track library by what's reachable from the current insertion point: by default, the successors of the last item in the set list (or the predecessors of the first item, depending on the insertion direction).

Filter chips

Three filter chips sit above the tracks panel and can be toggled by clicking:

  • In crate (blue, default-on). Restricts candidates to the active crate.
  • Not in set list (purple, default-on). Hides any track already in the set list, plus any tracks you've already selected at earlier levels of a multi-step walk (the "trail"). Toggle off if you want to insert a duplicate.
  • Before: / After: (teal, default-on). Shown when there are tracks in the library that connect into (or out of) the right-clicked anchor track. If the anchor has no predecessor or successor transitions at all, the chip is hidden rather than displayed greyed out, so an empty filter never silently filters nothing.

Walking the graph

Click a track in the right panel to walk into it. The builder opens a new panel one level deeper, now showing tracks reachable from the one you just clicked: a trail of walked-but-not-yet-committed tracks. You can walk several levels deep, exploring the path you'd like to add, before committing anything to the set list.

The bottom of the Builder carries three commit buttons:

  • Add (or Add N tracks). Commits the walked trail and keeps the Builder window open so you can add another track. The label switches from "Add" to "Add 2 tracks", "Add 3 tracks", etc. as the trail grows.
  • Add & Close. Same commit, then closes the Builder window.
  • Insert & Load (teal, conditional). Appears only when you're editing the active set list AND the cursor has no resolved next-transition (the slot you're filling is the next gap). Commits the trail and immediately loads its first new transition into the player, with no save round-trip required — the picker reads the in-memory edit buffer. This is the one-click path for "add this next thing and load it now" during a live performance.

The key Builder property: walking three levels deep and clicking Add commits the entire chain, not just the leaf. The chain order is preserved in the set list.

Inline variant picker

If any pair of adjacent tracks in the trail has more than one transition variant (multiple .transition records connecting the same outgoing/incoming pair, perhaps for different BPMs or fusor styles), the builder switches to a variant picker view before committing. The view shows each variant as a radio-list row with:

  • Title. The transition's display name.
  • Fusor. The linked fusor name.
  • Bars. Duration in bars.
  • BPM. Target BPM.
  • Ramp. Whether tempo ramp is enabled.
  • Notes. The author's free-text notes, if any.

Pick one variant per ambiguous pair, then commit. The user-chosen variants are recorded on the set list items and survive future re-saves.

See also