OpenSpark2
Play your Positive Grid Spark 2 from a browser.
An open Web Bluetooth controller built by reverse-engineering the amp's protocol. It works with stock firmware, so there's nothing to flash and nothing to install.
▶ Open the app · Protocol notes · Help wanted
Important
On iPhone or iPad? Install the free Beacio app first. Safari on iOS and iPadOS has no Web Bluetooth, so it
can't reach the amp on its own. Beacio (listed in the App Store as
“ioswebble”) adds it as a Safari extension:
- Install Beacio from the App Store.
- Open Settings › Apps › Safari › Extensions, turn Beacio on and allow it on all websites (or on
michaelbeyhs.github.io).
- Open the app link above in Safari and tap Connect.
The app shows these steps too when you open it on an iPhone or iPad without Beacio.

What it does
- Reads what the amp is playing when you connect: every block's model, on/off state and knob values.
- Follows the amp live. Turn a knob or change a preset on the amp, and the screen follows.
- Edits the tone: knobs, on/off switches and model changes go straight to the amp.
- Keeps a tone library in your browser. Step through your tones and each one is sent to the amp in full.
- One connection for everything. Switch between views without reconnecting or re-reading the amp.
- Ten ways to play, from a pedalboard to a stage layout with thumb-sized tiles, plus a debug console that
shows every frame.
Try it
Open https://michaelbeyhs.github.io/OpenSpark2/, turn the amp on, press Connect and pick your Spark 2.
| Device |
What to use |
| Windows, macOS, Linux, ChromeOS |
Chrome or Edge |
| Android |
Chrome |
| iPhone / iPad |
Safari + the free Beacio app: install it, enable its Safari extension, then open the link in Safari (see the box at the top) |
Firefox, and Safari without Beacio, have no Web Bluetooth.
To run it yourself, serve the webapp/ folder from localhost or over https:
cd webapp && python3 -m http.server 8000
Then open http://localhost:8000.
The views
 Editor: every parameter of every block on one page. Search, a draggable amp tone stack and EQ, and A/B compare. |
 Tone map: the reverb is the room around you, the delay is echo rings and modulation makes them wobble. Amps are grouped by character. |
 Stage: for mid-gig. Huge tone name, thumb-sized tiles, a SOLO switch, DRY, and an XY pad that mixes delay against reverb. |
 Grid: the signal path with an inspector underneath, in the style of HX Edit or Quad Cortex. |
 Classic UIs: hardware-style front-ends, including a floor unit with LED-ring encoders, a pedalboard, a rack mixer and one big puck knob. |
 Debug console: a sniffer with decoded reports, read commands, a parameter explorer and a raw frame builder. |

How it works
webapp/index.html is the app. It holds one Bluetooth connection and an amp engine (webapp/spark2-core.js)
and opens each view inside itself. The engine reads the amp on connect and after every preset change, keeps track of
the amp's live reports and of everything the views send, and hands that state to whichever view is open.
The protocol, all confirmed on a real Spark 2 (full details in docs/PROTOCOL.md):
-
Bluetooth: GATT service 0xFFC0. Write to 0xFFC1; notifications arrive on 0xFFC2.
-
Frame: F0 01 SID CHK OpMsb OpLsb <8-to-7 payload> F7, with an XOR checksum over the payload.
-
Payload: msgpack values written back to back, with no outer array.
-
Verbs: OpMsb 1 = set (the amp acks with 4), 2 = get (the amp replies with 3), and 3 also carries
reports the amp sends on its own.
-
Commands:
| Command |
Opcode |
Payload |
| Set a parameter |
(1,0x04) |
model id, index, value |
| Switch a block on or off |
(1,0x15) |
model id, on/off |
| Change a model |
(1,0x06) |
old id, new id |
| Read a preset |
(2,0x01) |
1,0 = what's playing, 0,n = stored preset n |
-
Reports from the amp: knob moved (3,0x37), block on/off (3,0x15), preset changed (3,0x38).
Presets are numbered with one running index, not banks.
-
Supported models: the amp's own model list comes from its DSP firmware. The phone app's catalogue has 13
extra models from other amps, and sending one of those crashes a Spark 2, so they're left out.
Help wanted
- Knob order. The amp knobs and the 6-band EQ are confirmed. For many effects the order of the parameters
isn't yet; those knobs show
·?. If you have an amp, the debug console's Explorer lets you sweep any parameter
index and hear what it does. Open an issue with what you find.
- Unknown fields: what the system-info and settings replies mean, the preset slot-state reply, and uploading a
whole preset
(1,0x01).
Repository
| Path |
Contents |
webapp/ |
The app: index.html (start here), spark2-core.js (protocol and amp engine), views/ (touch views), the classic UIs and the debug console |
docs/ |
Write-ups: PROTOCOL.md (wire format, opcode map, hardware results), FW-ANALYSIS.md, APP-ANALYSIS.md, PARAM-MAP.md, PEDAL-ANALYSIS.md |
data/ |
Derived facts: the model catalogue with parameter labels and defaults, opcode tables |
tools/ |
Small analysis scripts |
Unofficial community project. Not affiliated with or endorsed by Positive Grid.
"Spark", "Positive Grid" and "BIAS" are trademarks of their owner, used descriptively.
No firmware, app binaries, disassembly or artwork are distributed here, only derived facts and original code.