Oppzippy / OpenSCQ30

Cross platform application for controlling settings of Soundcore headphones. Supports desktop (CLI and GTK4 GUI), Android, and Web (PWA using Web Bluetooth).
https://oppzippy.github.io/OpenSCQ30/
GNU General Public License v3.0
86 stars 3 forks source link
android bluetooth bluetooth-low-energy desktop-application gtk4 jetpack-compose kotlin pwa react rust soundcore typescript web-bluetooth wireless-headphones

About

OpenSCQ30 is free software for controlling settings for the Soundcore Q30 headphones.

Supported Platforms

[x] Windows - Ready
[x] Linux - Ready
[x] Android - Ready
[x] Web - Ready
[ ] macOS - It compiles. It's untested beyond that. You should probably use the web client instead. I don't have a Mac, so there's not much I can do for the desktop client. If you're tring to get it working on macOS, see btleplug macOS build notes.

Supported Devices

It is intended that all devices in this list work, but since I do not own them all, I can not check. Please open an issue if you can confirm that any of the devices with "Unknown" status are working correctly.

Model Name Status
A3027 Life Q35 Working
A3028 Life Q30 Working
A3029 Life Tune Unknown
A3030 Life Tune Pro Unknown
A3031 Vortex Unknown
A3033 Life 2 Neo Unknown
A3033EU Life 2 Neo Unknown
A3926 Life Dot 2S Unknown
A3926Z11 Life Dot 2S Unknown
A3930 Liberty 2 Pro Unknown
A3931 Life Dot 2 NC Unknown
A3931XR Life Dot 2 XR Unknown
A3935 Life A2 NC Unknown
A3935W Life A2 NC Unknown
A3936 Space A40 Unknown
A3951 Liberty Air 2 Pro Unknown
A3945 Life Note 3S Unknown
A3933 Life Note 3 Unknown
A3939 Life P3 Working

Installing

Flathub

See GitHub Releases. All files are signed with my GPG key.

Demo

Desktop

Desktop GUI Demo.webm

Android

android-demo.webm

Building

Running Tests

just test will run all unit and integration tests. To run tests for a specific package, use just gui/ test for example.