Settings
The Settings modal is part of BeatBax Desktop. Open it with:
Ctrl+,(Windows / Linux) /Cmd+,(macOS)- View → Settings…
- The gear icon in the Copilot panel header (opens the AI tab)
- Toolbar
…→ Settings
The BeatBax web-lite client has no Settings modal — use the toolbar for theme (Alt+Shift+L) and word wrap.
Tabs
| Tab | What it controls |
|---|---|
| General | Theme (dark / light / system), toolbar style, panel visibility, compact mixer |
| Editor | Auto-save, word wrap, CodeLens, beat decorations, default BPM, font size |
| Playback | Audio backend, sample rate, default loop, offline render buffer size |
| Features | Pattern Grid, Hot Reload, AI Copilot, Channel Mixer |
| AI | Provider, endpoint, API key, model, interaction mode, max context chars |
| Advanced | Log level, debug overlay, debug player exposure, reset-all |
Most changes apply immediately. Exceptions (noted inline): Auto-save and Audio backend / Sample rate need a reload. Each tab has Reset section to defaults. Advanced → Reset all settings clears BeatBax preference keys after confirmation.
Feature flags
| Feature | Badge | Notes |
|---|---|---|
| Pattern Grid | Experimental | Step-sequencer overlay for patterns |
| Hot Reload | Experimental | Auto-replay on editor changes (debounced) |
| AI Copilot | Beta | Configure provider on the AI tab; see BeatBax Copilot |
| Channel Mixer | — | Channel strips and meters when enabled |