https://github.com/jordanviknar/noiseclapper-gnome
GNOME Shell extension that provides control of Soundcore Life Q30 Headphones (and others) [MAINTENANCE ONLY]
https://github.com/jordanviknar/noiseclapper-gnome
anker cancellation cancelling equalizer extension gnome headphones life noise q30 shell soundcore
Last synced: about 1 month ago
JSON representation
GNOME Shell extension that provides control of Soundcore Life Q30 Headphones (and others) [MAINTENANCE ONLY]
- Host: GitHub
- URL: https://github.com/jordanviknar/noiseclapper-gnome
- Owner: JordanViknar
- License: mpl-2.0
- Created: 2022-04-14T10:23:29.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-09-15T10:10:24.000Z (9 months ago)
- Last Synced: 2025-09-15T12:13:33.693Z (9 months ago)
- Topics: anker, cancellation, cancelling, equalizer, extension, gnome, headphones, life, noise, q30, shell, soundcore
- Language: TypeScript
- Homepage:
- Size: 518 KB
- Stars: 16
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Noiseclapper (Soundcore Life for GNOME)
## Disclaimer
This is an **unofficial** GNOME Shell extension, designed for use with Soundcore Life Q30 headphones (although it may work with other Soundcore headphones).
I am **not** partnered with Soundcore or Anker in any way.
> [!WARNING]
> Noiseclapper is currently only under basic maintenance. My own pair of Soundcore headphones broke, leaving me personally unable to do anything but GNOME version compatibility changes.
>
> **Pull requests** are still very much welcome, however.
## Screenshot
## What is Noiseclapper ?
Noiseclapper is a GNOME Shell extension that allows you to control some settings of your Soundcore Life headphones. Normally, the official way of doing this would be to use the [official Android application](https://play.google.com/store/apps/details?id=com.oceanwing.soundcore) through your smartphone, and then set the Active Noise Cancellation mode and the Equalizer settings from there. Problem : the application is **exclusive to Android**.
So what do you do when you're using a computer ?
Well, officially, you're supposed to use the NC button or "pet" the right side of the headphones to change those settings. Again, there is a problem : you cannot choose the Active Noise Cancellation mode you want to use, and the Equalizer settings are nowhere to be seen.
You may also check out [OpenSCQ30](https://github.com/Oppzippy/OpenSCQ30), which might be better suited for those looking for advanced configuration of their headphones, supports more Soundcore headphones, and works regardless of platform on Windows, Linux & Android.
This extension is meant to be a solution to all these issues. On top of having all the pros of being a GNOME Shell extension (no interface to clutter your active windows, easy to access), it also provides Linux support for the control of Soundcore Life headphones, including the current Active Noise Cancellation mode and the current Equalizer preset used.
## Supported Devices
| Soundcore Life Devices | Support |
| ---- | ---- |
| Life P3 | ✓ |
| Life Q35 | ? |
| Life Q30 | ✓ |
| Life Q20+ | ? |
| Life Q20 | ? |
| Life Q10 | ? |
| Life Q10 | ? |
If your device works despite not being marked as supported, don't hesitate to create an issue or a pull request.
## Requirements
- Hardware requirement : Bluetooth adapter (internal or external) and Soundcore Life headphones...
- GNOME Shell 45+ (there is a tag for older versions of Noiseclapper that work with GNOME Shell 42-44)
- Python 3
> [!NOTE]
> The Soundcore application must be inactive on your phone, else it will conflict for the control of your headphones with this extension.
### For development
- Make
- Bun
- Blueprint >= 0.12.0
## Bug Reports / Contributions / Suggestions
You can report bugs or suggest features by making an issue, or you can contribute to this extension directly by forking it and then sending a pull request. Any help will be very much appreciated. Thank you !