Init

docs/keybindings.md

@@ -0,0 +1,58 @@
+# Keybindings
+
+## Navigation
+
+- **Ctrl+Left/Right**: Switch between pages (Main, Audio, Doc)
+- **q**: Quit (with confirmation)
+
+## Main Page - Sequencer Focus
+
+- **Arrow keys**: Navigate steps in pattern
+- **Enter**: Toggle step active/inactive
+- **Tab**: Switch focus to editor
+- **Space**: Play/pause
+
+### Pattern Controls
+
+- **< / >**: Decrease/increase pattern length
+- **[ / ]**: Decrease/increase pattern speed
+- **p**: Open pattern picker
+- **b**: Open bank picker
+
+### Slots
+
+- **1-8**: Toggle slot on/off
+- **g**: Queue current pattern to first free slot
+- **G**: Queue removal of current pattern from its slot
+
+### Files
+
+- **s**: Save project
+- **l**: Load project
+- **Ctrl+C**: Copy step script
+- **Ctrl+V**: Paste step script
+
+### Tempo
+
+- **+ / =**: Increase tempo
+- **-**: Decrease tempo
+
+## Main Page - Editor Focus
+
+- **Tab / Esc**: Return to sequencer focus
+- **Ctrl+E**: Compile current step script
+
+## Audio Page
+
+- **h**: Hush (stop all sounds gracefully)
+- **p**: Panic (kill all sounds immediately)
+- **r**: Reset peak voice counter
+- **t**: Test sound (plays 440Hz sine)
+- **Space**: Play/pause
+
+## Doc Page
+
+- **j / Down**: Next topic
+- **k / Up**: Previous topic
+- **PgDn**: Scroll content down
+- **PgUp**: Scroll content up

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`