An open-source Android application for connecting and controlling Soundpeats Mini Pro HS earbuds. Built with Kotlin and Jetpack Compose, this app communicates directly via Bluetooth SPP (Serial Port Profile).
- Automatic Connection: Skips the manual device selection process by directly polling and verifying Bluetooth connections to the Soundpeats earbuds on launch.
- Real-time State Synchronization: Instantly queries and syncs the hardware's active state (ANC mode, Game mode, battery level) upon connection so the UI is always accurate.
- Advanced Parametric EQ (PEQ):
- Full 7-band configuration with precise 16-bit signed gain calculations.
- Direct 17-byte command packet transmission per frequency band (0x71-0x77).
- Automatically handles sequence execution, master EQ switch, and commit commands to prevent memory buffer overflows or earbud reboots.
- Device Control Toggles: Full read/write functionality for:
- ANC (Active Noise Cancellation) Modes: ANC On, ANC Off, Transparency
- Game Mode (Low Latency)
- Touch Controls (Enable/Disable)
- Modern UI: Built entirely with Jetpack Compose featuring a sleek, Material 3-inspired design.
This application was born out of frustration with the official Soundpeats app. Most users just want to adjust their hardware settings without jumping through hoops.
- No Accounts Required: The official app requires account creation and cloud login just to switch basic modes—a requirement that makes little sense for local hardware control.
- Privacy-First: Constant data syncing for a pair of earbuds is an unnecessary attack on user privacy. This app requires zero accounts, zero internet access, and collects zero data.
- Direct Control: It communicates directly with your device, the way Bluetooth hardware was meant to be used.
- Language: Kotlin
- UI Framework: Jetpack Compose (Material 3)
- Minimum SDK: 26 (Android 8.0)
- Target SDK: 34 (Android 14)
- Communication Protocol: Bluetooth RFCOMM / SPP (Hex packet transmission)
- Target Chipset: WuQi WQ7033 (Found in Soundpeats Mini Pro HS)
- Android Studio (latest recommended)
- An Android device running Android 8.0+
- Soundpeats Mini Pro HS earbuds (paired to your device)
- Clone the repository:
git clone https://github.com/yourusername/soundpeats-controller.git
- Open the project in Android Studio.
- Sync the Gradle files.
- Build and run the app on your physical Android device. (Bluetooth features cannot be tested on an emulator).
The app requires the following permissions to discover, connect, and communicate with your earbuds:
BLUETOOTHandBLUETOOTH_ADMIN(Legacy)BLUETOOTH_SCAN,BLUETOOTH_ADVERTISE,BLUETOOTH_CONNECT(Android 12+)
This is an unofficial, open-source application and is not affiliated with, maintained, authorized, endorsed, or sponsored by Soundpeats. It uses reverse-engineered Bluetooth commands specific to the WuQi WQ7033 chipset. Use at your own risk.
Contributions, issues, and feature requests are welcome! If you have different Soundpeats models (e.g., Air3, Engine4) and want to help expand compatibility, please feel free to submit a pull request or open an issue.