WeChatExporter

Native desktop app to export your own WeChat chat history locally. No cloud upload, no key exfiltration.

中文文档: README.md

Download

Get the latest build from GitHub Releases:

Platform	File	Notes
macOS (Apple Silicon / Intel)	WeChatExporter-macOS-universal.dmg	Drag to Applications (universal, native on both)
macOS (alt)	WeChatExporter-macOS-universal.zip	Extract and open .app
Windows (x64)	WeChatExporter-Windows-x64.zip	Self-contained, no .NET install

Features

• GUI: search, multi-select contacts/groups
• Bundled wx-cli (no separate CLI install)
• Readiness banner for first-time setup
• Optional media export (best-effort)
• Voice transcription (both platforms, offline): export-time speech-to-text via bundled SILK decoder + whisper.cpp; results saved as .transcript.txt sidecars and shown in collapsible HTML blocks; auto-skipped when whisper.cpp is missing
• Image OCR (both platforms, offline): local OCR of exported images (macOS Vision / Windows Media OCR, offline); results saved as .ocr.txt sidecars and shown in collapsible HTML blocks
• Chat statistics report (both platforms): single-file HTML report (message counts, top senders, 24-hour activity, monthly trend, media breakdown), generated locally, no external dependencies
• Incremental export (both platforms, off by default): remembers a timestamp cursor per "contact + export directory"; next export keeps only new messages, contacts with no new messages are skipped
• Index page + full-text search (both platforms): generates index.html in the export directory with a file list and a keyword search box (embedded text data, fully offline)
• Export watermark (both platforms, on by default): tiled visual watermark on export artifacts; customizable watermark text (default "Lin MinHao Technology Group Co., Ltd.", editable in Settings); slanted overlay + copyright line on HTML files, copyright footer in EPUB, diagonal watermark on every PDF page, dark tiled overlay on the Windows print-optimized HTML; turn the switch off for a watermark-free export — fully offline, zero third-party dependencies
• Encrypted export (both platforms, off by default): set an export password in Settings; the whole export directory is sealed into a single .wxenc file (PBKDF2-SHA256 100k rounds + AES-256-GCM) and the plaintext is deleted; decrypt on either platform later with the password — fully offline, zero third-party dependencies
• E-book / document export (both platforms): builds readable documents directly from chat.json — zero dependencies, fully offline. EPUB (Contact_chat.epub, hand-rolled stored-ZIP, grouped by month with sender + timestamp) plus a document edition (A4 PDF on macOS via CoreText/PingFang SC; A4 print-optimized HTML on Windows, printable or save-as-PDF)
• Export TXT / CSV / JSON

Requirements

macOS

• macOS 13+, Apple Silicon (arm64) + Intel (x86_64), universal binary
• WeChat Mac 4.x, logged in
• SIP disabled for key capture

Windows

• Windows 10/11 x64
• WeChat PC 4.x, logged in
• Run as Administrator recommended for first setup

Quick Start

1. Download the release for your platform
2. Open the app
3. Click Prepare Data (first time only)
4. Select chats and click Export

Build from Source

# macOS
./build_app.sh
bash scripts/create_dmg.sh

# Windows
cd windows && ./build.ps1

Contributing

See CONTRIBUTING.md. Please use issue templates for bugs and feature requests.

Disclaimer

For personal backup of your own data only. WeChat schema may change; compatibility not guaranteed.

License

MIT