{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/hammad-iftikhar/budsctl/blob/48d28a17c7ec68d03e9cc5754e57c65ab508242e/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "BudsCtl reconstructs SoundPEATS Air4 Pro GAIA V2 controls for a macOS menu bar app that changes noise mode and reads each earbud's battery level. Its documentation identifies the BLE service, command framing, and response behavior; a separate Samsung RFCOMM implementation draws on a cited protocol reference.",
  "description_zh": "BudsCtl 还原 SoundPEATS Air4 Pro 的 GAIA V2 控制指令，在 macOS 菜单栏中切换降噪模式并读取左右耳电量。文档说明 BLE 服务、命令帧及响应行为；另有依据外部协议资料实现的 Samsung RFCOMM 控制代码。",
  "entry_url": "https://awesomerea.org/resources/budsctl-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/budsctl-case/",
  "evidence_class": 1,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/hammad-iftikhar/budsctl/blob/48d28a17c7ec68d03e9cc5754e57c65ab508242e/README.md",
  "group": "cases",
  "id": "budsctl-case",
  "json_url": "https://awesomerea.org/resources/budsctl-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/budsctl-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/budsctl-case/index.md",
  "name": "BudsCtl: reconstructing SoundPEATS earbud controls",
  "name_zh": "BudsCtl：还原 SoundPEATS 耳机控制指令",
  "preview_kind": "image",
  "preview_url": "https://awesomerea.org/previews/budsctl-case.png",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "license"
  ],
  "requirements": [
    "Apple Silicon Mac running macOS 26 or newer, with paired earbuds and Bluetooth permission.",
    "SoundPEATS Air4 Pro is the hardware-confirmed model; the Samsung implementation has synthetic-byte unit tests but no reported hardware run.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要运行 macOS 26 或更新版本的 Apple Silicon Mac、已配对耳机和蓝牙权限。",
    "SoundPEATS Air4 Pro 是经实物确认的型号；Samsung 实现有合成字节单元测试，尚无实物运行记录。",
    "采用 MIT 许可证。"
  ],
  "scope": "partial",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/hammad-iftikhar/budsctl",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}