wechat-dump

WeChat(微信), as the most popular mobile IM app in China, doesn't give users any method to export well-formatted history message. This tool can parse and export WeChat messages on a rooted android phone.

It can generate single-file html containing all the messages, including voice messages, images, emoji, etc.

NEWS: WeChat 6.0+ use silk to encode audio. The code is updated.

The latest version of WeChat uses a new avatar storage. Currently I don't have time investigating that. You're expected to see generated htmls without avatars. Contributions welcomed!

How to use:

Dependencies:

python-PIL
PyQuery
pysox
pysqlcipher
numpy
python-csscompressor (suggested, optional)
adb and rooted android phone connected to a Linux/Mac OS.
Silk audio decoder (just run ./third-party/compile_silk.sh)
gnu-sed

Get Necessary Data:

Get decrypted WeChat database (Linux & Mac Only):
- Automatic: ./android-interact.sh db-decrypt
  - Requires rooted adb. Available at https://play.google.com/store/apps/details?id=eu.chainfire.adbd&hl=en
- Manual:
  - Get /data/data/com.tencent.mm/MicroMsg/long-long-name/{EnMicroMsg.db,sfs/avatar.index} from root filesystem, possible ways are:
    - ./android-interact.sh db
    - Use your rooted file system manager app
  - Get WeChat uin, possible ways are:
    - ./android-interact.sh uin
    - Login to web wechat, get wxuin=1234567 from document.cookie
  - Get your phone IMEI number, possible ways are:
    - ./android-interact.sh imei
    - Call *#06# on your phone
    - Find IMEI in system settings
  - Decrypt database, will produce decrypted.db:
```
./decrypt-db.py <path to EnMicroMsg.db> <imei> <uin>
```

NOTE: you may need to try different ways to getting imei & uin, because things behave differently on different phones.

Also, if the decryption doesn't work with pysqlcipher, maybe try the version of sqlcipher in legacy.

Get WeChat user resource directory from your phone to resource directory:
- ./android-interact.sh res
- You might need to change the resource location in this script if the default doesn't work
- This takes a long time.

Run:

Parse and dump text messages of every contact (resource directory is not required to run this):

./dump-msg.py decrypted.db output_dir

Dump messages of one contact to rich-content html, containing voice messages, emojis, and images:

./dump-html.py decrypted.db avatar.index resource <contact name> output.html

Generate statistical report on text messages:

./count-message.sh message_dir

Examples:

See here for an example html.

Screenshots of generated html:

TODO List

Parse group messages. It doesn't work for now.
Use libchat as unified backend. Export all messages to libchat, and render messages from libchat
Search by uid/username
Skip existing files when copying android resources
Fix rare unhandled types: > 10000 and < 0
Use alias name in group chat, instead of id
Better user experiences... see grep 'TODO' wechat -R
more easy-to-use for non-programmers (GUI?)

Donate!

Paypal: