{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/BaggaBruh/jbl-partybox-ha/blob/1591ee548e119d877a051612372090210dabb657/PROTOCOL.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "PartyBox for Home Assistant 通过蓝牙客户端和 MQTT 实体控制 JBL PartyBox 音箱。项目依据 JBL PartyBox Android 应用 3.14.20 及通信观察还原协议，记录了 GATT 命令帧和经典蓝牙上的 ATT 连接方式。",
  "entry_url": "https://awesomerea.org/resources/partybox-for-home-assistant-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/partybox-for-home-assistant-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/BaggaBruh/jbl-partybox-ha/blob/1591ee548e119d877a051612372090210dabb657/README.md",
  "group": "cases",
  "id": "partybox-for-home-assistant-case",
  "json_url": "https://awesomerea.org/resources/partybox-for-home-assistant-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/partybox-for-home-assistant-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/partybox-for-home-assistant-case/index.md",
  "name": "PartyBox for Home Assistant: reconstructing JBL speaker control over Bluetooth",
  "name_zh": "PartyBox for Home Assistant：还原 JBL 音箱的蓝牙控制协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "license"
  ],
  "requirements": [
    "Home Assistant OS or Supervised and a Bluetooth adapter within range of the speaker.",
    "The author reports testing one PartyBox model on one Home Assistant OS installation; other models may differ.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Home Assistant OS 或 Supervised，以及处于音箱通信范围内的蓝牙适配器。",
    "作者报告仅在一款 PartyBox 音箱和一套 Home Assistant OS 环境中测试；其他型号可能存在差异。",
    "许可证为 MIT。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/BaggaBruh/jbl-partybox-ha",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}