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: about 1 month 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 (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-02-21T05:39:29.000Z (over 1 year ago)
- Last Synced: 2025-04-06T04:07:58.410Z (about 1 year 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.76 MB
- Stars: 110
- Watchers: 4
- Forks: 8
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
## About
OpenSCQ30 is free software for controlling settings for Soundcore headphones and earbuds. It was originally intended for the Soundcore Life Q30, after which the project was named, but a range of devices are now supported.
### Supported Platforms
[x] Windows - Ready
[x] Linux - Ready
[x] Android - Ready
### Supported Devices
| Model | Name |
| ----- | ---------------------------------- |
| A3004 | Soundcore Q20I |
| A3027 | Soundcore Life Q35 |
| A3028 | Soundcore Life Q30 |
| A3029 | Soundcore Life Tune |
| A3030 | Soundcore Life Tune Pro |
| A3031 | Soundcore Vortex |
| A3033 | Soundcore Life 2 Neo |
| A3035 | Soundcore Space One |
| A3040 | Soundcore Space Q45 |
| A3062 | Soundcore Space One Pro |
| A3116 | Soundcore Motion+ |
| A3909 | Soundcore Liberty 2 Pro |
| A3926 | Soundcore Life Dot 2S |
| A3930 | Soundcore Liberty 2 Pro+ |
| A3931 | Soundcore Life Dot 2 NC |
| A3933 | Soundcore Life Note 3 |
| A3935 | Soundcore Life A2 NC |
| A3936 | Soundcore Space A40 |
| A3939 | Soundcore Life P3 |
| A3945 | Soundcore Life Note 3S |
| A3947 | Soundcore Liberty 4 NC |
| A3948 | Soundcore A20i |
| A3949 | Soundcore P20i / P25i / R50i |
| A3951 | Soundcore Liberty Air 2 Pro |
| A3952 | Soundcore Liberty 3 Pro |
| A3955 | Soundcore P40i |
| A3957 | Soundcore Liberty 5 |
| A3959 | Soundcore P30i / Soundcore R50i NC |
## Installing
See [GitHub Releases](https://github.com/Oppzippy/OpenSCQ30/releases). All files are signed with [my GPG key](https://kylescheuing.com/publickey.txt).
[](https://flathub.org/apps/com.oppzippy.OpenSCQ30)
[](https://apt.izzysoft.de/fdroid/index/apk/com.oppzippy.openscq30)
[](https://repology.org/project/openscq30/versions)
## Mirrors
Issues and pull requests are accepted on both GitHub and Codeberg, although CI and releases are only on github.
- GitHub: https://github.com/Oppzippy/OpenSCQ30
- Codeberg: https://codeberg.org/Oppzippy/OpenSCQ30
## Contributing
### Code
See [docs/development.md](docs/development.md)
### Translations
[](https://translate.codeberg.org/engage/openscq30/)
## Demo
### Desktop
[desktop-demo.webm](https://github.com/user-attachments/assets/3df615f5-2e5d-44e8-9604-f5175c11ea5b)
### Android
[android-demo.webm](https://github.com/user-attachments/assets/bf48a9f3-db73-4f26-b1e7-edac5f3fba32)
## 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.