search

KnugiHK / WhatsApp-Key-DB-Extractor

Allows WhatsApp users to extract their cipher key and databases on non-rooted Android devices.
Other
107 stars 6 forks source link

readme

WhatsApp Key/DB Extractor

Allows WhatsApp users to extract their cipher key and databases on non-rooted Android devices.

Crypt15 encrypted_backup.key is now supported!

CAUTION

By default, this script use the old WhatsApp APK from WhatsApp.com (in Web Archive), use it at your own risk.

APK Integrity

Checksum are as follows:

Source:

BRANCH UPDATES

v4.0 - Fixed issues with Android API 14-17 (4.0-4.2 Jelly Bean).
v4.1 - Added support for Android API 23 (6.0-6.0.1 Marshmallow).
v4.2 - Added support for specifying adb backup passwords.
v4.3 - Added PowerShell version as optional alternative to bat version.
v4.4 - Changed primary mirror for legacy apk.
v4.5 - Fixed issue pushing cipher key to emulated storage.
v4.6 - Updated primary mirror for legacy apk (again).
v4.7 - Added new sanity checks and support for Android API 24 (7.0 Nougat).
v5.0 - Fix the link of legacy apk.
v5.1 - Support Crypt15.

PREREQUISITES:

  1. O/S: Windows Vista, Windows 7, Windows 8, Windows 10, Mac OS X or Linux
  2. Java - If not installed: https://www.java.com/en/download/
  3. ADB (Android Debug Bridge) Drivers
  4. USB Debugging must be enabled on the target device. Settings -> Developer Options -> (Debugging) USB debugging
    If you cannot find Developer Options then please go to: Settings -> About phone/device and tap the Build number
    multiple times until you're finally declared a developer.
  5. Android device with Android 4.0 or higher. I.E. Ice Cream Sandwich, Jelly Bean, KitKat, Lollipop, Marshmallow or Nougat.

INSTRUCTIONS:

  1. Extract "WhatsApp-Key-DB-Extractor-master.zip" maintaining the directory structure.
  2. Click on "WhatsAppKeyDBExtract.bat" (Windows) or "WhatsAppKeyDBExtract.sh" (Mac OS X / Linux).
  3. Connect your device via USB, unlock your screen and wait for "Full backup" to appear.
  4. Enter your backup password or leave blank (if none set) and tap on "Back up my data".
  5. Confirm backup password in your command console and then check your "extracted" folder.

TROUBLESHOOTING:

  1. If you have never used USB Debugging before, you may also need to verify the fingerprint.
  2. If you have set a default backup password in your Android settings, then this MUST be the
    backup password that you PROVIDE when prompted to backup your data. Else it WILL fail!
  3. Linux and Mac OS X users may need to set the script permissions as executable. Depending on the
    adb permissions, you may also need to "sudo ./WhatsAppKeyDBExtract.sh" from your command console.
  4. If you're having issues with "WhatsAppKeyDBExtract.bat" then right click "WhatsAppKeyDBExtract.ps1"
    and select "Run with PowerShell". You may have to enter "y" at first run for execution policy.
  5. If you get an error saying "AES encryption not allowed" then you need to update your Oracle Java
    Cryptography Extension (JCE) to Unlimited Strength Jurisdiction Policy Files.

CREDITS:

AUTHOR: TripCode
THANKS: dragomerlin for Android Backup Extractor and Abinash Bishoyi for being cool.
abe.jar by nelenkov and its contributors.
tar.exe, grep.exe, regex2.dll, libintl3.dll, libiconv2.dll by Free Software Foundation and its contributors.
pcre3.dll by University of Cambridge and its contributors.
curl.exe by Daniel Stenberg and its contributors.
adb.exe, AdbWinApi.dll, AdbWinUsbApi.dll by The Android Open Source Project and its contributors.
SPDX-License-Identifier: Apache-2.0 OR GPL-3.0