# Wave Buds: a client for the JBL Wave Buds control protocol

> Wave Buds implements an Android companion for the original JBL Wave Buds using a Bluetooth control protocol documented from the author's traffic captures. It controls ambient sound, equalization and touch settings, and its reference records GATT characteristics and command frames.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/3xa228148/wavebuds>
- Primary source: <https://github.com/3xa228148/wavebuds/blob/c33bb5769ef01eeb679b2854d63012902c6423b7/README.md>
- Catalog page: <https://awesomerea.org/resources/wave-buds-case/>
- Record JSON: <https://awesomerea.org/resources/wave-buds-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/wave-buds-case/index.md)

## Requirements & limits

- **Prerequisites:** Android 13 or newer and original JBL Wave Buds with product ID 0x2090.
- **Limits:** The author tested one phone and one pair of earbuds; firmware updates are unsupported.
- **License:** MIT license.

## Primary sources

1. <https://github.com/3xa228148/wavebuds/blob/c33bb5769ef01eeb679b2854d63012902c6423b7/README.md>
2. <https://github.com/3xa228148/wavebuds/blob/c33bb5769ef01eeb679b2854d63012902c6423b7/docs/PROTOCOL.md>

## More in Protocols

- [manifold-558s-ble: reconstructing testo 558s measurement messages](https://awesomerea.org/resources/manifold-558s-ble-case/index.md) · Case study
- [attackshark-x11prov2: decoding the X11 PRO V2 mouse configuration protocol](https://awesomerea.org/resources/attackshark-x11prov2-case/index.md) · Case study
- [AULA Hub: reconstructing the AULA F99 Pro keyboard protocol](https://awesomerea.org/resources/aula-hub-f99-protocol-case/index.md) · Case study
- [hpcs330: reconstructing the Hopoo spectrometer serial protocol](https://awesomerea.org/resources/hpcs330-case/index.md) · Case study
- [LB-M8 Settings: reconstructing Lingbao M8 mouse commands](https://awesomerea.org/resources/lb-m8-settings-case/index.md) · Case study
- [iMist: local diffuser control from a reconstructed Bluetooth protocol](https://awesomerea.org/resources/imist-diffuser-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.