Extract WhatsApp private key from any Android device (Android 7+ supported). This tool spawns a clean Android 6 emulator and attempts to register with your number to extract msgstore private key.
NOTE: this tool is in beta stage and might not be stable. You're more than welcome to improve this software by submitting a PR!
Any system running Python 2.7.x
- Mac OSX
- Windows
- Linux
You want to decrypt and/or extract msgstore.db database from your Android device.
- Install SDK with --install-sdk flag
- Attach Android device to USB port and launch WhatsDump
- Wait the script to quickly register your phone number on emulator
- Wait for SMS or CALL with confirmation code
- Input 6-digit confirmation code
- Private key is extracted in output/ directory
Flag | Behaviour | |
---|---|---|
--wa-phone | Required | WhatsApp phone number associated with msgstore database from which you will receive verification SMS (with prefix, ex. +393387182291 |
--wa-verify | Required | Phone verification method to use (SMS or CALL) |
--install-sdk | Optional | Installs Android SDK on android-sdk/ directory. This is mandatory to run WhatsDump |
--msg-store | Optional | Location of msgstore database to decrypt (or plug in device to USB port) |
--verbose | Optional | Show verbose (debug) output |
--show-emulator | Optional | Show emulator screen (by default headless) |
--no-accel | Optional | Disable hardware acceleration (very slow emulator) |
python whatsdump.py --wa-phone +15417543010 --wa-verify sms
python whatsdump.py --msgstore /path/to/msgstore.db --wa-phone +15417543010 --wa-verify sms
-
Java JDK must be installed (JAVA_HOME environment variable must be set)
-
Hardware acceleration must be enabled to run Emulator without issues
-
SIM card associated with msgstore.db to receive WhatsApp confirmation PIN (SMS or CALL)
-
Install all the Python library dependencies by running the following command:
pip install -r requirements.txt
- AndroidViewClient by dtmilano
- pure-python-adb by Swind