How giacomoferretti/whatsapp-backup-downloader-decryptor works
wabdd is a command-line tool for obtaining Google Drive credentials, downloading WhatsApp end-to-end encrypted backups, and decrypting supported backup files. The user workflow is token creation, backup selection and download, then local decryption with a 64-digit key; downloading and decrypting are separate commands. The graph also shows the Google Drive API client and shared utilities. Source excerpts establish the command routing, authentication, backup listing, file processing, and decryption behavior; some download-worker details are omitted, so uncertain links are not inferred.
Main entry points: download.py Download command · token.py Token command · wabackup.py Drive client · decrypt.py Decrypt command
Components 16
CLI
- Command router
wabdd/__main__.py - Shared utilities
wabdd/utils.py - Runtime constants
wabdd/constants.py
Authentication
- Token command
wabdd/commands/token.py - Auth helper
wabdd/gpsoauth_helper.py - Token files
- Google auth
Backup download
- Download command
wabdd/commands/download.py - Drive client
wabdd/wabackup.py - Google Drive API
- Backup files
- Local backup
Decryption
- Decrypt command
wabdd/commands/decrypt.py - Crypt tools
- Decrypted files
Other components
- User
Connections 25
- User → Command router: runs commands
README.md - Command router → Token command: routes token
wabdd/__main__.py - Command router → Download command: routes download
wabdd/__main__.py - Command router → Decrypt command: routes decrypt
wabdd/__main__.py - User → Token command: provides cookie
wabdd/commands/token.py - Token command → Google auth: exchanges credentials
wabdd/commands/token.py - Token command → Auth helper: requests auth token
wabdd/commands/token.py - Auth helper → Google auth: requests Drive token
wabdd/gpsoauth_helper.py - Token command → Token files: writes tokens
wabdd/commands/token.py - User → Download command: starts download
README.md - Download command → Drive client: lists backup files
wabdd/commands/download.py - Download command → Backup files: collects file metadata
wabdd/commands/download.py - Drive client → Google Drive API: requests backup data
wabdd/wabackup.py - Google Drive API → Backup files: serves backup data
- Download command → Local backup: writes downloads
README.md - User → Decrypt command: provides key and dump
README.md - Decrypt command → Crypt tools: decrypts files
wabdd/commands/decrypt.py - Decrypt command → Local backup: reads backup
wabdd/commands/decrypt.py - Decrypt command → Decrypted files: writes results
wabdd/commands/decrypt.py - Download command → Shared utilities: uses helpers
wabdd/commands/download.py - Download command → Runtime constants: uses settings
wabdd/commands/download.py - Token command → Shared utilities: generates ID
wabdd/commands/token.py - Drive client → Auth helper: refreshes credentials
wabdd/wabackup.py - Drive client → Shared utilities: generates ID
wabdd/wabackup.py - Drive client → Runtime constants: sets user agent
wabdd/wabackup.py