# fix-whxm4-voice: reconstructing WH-1000XM4 voice-pack upload

> 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.

- 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/aaron-p1/fix-whxm4-voice>
- Primary source: <https://github.com/aaron-p1/fix-whxm4-voice/blob/d9c5138a814ec280f845a9ea8e5531703f06e8ee/README.md>
- Catalog page: <https://awesomerea.org/resources/fix-whxm4-voice-case/>
- Record JSON: <https://awesomerea.org/resources/fix-whxm4-voice-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/fix-whxm4-voice-case/index.md)

## Requirements & limits

- **Prerequisites:** Sony WH-1000XM4 headphones; the README reports testing on firmware 3.0.1.
- **Prerequisites:** Linux with BlueZ and Nix, or macOS with Xcode command-line tools, Rust and ffmpeg.
- **Limits:** English cannot be replaced in the documented default workflow; the custom pack installs as German by default.
- **License:** MIT licence.

## Primary sources

1. <https://github.com/aaron-p1/fix-whxm4-voice/blob/d9c5138a814ec280f845a9ea8e5531703f06e8ee/README.md>
2. <https://github.com/aaron-p1/fix-whxm4-voice/blob/d9c5138a814ec280f845a9ea8e5531703f06e8ee/docs/upload-protocol.md>

## More in Protocols

- [OrangeCar: reconstructing the wired CarPlay phone side](https://awesomerea.org/resources/orangecar-case/index.md) · Case study
- [AirDrop-for-Everything: reimplementing AirDrop file transfer](https://awesomerea.org/resources/airdrop-for-everything-case/index.md) · Case study
- [IQOS Bar: a USB HID client for IQOS ILUMA usage counters](https://awesomerea.org/resources/iqos-bar-case/index.md) · Case study
- [Chorus: reconstructing Logitech Harmony remote programming](https://awesomerea.org/resources/chorus-harmony-remote-case/index.md) · Case study
- [tinycoral: reconstructing the Coral Edge TPU instruction set and USB runtime](https://awesomerea.org/resources/tinycoral-edge-tpu-case/index.md) · Case study
- [ninebot-go: reconstructing Ninebot app cloud communication](https://awesomerea.org/resources/ninebot-go-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.