# WeChat: recovering macOS chat databases for HTML export

> The WeChat export investigation recovers chat data from WeChat 4.x for macOS. A Frida hook captures keys passed to CommonCrypto's CCCryptorCreate; Python scripts match the per-database keys to SQLCipher stores, decrypt the files, parse contact and message tables, and generate browser-readable HTML. The documentation records database paths and message-layout differences.

- Type: Case study
- Targets: App
- 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/patients760/wechat-export>
- Primary source: <https://github.com/patients760/wechat-export/blob/783b4a5cd4f71ffa4c36604e9f4a49b219fa3ad9/README.md>
- Catalog page: <https://awesomerea.org/resources/wechat-export-case/>
- Record JSON: <https://awesomerea.org/resources/wechat-export-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/wechat-export-case/index.md)

## Requirements & limits

- **Prerequisites:** Requires WeChat 4.x on macOS 13+ with access to the user's local databases.
- **Prerequisites:** Requires Python 3.10+, Frida and the sqlcipher CLI; Frida injection may require SIP changes or signing authorization.
- **Scope:** The project specifies personal study, research and backup of one's own chat data.
- **License:** No licence file in the repository.

## Primary sources

1. <https://github.com/patients760/wechat-export/blob/783b4a5cd4f71ffa4c36604e9f4a49b219fa3ad9/README.md>
2. <https://github.com/patients760/wechat-export/blob/783b4a5cd4f71ffa4c36604e9f4a49b219fa3ad9/article_reddit.md>

## More in Apps

- [led-hue-cycle: reconstructing LEDDMX strip control over BLE](https://awesomerea.org/resources/led-hue-cycle-case/index.md) · Case study
- [OPPO 移动电源助手: reconstructing power bank control on macOS](https://awesomerea.org/resources/oppo-powerbank-mac-case/index.md) · Case study
- [LaMetric TIME Recovery Toolkit: recovering the clock setup API](https://awesomerea.org/resources/lametric-time-recovery-case/index.md) · Case study
- [AvellSucks: reconstructing Avell laptop EC controls](https://awesomerea.org/resources/avellsucks-case/index.md) · Case study
- [PodFlick: reconstructing iPod Video library editing](https://awesomerea.org/resources/podflick-case/index.md) · Case study
- [Vcf-compiler: reconstructing the VCutWorks VCF file format](https://awesomerea.org/resources/vcf-compiler-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.