Skip to content

A tool to download encrypted WhatsApp backups from Google Drive and decrypt them locally.

License

Notifications You must be signed in to change notification settings

giacomoferretti/whatsapp-backup-downloader-decryptor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WhatsApp Backup Google Driver Downloader Decryptor

PyPI - Version

Usage

Using PyPi

  1. Install the wabdd package

    pip install wabdd

    or by using pipx

    pipx install wabdd
  2. Get token (change with your Google account email used in WhatsApp backup settings)

    wabdd token YOUR_GOOGLE@EMAIL.ADDRESS
    • If you need additional information, check the guide
  3. Download backup

    wabdd download --token-file /tokens/YOUR_GOOGLE_EMAIL_ADDRESS_token.txt

    or with filters (e.g. excluding videos)

    wabdd download --exclude "Media/WhatsApp Video/*" --token-file /tokens/YOUR_GOOGLE_EMAIL_ADDRESS_token.txt
    
  4. Decrypt backup (only if end-to-end encryption is enabled)

    wabdd decrypt --key-file keys/PHONE_NUMBER_decryption.key dump backups/PHONE_NUMBER_DATE

Getting the oauth_token

  1. Visit https://accounts.google.com/EmbeddedSetup
  2. Login using the Google account associated in the WhatsApp backup settings.
  3. You will get the following screen OAuth Step 1
  4. Now click on "I agree", the form will load indefinitely. OAuth Step 2
  5. Open the Developer Tools using F12, CTRL+SHIFT+I or by right-cliking the page > Inspect
  6. Now go to the Application tab, under Cookies select https://accounts.google.com
  7. Copy the value of the oauth_token cookie OAuth Step 3