Cagire/docs/sequencer.md

Sequencer

Structure

The sequencer is organized into:

• Banks: 16 banks (B01-B16)
• Patterns: 16 patterns per bank (P01-P16)
• Steps: Up to 32 steps per pattern
• Slots: 8 concurrent playback slots

Patterns

Each pattern has:

• Length: Number of steps (1-32)
• Speed: Playback rate relative to tempo
• Steps: Each step can have a script

Speed Settings

• 1/4: Quarter speed
• 1/2: Half speed
• 1x: Normal speed
• 2x: Double speed
• 4x: Quadruple speed

Slots

Slots allow multiple patterns to play simultaneously.

• Press 1-8 to toggle a slot
• Slot changes are quantized to the next bar
• A "?" indicates a slot queued to start
• A "x" indicates a slot queued to stop

Workflow

1. Edit a pattern in the main view
2. Press g to queue it to the first free slot
3. It starts playing at the next bar boundary
4. Press G to queue its removal

Steps

Steps are the basic unit of the sequencer:

• Navigate with arrow keys
• Toggle active with Enter
• Each step can contain a Rhai script

Active vs Inactive

• Active steps (highlighted) execute their script
• Inactive steps are skipped during playback
• Toggle with Enter key

Playback

The sequencer uses Ableton Link for timing:

• Syncs with other Link-enabled apps
• Bar boundaries are used for slot changes
• Phase shows position within the current bar

Files

Projects are saved as JSON files:

• s: Save with dialog
• l: Load with dialog
• File extension: .buboseq