Unofficial Linux control software for the JBL Quantum 810 Wireless headset. You get noise cancelling, TalkThru, sidetone and RGB lighting without Windows or JBL's QuantumENGINE app.
It includes:
- QuantumEngine, a small desktop app that follows the headset live.
quantumenginectl, a command-line tool with JSON output for scripts.jbl-quantum, a Rust library for anyone building their own tools.
Everything talks to the USB dongle directly. It needs no background service, no root and no vendor software.
- See battery level, microphone state and the game/chat dial position
- Switch noise control: Off, ANC or TalkThru
- Set sidetone (hearing your own voice): Off, Low, Mid or High
- Turn the lights on or off
- Set colours, brightness and animation for the logo and ring lighting
EQ, spatial sound and the auto-off timer aren't supported yet.
| Headset | USB ID | Status |
|---|---|---|
| JBL Quantum 810 Wireless | 0ecb:2069 |
✅ tested |
| Other JBL Quantum models | — | ❌ not supported |
Other models may use a different protocol, so the tools refuse to talk to them rather than guess. If you own one and want to help add it, open an issue.
On Arch-based systems (Arch, CachyOS, EndeavourOS, Manjaro):
git clone https://github.com/sidmax7/QuantumEngine.git
cd QuantumEngine/quantum-linux/packaging
makepkg -siOn other distributions, with a Rust toolchain installed:
cd quantum-linux
cargo install --path crates/quantumengine
cargo install --path crates/quantumenginectl
sudo install -Dm644 udev/70-jbl-quantum.rules /etc/udev/rules.d/70-jbl-quantum.rules
sudo udevadm control --reloadThen unplug the dongle and plug it back in. Now start QuantumEngine from your app menu, or run a command:
quantumenginectl # show everything
quantumenginectl anc talkthru # switch to TalkThru
quantumenginectl lights offFull install notes, command reference and troubleshooting are in quantum-linux/README.md.
quantum-linux/
├── crates/
│ ├── jbl-quantum/ library: device protocol and headset API
│ ├── quantumenginectl/ command-line tool
│ └── quantumengine/ desktop app (egui)
├── udev/ device permission rule
└── packaging/ PKGBUILD and desktop entry
The dongle exposes a vendor-specific HID interface. Settings are read and written with HID feature reports, and the headset sends events when you use its physical controls. The protocol was worked out on Linux from the device itself, and every command the tools send has been tested on real hardware.
The firmware-update commands aren't defined anywhere in the code, so no bug in these tools can reach them.
This is an independent project and isn't affiliated with or endorsed by JBL or Harman International. "JBL" and "Quantum" are their trademarks. You use this software at your own risk.
Licensed under either the MIT license or the Apache License 2.0, whichever you prefer.