Init

docs/sequencer.md

@@ -0,0 +1,72 @@
+# 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`