GNOME Shell extension that provides control of Soundcore Life Q30 Headphones (and others)
Find a file
JordanViknar c02aee80e3
build: Enable support for GNOME Shell 49
Noiseclapper was (partially) tested on GNOME 49 and works seemingly perfectly fine with no other modifications necessary.
2025-09-22 23:58:47 +02:00
.github/workflows ci: Use cache 2024-10-24 13:21:02 +02:00
assets/screenshots feat: TypeScript port (#13) 2024-04-05 07:55:56 +00:00
locale style: Replace Xo with Biome 2024-10-24 12:58:32 +02:00
schemas refactor: General formatting 2024-04-05 15:48:41 +02:00
src style: Replace Xo with Biome 2024-10-24 12:58:32 +02:00
ui fix: Use Gtk.DropDown instead of Gtk.ComboBoxText 2024-04-05 15:49:15 +02:00
.gitignore feat: TypeScript port (#13) 2024-04-05 07:55:56 +00:00
ambient.d.ts style: Replace Xo with Biome 2024-10-24 12:58:32 +02:00
biome.json style: Replace Xo with Biome 2024-10-24 12:58:32 +02:00
bun.lockb build: Replace npm with Bun 2024-10-24 13:08:01 +02:00
CODE_OF_CONDUCT.md docs: Add "Contributor Covenant Code of Conduct" 2022-04-28 23:37:13 +02:00
LICENSE feat: TypeScript port (#13) 2024-04-05 07:55:56 +00:00
Makefile build: Replace npm with Bun 2024-10-24 13:08:01 +02:00
metadata.json build: Enable support for GNOME Shell 49 2025-09-22 23:58:47 +02:00
package.json style: Replace Xo with Biome 2024-10-24 12:58:32 +02:00
README.md docs: Add maintenance-only message 2025-09-15 12:10:24 +02:00
tsconfig.json style: Replace Xo with Biome 2024-10-24 12:58:32 +02:00

Noiseclapper (Soundcore Life for GNOME)

License Top language Commit activity Repo size
Get it on GNOME Extensions

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

Noiseclapper interface screenshot

What is Noiseclapper ?

Noiseclapper is a GNOME Shell extension that allows you to control some settings in your Soundcore Life headphones. Normally, the official way of doing this would be to use the official Android application 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.

Alternatively, you could use the SoundcoreDesktop application to modify those settings, but I find it unpractical to use. (OpenSCQ30 now exists as an alternative, and might be better suited for those looking for advanced configuration of their headphones.)

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

  • GNOME Shell 45+ (42 - 44 with previous versions of Noiseclapper)
  • Python 3
  • Bluetooth support on the computer
  • (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
  • TypeScript (and related dependencies, see package.json)
  • Blueprint v0.12.0 (or superior)

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 !