Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/giacomoferretti/whatsapp-backup-downloader-decryptor
A tool to download encrypted WhatsApp backups from Google Drive and decrypt them locally.
https://github.com/giacomoferretti/whatsapp-backup-downloader-decryptor
android crypt15 google-drive google-drive-backup mcrypt1 mcrypt1-metadata python whatsapp whatsapp-backup
Last synced: 7 days ago
JSON representation
A tool to download encrypted WhatsApp backups from Google Drive and decrypt them locally.
- Host: GitHub
- URL: https://github.com/giacomoferretti/whatsapp-backup-downloader-decryptor
- Owner: giacomoferretti
- License: apache-2.0
- Created: 2024-11-07T10:49:04.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-11T14:09:41.000Z (about 1 month ago)
- Last Synced: 2024-12-14T19:21:06.955Z (9 days ago)
- Topics: android, crypt15, google-drive, google-drive-backup, mcrypt1, mcrypt1-metadata, python, whatsapp, whatsapp-backup
- Language: Python
- Homepage:
- Size: 43.9 KB
- Stars: 3
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# WhatsApp Backup Google Driver Downloader Decryptor
[](https://pypi.org/project/wabdd)
## Usage
### Using PyPi
1. Install the `wabdd` package
```shell
pip install wabdd
```
2. Get token
```shell
wabdd token [email protected]
```
3. Download backup
```shell
wabdd download --token-file /tokens/YOUR_GOOGLE_EMAIL_ADDRESS_token.txt
```
4. Decrypt backup
```shell
wabdd decrypt --key-file keys/PHONE_NUMBER_decryption.key dump backups/PHONE_NUMBER_DATE
```
### Prerequisites (only for poetry and docker)
1. Clone repository
```shell
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
```shell
poetry install
```
2. Get token
```shell
poetry run wabdd token [email protected]
```
3. Download backup
```shell
poetry run wabdd download --token-file /tokens/YOUR_GOOGLE_EMAIL_ADDRESS_token.txt
```
4. Decrypt backup
```shell
poetry run wabdd decrypt --key-file keys/PHONE_NUMBER_decryption.key dump backups/PHONE_NUMBER_DATE
```
### Using Docker
1. Build docker image
```shell
docker build . -t wabdd:0.1.3
```
2. Get token
```shell
docker run -it --rm --user $(id -u):$(id -g) -v $(pwd)/tokens:/tokens wabdd:0.1.3 token [email protected]
```
3. Download backup
```shell
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
```shell
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
```