{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/JackWPP/MiPods/blob/eb1376e397fe557b9dcf94a260641d81b65f02d8/research/rea/findings.md",
    "https://github.com/JackWPP/MiPods/blob/eb1376e397fe557b9dcf94a260641d81b65f02d8/research/record/capture-analysis.md"
  ],
  "category": "community-case-studies",
  "class": "hardware",
  "description_en": "MiPods reconstructs Xiaomi earbuds control in a macOS menu-bar app using a recovered BLE GATT protocol. Its Swift core handles battery readings, device information and model-dependent noise controls, while research notes document hardware probes, vendor-app analysis and recording-transfer exchanges. A separate report describes REA-assisted analysis of Xiaomi's Mac app.",
  "description_zh": "MiPods 利用逆向得到的 BLE GATT 协议，在 macOS 菜单栏应用中实现小米耳机控制。Swift 核心读取电量和设备信息，并按机型提供降噪控制；研究记录涵盖真机探针、官方应用分析及录音传输交互。另有报告记载使用 REA 分析小米 Mac 应用。",
  "entry_url": "https://awesomerea.org/resources/mipods-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/mipods-case/",
  "evidence_class": 1,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/JackWPP/MiPods/blob/eb1376e397fe557b9dcf94a260641d81b65f02d8/README.md",
  "group": "rea",
  "id": "mipods-case",
  "json_url": "https://awesomerea.org/resources/mipods-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/mipods-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/mipods-case/index.md",
  "name": "MiPods: reconstructing Xiaomi earbuds control on macOS",
  "name_zh": "MiPods：在 macOS 上还原小米耳机控制",
  "preview_kind": "image",
  "preview_url": "https://awesomerea.org/previews/mipods-case.png",
  "record_type": "resource",
  "relationship": "community-reported-mixed-workflow",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "limits",
    "license"
  ],
  "requirements": [
    "macOS 14 or later with Bluetooth permission; building from source requires Xcode.",
    "The author reports full device testing on Xiaomi M2529E1; other models remain untested.",
    "Recording export remains outside the documented app features.",
    "AGPL-3.0."
  ],
  "requirements_zh": [
    "需要 macOS 14 或更新版本及蓝牙权限；源码构建需要 Xcode。",
    "作者报告已在 Xiaomi M2529E1 上完成真机测试；其他机型尚未实测。",
    "录音导出尚未列为应用已实现功能。",
    "许可证为 AGPL-3.0。"
  ],
  "scope": "partial",
  "targets": [
    "app",
    "protocol"
  ],
  "url": "https://github.com/JackWPP/MiPods",
  "verification": "source-reviewed",
  "verified_at": "2026-11-07"
}