README.md

WhatsApp Viewer

Small tool to display chats from the Android msgstore.db database.

How to use

1. You need root access to your phone. If you don't know what it is: Wikipedia
2. Download your WhatsApp database and key files:

• /data/data/com.whatsapp/files/key
• /data/data/com.whatsapp/databases/msgstore.db
• /data/data/com.whatsapp/databases/wa.db

3. Open WhatsApp Viewer
4. File -> Open -> Select file
5. Select msgstore.db in the folder "extracted"
6. Leave account name empty, is was used for older versions of WhatsApp (crypt5)
7. Optional: If you want, you can import contact names from the wa.db file

Command line support

"WhatsApp Viewer.exe" -decrypt12 msgstore-2016-10-22.1.db.crypt12 whatsapp.cryptkey12 decrypted.db

You cannot see bigger images because only thumbnails are stored in the database.

Build (using Bazel)

# Replace with your Visual Studio installation directory
"C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" x86_amd64
# Unfortunately, I don't know a way to handle resource files inside the bazel script yet
rc.exe -fo resources\Resources.res resources\Resources.rc

bazel build //:whatsapp-viewer

Credits:

• TripCode for crypt12 support https://github.com/EliteAndroidApps/WhatsApp-Crypt12-Decrypter
• Whatsapp Xtract
• pwncrypt5.py https://github.com/aramosf/pwncrypt5/blob/master/pwncrypt5.py
• SQLite
• MD5 http://bobobobo.wordpress.com/2010/10/17/md5-c-implementation/
• UTF8 http://utfcpp.sourceforge.net/
• AES https://polarssl.org/aes-source-code
• Base64 http://www.adp-gmbh.ch/cpp/common/base64.html
• Zlib http://www.zlib.net/
• RapidJSON http://rapidjson.org/
• mbedtls https://github.com/ARMmbed/mbedtls