https://github.com/denvercoder1/whatsapp-group-wrapped
Create a summary of stats from a WhatsApp group export
https://github.com/denvercoder1/whatsapp-group-wrapped
Last synced: 2 months ago
JSON representation
Create a summary of stats from a WhatsApp group export
- Host: GitHub
- URL: https://github.com/denvercoder1/whatsapp-group-wrapped
- Owner: DenverCoder1
- License: mit
- Created: 2024-12-05T15:07:46.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-02-09T12:41:10.000Z (5 months ago)
- Last Synced: 2025-04-15T02:43:29.778Z (3 months ago)
- Language: JavaScript
- Size: 55.7 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WhatsApp Group Wrapped
Create a summary of stats from a WhatsApp group export
## Usage
1. Export a WhatsApp group chat from the WhatsApp app on your phone:
- Open the group chat
- Tap the 3 dots at the top, then "More > Export chat"
- Choose "Without media"
- Share the chat export to your computer
2. Make sure `node` is installed on your computer (https://nodejs.org/)
3. Copy `example.config.js` to `config.js` and fill in values as needed:
- Set `FILTERS.startDate` to contain the date you want to start counting messages from (ensure the year is correct)
- Set `FILTERS.endDate` to contain the date you want to stop counting messages from
- Set `TOP_COUNT` to the number of entries to show in the top lists
- Optionally, populate `TAG_TO_NAME` with a mapping of phone numbers to names using the provided format as an example
4. Run the following command in your terminal:
```bash
node main.js 'path/to/WhatsApp Chat with Group Name.txt'
```
Replace the path with the path to the exported chat file. If, for example, the chat file is in the same directory as the script and is named `chat.txt`, you would run:
```bash
node main.js 'chat.txt'
```
5. The script will output a summary of the chat to the terminal
## Example output
```
Top senders:
Jeffrey Thomas - 127 messages
Susan Smith - 91 messages
Eric Thomas - 65 messages
Arnold Palmer - 57 messages
Daryl Williams - 50 messages
Annie Levin - 21 messages
Top media senders:
Susan Smith - 64 messages with media
Jeffrey Thomas - 63 messages with media
Eric Thomas - 46 messages with media
Daryl Williams - 45 messages with media
Arnold Palmer - 24 messages with media
Doris Baker - 15 messages with media
Total messages with media: 339
Top question askers:
Jeffrey Thomas - 3 questions asked
Arnold Palmer - 3 questions asked
Eric Thomas - 2 questions asked
Daryl Williams - 1 questions asked
Amy Gross - 1 questions asked
Top taggers:
Susan Smith - 21 tags sent
Jeffrey Thomas - 11 tags sent
Joe Smith - 4 tags sent
Eric Thomas - 3 tags sent
Daryl Williams - 2 tags sent
Mary Williams - 2 tags sent
Top taggees:
Nancy Johnson - tagged 4 times
Daryl Williams - tagged 4 times
Joe Smith - tagged 3 times
Mary Williams - tagged 3 times
Eric Thomas - tagged 3 times
Annie Levin - tagged 2 times
Total messages: 579
Daily messages: 1.58
Message senders: 29
Top active hours of the day:
15:00 - 76 messages
14:00 - 63 messages
19:00 - 54 messages
12:00 - 47 messages
13:00 - 47 messages
17:00 - 42 messages
Top active days of the week:
Wednesday - 114 messages
Monday - 102 messages
Sunday - 99 messages
Tuesday - 91 messages
Friday - 87 messages
Thursday - 75 messages
Saturday - 11 messages
Top active months of the year:
January - 58 messages
September - 58 messages
July - 56 messages
June - 55 messages
November - 54 messages
October - 53 messages
February - 52 messages
August - 52 messages
April - 45 messages
March - 43 messages
May - 43 messages
December - 10 messages
Members who joined: 341
Total number of words sent: 7967
Average number of words per message: 36.55
Top words:
to - 320 times
and - 239 times
the - 226 times
a - 188 times
for - 167 times
up - 121 times
Top uncommon words:
tonight - 38 times
community - 35 times
everyone - 29 times
celebrate - 28 times
celebration - 27 times
excited - 26 times
Top emoji senders:
Arnold Palmer - 116 emojis
Jeffrey Thomas - 105 emojis
Susan Smith - 80 emojis
Daryl Williams - 54 emojis
Eric Thomas - 49 emojis
Amy Gross - 24 emojis
Top emojis:
🎉 - 29 times
📣 - 14 times
🕯️ - 12 times
🍷 - 11 times
🔥 - 8 times
🍕 - 7 times
```
## License
MIT License - see [LICENSE](LICENSE) for more details