Open-source Windows desktop client for Baseus earbuds, built by reverse-engineering the official Baseus Android app.
Platform: Windows 10 1903+ (WinRT Bluetooth APIs)
| Model | Status | Battery | ANC | EQ | Game mode |
|---|---|---|---|---|---|
| Bass BP1 Pro ANC | ✅ Verified | ✅ L/R/case | ✅ 3-mode + strength | ✅ 4 presets | ✅ Low-latency toggle |
Only hardware-verified models are supported. Earlier drafts included Inspire XH1/XP1/XC1 support extracted from the Baseus Android APK, but since none was ever confirmed on a real device it has been removed rather than ship promises we can't back.
Own a different Baseus model? Adding it is the goal — see docs/re-methodology.md for how to capture your device's protocol and contribute it back. Protocol capture tooling to make this much easier is on the roadmap.
- Live L / R / case battery with charge state indicators
- Session timer (time since buds connected)
- ANC mode switching (Off / Active Noise Cancellation / Transparency) with strength slider
- Game / low-latency mode toggle
- EQ preset selection (Balanced / Bass Boost / Voice / Clear)
- Find-my-buds (plays a tone on one earbud)
- Low-battery desktop notifications
- Launch at login
# Prerequisites: Rust stable, Node.js, pnpm
pnpm install
pnpm tauri build
Or for development with hot-reload:
pnpm tauri dev
The reverse-engineering methodology and full packet tables live in docs/protocol/.
Frida hook scripts used to capture BLE writes are in docs/frida/.
See docs/re-methodology.md to add support for a new Baseus model —
each model is one file in crates/baseus-protocol/src/models/.
baseus_rebuild/
├── crates/
│ ├── baseus-protocol/ # Pure Rust: packet framing, types, per-model decoders
│ └── baseus-transport/ # WinRT BLE GATT transport
├── apps/
│ └── baseus-app/ # Tauri shell + SolidJS frontend
└── docs/
├── protocol/ # Packet tables and framing docs
└── frida/ # BLE capture scripts
This project is not affiliated with or endorsed by Baseus. All trademarks belong to their respective owners.
MIT