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

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WhatsApp Backup Google Driver Downloader Decryptor

PyPI - Version

Usage

Using PyPi

  1. Install the wabdd package

    pip install wabdd
  2. Get token

    wabdd token YOUR_GOOGLE@EMAIL.ADDRESS
  3. Download backup

    wabdd download --token-file /tokens/YOUR_GOOGLE_EMAIL_ADDRESS_token.txt
  4. Decrypt backup

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

Prerequisites (only for poetry and docker)

  1. Clone repository

    git clone https://github.com/giacomoferretti/whatsapp-backup-downloader-decryptor
  2. Write down your backup decryption key

    • RECOMMENDED: create a folder named keys and store your key there

Using Poetry

  1. Install dependencies

    poetry install
  2. Get token

    poetry run wabdd token YOUR_GOOGLE@EMAIL.ADDRESS
  3. Download backup

    poetry run wabdd download --token-file /tokens/YOUR_GOOGLE_EMAIL_ADDRESS_token.txt
  4. Decrypt backup

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

Using Docker

  1. Build docker image

    docker build . -t wabdd:0.1.3
  2. Get token

    docker run -it --rm --user $(id -u):$(id -g) -v $(pwd)/tokens:/tokens wabdd:0.1.3 token YOUR_GOOGLE@EMAIL.ADDRESS
  3. Download backup

    docker run -it --rm --user $(id -u):$(id -g) -v $(pwd)/backups:/backups -v $(pwd)/tokens:/tokens wabdd:0.1.3 download --token-file /tokens/YOUR_GOOGLE_EMAIL_ADDRESS_token.txt
  4. Decrypt backup

    docker run -it --rm --user $(id -u):$(id -g) -v $(pwd)/backups:/backups -v $(pwd)/keys:/keys wabdd:0.1.3 decrypt --key-file keys/PHONE_NUMBER_decryption.key dump backups/PHONE_NUMBER_DATE