Tutorial 6: Add a dialog first

Goal: Show a dialog that asks the user a question before your extension changes Live.

Prerequisites: Tutorials 1–2; basic graph editing.

Time: ~15 minutes

You will use: Toolbar Designer, Show Dialog node

Steps

  1. Start from Transpose MIDI clip template or your own clip tool.
  2. Click Designer on the toolbar to open the Dialog Designer overlay.
  3. Add controls (slider, text field, toggle) and save the design.
  4. Add a Show Dialog node to the graph before mutating steps.
  5. Wire trigger Run → Show Dialog Run, then Show Dialog Then → your transpose or set chain.
  6. Wire dialog outputs (e.g. semitones) into the transpose node input.
  7. Do not place Show Dialog inside a Transaction body.
  8. Build & Run and test in Live — dialog should appear first, then notes change.

Expected results

Where What you see
Live Dialog appears; after OK, clip updates
Undo Dialog is outside undo group unless you designed otherwise

If something goes wrong

Problem What to do
Dialog never shows Check Run wire order: dialog before setters
Dialog inside transaction Move dialog before Transaction node
Designer not visible Use toolbar Designer, not dock

Next steps