Usage Guide
A walkthrough of the web interface. Screenshots come from docs/images/.
Top-level access to playback, files, devices, lighting, settings, and the debug console.
USB devices appear automatically. Bluetooth and serial devices need the corresponding subsystem enabled (see Hardware-Integration). Each device exposes:
- Custom display name
- Latency compensation (manual or auto-calibrated)
- Instrument type, note range, polyphony
- Per-channel registered instrument(s)
- Enable/disable toggle
- Drag-and-drop or upload
.midfiles - Organise into folders, multi-select for batch actions
- Search and filter by duration, tempo, track count, instrument type, channel count, compatibility
- Save filter presets, sort by any column
Each MIDI channel (1–16) can be routed to a different connected device, with per-route velocity scaling, transposition, and note-range mapping. Use Auto-Assignment to bootstrap routing automatically.
Standard transport (play / pause / stop / seek), tempo override, lookahead window for tight timing, and per-instrument latency compensation applied automatically.
Four modes share a transport, channel panel and undo/redo stack:
- Piano Roll — add / move / resize / re-channel notes, snap grid 1/1 → 1/16
- Tablature — string instruments, 19 tuning presets, bidirectional MIDI ↔ tab
- Drums — grid editor mapped to GM drums (notes 35–81)
- Wind — articulation & breath dynamics
Detailed shortcuts and CC editing in MIDI-Editor.
Configure drivers (GPIO LED strips, ArtNet, sACN, OSC, HTTP, MQTT), build effects, and synchronise them with playback. See Lighting.
Test devices from the browser using mouse drag or computer keyboard (AZERTY/QWERTY). Adjustable octave and velocity.
The display adapts to the instrument type assigned to the selected channel:
Piano — two-hands overlay (piano keys)
Left-hand and right-hand finger assignments are shown directly on the standard piano keys.
Drums
GM drum map: each pad shows the instrument name; click to trigger the corresponding MIDI note.
Guitar / string — hand on strings (horizontal)
Fretboard view with the fretting hand overlaid on the strings.
Guitar / string — motor per string
For automated string instruments: shows the actuator position per string.
String instrument — hand vertical + all frets & strings
Full fret grid showing all reachable notes across every string; active notes are highlighted.
Live MIDI events, log stream, and command playground. Useful when wiring up a new device.
- Theme: Light / Dark / Coloured
- Virtual keyboard octave count (1–4)
- Language (28 supported, see Advanced-Topics)
- Persisted under
localStorage["gmboop_settings"]