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.

• python-PIL
• PyQuery
• pysox
• numpy
• python-csscompressor(optional)
• adb and rooted android phone connected to PC
• gnu-sed
• Silk audio decoder (just run ./third-party/compile_silk.sh)

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

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

• 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 resource <contact name> output.html

• Generate statistical report on text messages:

./count-message.sh message_dir

See here for an example html.

Screenshots of generated html:

• 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?)

This tool is still under development and testing, therefore it might not work very well on every device.

Use this software at your own risk. The author is not responsible for any potential damage/loss/privacy issues related to the use of this tool.