91 lines
3.5 KiB
Markdown
91 lines
3.5 KiB
Markdown
## Dump WeChat Messages from Android
|
|
|
|
## 导出安卓微信聊天数据
|
|
|
|
WeChat(微信), as the most popular mobile IM app in China, failed to allow users to export well-formatted chat history.
|
|
This tool can parse and export WeChat message history on a rooted android phone.
|
|
|
|
It can generate single-file html containing all the messages, including voice message, image, emoji, etc.
|
|
|
|
__NEWS__: WeChat 6.0+ use silk to encode audio. The code is updated.
|
|
|
|
### How to use:
|
|
|
|
#### Dependencies:
|
|
+ python-PIL
|
|
+ [PyQuery](https://pypi.python.org/pypi/pyquery/1.2.1)
|
|
+ [pysox](https://pypi.python.org/pypi/pysox/0.3.6.alpha)
|
|
+ [pysqlcipher](https://pypi.python.org/pypi/pysqlcipher)
|
|
+ numpy
|
|
+ python-csscompressor(optional)
|
|
+ adb and rooted android phone connected to PC
|
|
+ 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](https://wx.qq.com), 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](http://ppwwyyxx.com/static/wechat/example.html) for an example html.
|
|
|
|
Screenshots of generated html:
|
|
|
|
|
|
|
|
### TODO
|
|
+ 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:
|
|
<a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=7BC299GRDLEDU&lc=US&item_name=wechat%2ddump&item_number=wechat%2ddump¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" alt="[paypal]" /></a>
|