WhatsApp Downloader

Download images and videos from a WhatsApp group chat.

Prerequisites

• Node.js 16+
• npm

Setup

npm install

Usage

npm start

1. Scan the QR code with WhatsApp on your phone (Settings → Linked Devices).
2. Search for a group name or press Enter to list all groups.
3. Select a group by number.
4. The tool fetches all messages and downloads every image/video into downloads/<date>/.

Session

Authentication is persisted in the session/ folder via LocalAuth. You will only need to scan the QR code once. To force re-authentication, delete the session/ folder.

Output

Files are named as <timestamp>_<sender>.<ext> and organized by date.

Notes

• Includes media sent by you (fromMe messages are no longer excluded).
• Failed downloads are retried up to 3 times before being skipped.
• Already-existing files are skipped.