# PartyBox for Home Assistant: reconstructing JBL speaker control over Bluetooth

> PartyBox for Home Assistant replaces the JBL PartyBox phone app's control path with a Bluetooth client and MQTT entities. Its documented protocol was reconstructed from the JBL PartyBox Android app 3.14.20 and observed traffic, including command frames over GATT and ATT over classic Bluetooth.

- 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/BaggaBruh/jbl-partybox-ha>
- Primary source: <https://github.com/BaggaBruh/jbl-partybox-ha/blob/1591ee548e119d877a051612372090210dabb657/README.md>
- Catalog page: <https://awesomerea.org/resources/partybox-for-home-assistant-case/>
- Record JSON: <https://awesomerea.org/resources/partybox-for-home-assistant-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/partybox-for-home-assistant-case/index.md)

## Requirements & limits

- **Prerequisites:** Home Assistant OS or Supervised and a Bluetooth adapter within range of the speaker.
- **Testing evidence:** The author reports testing one PartyBox model on one Home Assistant OS installation; other models may differ.
- **License:** MIT license.

## Primary sources

1. <https://github.com/BaggaBruh/jbl-partybox-ha/blob/1591ee548e119d877a051612372090210dabb657/README.md>
2. <https://github.com/BaggaBruh/jbl-partybox-ha/blob/1591ee548e119d877a051612372090210dabb657/PROTOCOL.md>

## More in Protocols

- [carlinkit-cxx: Linux receiver for Carlinkit Auto Box USB messages](https://awesomerea.org/resources/carlinkit-cxx-case/index.md) · Case study
- [mchose-linux: MCHOSE HID settings protocol and Linux client](https://awesomerea.org/resources/mchose-hid-linux-case/index.md) · Case study
- [K1C CFS without official Creality firmware: CFS protocol client and Klipper integration](https://awesomerea.org/resources/k1c-cfs-klipper-case/index.md) · Case study
- [Open TechEd: reconstructing NanoDrop 1000 USB control](https://awesomerea.org/resources/open-teched-nanodrop-case/index.md) · Case study
- [douze: SSL 12 USB control protocol and Linux client](https://awesomerea.org/resources/douze-case/index.md) · Case study
- [Osmotic: a Mac client for DJI Osmo camera protocols](https://awesomerea.org/resources/osmotic-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.