https://github.com/shaunlwm/node-whatsapp-drive-extractor

💬 Download your backed up WhatsApp medias from Google Drive
https://github.com/shaunlwm/node-whatsapp-drive-extractor

google-drive-api whatsapp whatsapp-api whatsapp-parser

Last synced: 10 months ago
JSON representation

💬 Download your backed up WhatsApp medias from Google Drive

• Host: GitHub
• URL: https://github.com/shaunlwm/node-whatsapp-drive-extractor
• Owner: ShaunLWM
• License: mit
• Created: 2019-02-04T08:31:51.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-12-10T09:18:45.000Z (over 3 years ago)
• Last Synced: 2025-04-13T01:30:06.003Z (about 1 year ago)
• Topics: google-drive-api, whatsapp, whatsapp-api, whatsapp-parser
• Language: JavaScript
• Homepage:
• Size: 688 KB
• Stars: 26
• Watchers: 2
• Forks: 6
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# node-whatsapp-drive-extractor

[!["Monthly Download"](https://img.shields.io/npm/dm/node-whatsapp-drive-extractor.svg)](https://npmjs.org/package/node-whatsapp-drive-extractor)

[!["Latest Release"](https://img.shields.io/npm/v/node-whatsapp-drive-extractor.svg)](https://github.com/ShaunLWM/node-whatsapp-drive-extractor/releases/latest)

[![MIT license](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/ShaunLWM/node-whatsapp-drive-extractor/blob/master/LICENSE)

Download your synced WhatsApp medias from Google Drive backup

![script preview](https://i.imgur.com/KTnTeji.png)

## Requirement

- NodeJS v8~ ONLY (apparently there is some bug that prevents higher version of NodeJS from logging in to Google's servers)

- Retrieve your Device Id using [this](https://play.google.com/store/apps/details?id=com.evozi.deviceid)

- Tested on Node v8.16.2

## Usage

```

Usage:

        $ waex

Options

        --email, -e     Set your Google login email (compulsory)

        --password, -p  Set your Google password, Read troubleshooting if you have problem (compulsory)

        --phone, -n     Set your phone number (compulsory)

        --devid, -i     Set your device Id (compulsory)

        # either one of the commands below is needed

        --list, -l          List all available files to download

        --download, -d      Download all available files

        --output, -o        Directory to download media to. Use with --download (default: current directory)

        --debug             Print debugging message (default: false)

	Examples

        $ waex -e YOUR_EMAIL@gmail.com -p YOUR_PASSOWRD -n YOUR_PHONE -i YOUR_DEVICEID --list

        # app will login & will list all files to download

        $ waex -e YOUR_EMAIL@gmail.com -p YOUR_PASSOWRD -n YOUR_PHONE -i YOUR_DEVICEID --download

        # app will login & starts downloading all files to current directory

        $ waex -e YOUR_EMAIL@gmail.com -p YOUR_PASSOWRD -n YOUR_PHONE -i YOUR_DEVICEID --download --output "C:"

        # app will login & starts downloading all files to given output directory

        # WARNING: DO NOT end your output folder with "\" - example: "C:\" <- this wil cause a problem

```

## Instructions

1. `npm install -g node-whatsapp-drive-extractor` or `yarn global add node-whatsapp-drive-extractor`

2. Follow the usage stated above

OR

1. `npx node-whatsapp-drive-extractor [..options]`

## TODO

- None for now

## Troubleshooting

- If you are using 2FA on Google, you have to generate an [App Password](https://support.google.com/accounts/answer/185833?hl=en)

- Your phone number is your country code and phone number. When in doubt, view your Google Drive backup folders.

## Credits

- [YuriCosta/WhatsApp-GD-Extractor-Multithread](https://github.com/YuriCosta/WhatsApp-GD-Extractor-Multithread)

## License

MIT License - Copyright (c) 2020 Shaun