{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/aaron-p1/fix-whxm4-voice/blob/d9c5138a814ec280f845a9ea8e5531703f06e8ee/docs/upload-protocol.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "fix-whxm4-voice creates replacement voice packs for Sony WH-1000XM4 headphones and uploads them over Bluetooth. Its research notes map the pack's language layout and trace Sony's app through the Airoha FOTA upload flow over Bluetooth Classic RFCOMM. The tool can download stock packs, convert replacement audio and install the result as a selected language.",
  "description_zh": "fix-whxm4-voice 为 Sony WH-1000XM4 耳机构建替换语音包，并通过蓝牙上传。研究笔记梳理了语音包的语言布局，以及 Sony 应用经 Bluetooth Classic RFCOMM 使用 Airoha FOTA 的上传流程。工具可下载原厂语音包、转换替换音频并按选定语言安装。",
  "entry_url": "https://awesomerea.org/resources/fix-whxm4-voice-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/fix-whxm4-voice-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/aaron-p1/fix-whxm4-voice/blob/d9c5138a814ec280f845a9ea8e5531703f06e8ee/README.md",
  "group": "cases",
  "id": "fix-whxm4-voice-case",
  "json_url": "https://awesomerea.org/resources/fix-whxm4-voice-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/fix-whxm4-voice-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/fix-whxm4-voice-case/index.md",
  "name": "fix-whxm4-voice: reconstructing WH-1000XM4 voice-pack upload",
  "name_zh": "fix-whxm4-voice：重建 WH-1000XM4 语音包上传流程",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Sony WH-1000XM4 headphones; the README reports testing on firmware 3.0.1.",
    "Linux with BlueZ and Nix, or macOS with Xcode command-line tools, Rust and ffmpeg.",
    "English cannot be replaced in the documented default workflow; the custom pack installs as German by default.",
    "MIT licence."
  ],
  "requirements_zh": [
    "需要 Sony WH-1000XM4 耳机；作者报告在 3.0.1 固件上测试。",
    "需要运行 BlueZ 和 Nix 的 Linux，或安装 Xcode 命令行工具、Rust 与 ffmpeg 的 macOS。",
    "所述默认流程无法替换英语语音；自定义语音包默认安装为德语。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/aaron-p1/fix-whxm4-voice",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}