Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/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://github.com/oppzippy/openscq30
android bluetooth bluetooth-low-energy desktop-application gtk4 jetpack-compose kotlin pwa react rust soundcore typescript web-bluetooth wireless-headphones
Last synced: 11 days ago
JSON representation
Cross platform application for controlling settings of Soundcore headphones. Supports desktop (CLI and GTK4 GUI), Android, and Web (PWA using Web Bluetooth).
- Host: GitHub
- URL: https://github.com/oppzippy/openscq30
- Owner: Oppzippy
- License: gpl-3.0
- Created: 2022-11-10T07:12:00.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-10-27T01:03:53.000Z (12 days ago)
- Last Synced: 2024-10-27T02:17:52.439Z (12 days ago)
- Topics: android, bluetooth, bluetooth-low-energy, desktop-application, gtk4, jetpack-compose, kotlin, pwa, react, rust, soundcore, typescript, web-bluetooth, wireless-headphones
- Language: Rust
- Homepage: https://oppzippy.github.io/OpenSCQ30/
- Size: 4.22 MB
- Stars: 83
- Watchers: 4
- Forks: 3
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
## 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](https://github.com/deviceplug/btleplug#user-content-macos).
### 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 |
| A3030 | Life Tune Pro | 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 |
| A3951 | Liberty Air 2 Pro | Unknown |
| A3945 | Life Note 3S | Unknown |
| A3933 | Life Note 3 | Unknown |
| A3939 | Life P3 | Working |
## Installing
[](https://flathub.org/apps/com.oppzippy.OpenSCQ30)
[](https://apt.izzysoft.de/fdroid/index/apk/com.oppzippy.openscq30)
See [GitHub Releases](https://github.com/Oppzippy/OpenSCQ30/releases). All files are signed with [my GPG key](https://kylescheuing.com/publickey.txt).
## Demo
### Desktop
[Desktop GUI Demo.webm](https://user-images.githubusercontent.com/2236514/229958756-aaa2a6d3-e908-4195-aad6-b0bcfda139a8.webm)
### Android
[android-demo.webm](https://github.com/Oppzippy/OpenSCQ30/assets/2236514/2d351d63-64b8-4253-abdf-3bb5384888c1)
## Building
- Windows: [docs/build-windows.md](docs/build-windows.md)
- MacOS: [docs/build-macos.md](docs/build-macos.md)
- Linux: [docs/build-linux.md](docs/build-linux.md)
- Android: [docs/build-android.md](docs/build-android.md)
## Running Tests
`just test` will run all unit and integration tests. To run tests for a specific package, use `just gui/ test` for example.