Duelion/whatsapp-wrapped
Duelion/whatsapp-wrapped has 135 GitHub stars and 13 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-20 01:55 UTC. Last push 2025-12-30.
What you can do
- 📈 Rich Analytics - 🎨 Interactive Charts - 👥 User Insights
- Message counts, patterns & emoji stats - Beautiful Plotly visualizations - Top contributors & activity sparklines
- 📅 Calendar Heatmaps - 📄 Multiple Formats - 🔒 100% Private
- Year-at-a-glance activity view - HTML (Desktop), Static HTML (Mobile) - All processing stays on your device
Measured star growth
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Generate beautiful visual reports for your WhatsApp chats. Message stats, emoji analysis, calendar heatmaps, and more. Privacy-first: runs on your device or Google Colab.
DataREADME.md
Original
Create beautiful Spotify Wrapped-style visualizations for your WhatsApp group chats!
✨ Features
| 📈 Rich Analytics | 🎨 Interactive Charts | 👥 User Insights |
| Message counts, patterns & emoji stats | Beautiful Plotly visualizations | Top contributors & activity sparklines |
| 📅 Calendar Heatmaps | 📄 Multiple Formats | 🔒 100% Private |
| Year-at-a-glance activity view | HTML (Desktop), Static HTML (Mobile) | All processing stays on your device |
🚀 Get Started in 60 Seconds
Option 1: Google Colab (Recommended)
Zero installation required — just upload your chat and get your report!
Option 2: Local Installation
# 1. Clone the project
git clone https://github.com/Duelion/whatsapp-wrapped.git && cd whatsapp-wrapped
# 2. Generate your report (uv auto-installs dependencies)
uv run whatsapp-wrapped your-chat.zip
💡 Don't have
uv? Install it:curl -LsSf https://astral.sh/uv/install.sh | sh(macOS/Linux) orirm https://astral.sh/uv/install.ps1 | iex(Windows)
Available Options:
--name "My Group 2024"- Custom report name and title displayed in the report--year 2024- Filter messages to a specific year--static- Generate mobile-friendly static HTML (requires optionalstaticdependencies)--output reports/- Custom output directory--quiet- Suppress progress messages--help- Show all available options
Optional: Static HTML Generation
For mobile-friendly reports that work without JavaScript, install the optional static HTML dependencies:
# Install with static HTML support
uv pip install -e ".[static]"
# Install Playwright's WebKit browser
uv run playwright install webkit
The --static flag will then generate a pre-rendered HTML file perfect for mobile devices.
💡 Note: On Linux, Playwright may require system dependencies. If you see a warning about missing dependencies, run:
sudo playwright install-deps webkit
📱 How to Export Your WhatsApp Chat
- Open WhatsApp → Go to your group chat
- Tap the group name → More → Export chat
- Choose "Without Media" for faster processing
- Save the
.zipfile and use it with WhatsApp Wrapped!
🔒 Privacy First
Your conversations never leave your device. WhatsApp Wrapped:
- ✅ Runs entirely offline (after install)
- ✅ Never uploads or shares your data
- ✅ Generates reports locally
📦 Installation Options
Basic Installation (Recommended)
The basic installation includes everything you need for interactive HTML reports:
# Using pip
pip install git+https://github.com/Duelion/whatsapp-wrapped.git
# Using uv (faster)
uv pip install git+https://github.com/Duelion/whatsapp-wrapped.git
With Optional Features
Static HTML Generation - For mobile-friendly reports without JavaScript:
pip install "git+https://github.com/Duelion/whatsapp-wrapped.git#egg=whatsapp-wrapped[static]"
playwright install webkit
Development - For contributors:
pip install "git+https://github.com/Duelion/whatsapp-wrapped.git#egg=whatsapp-wrapped[dev]"
Report Bug · Request Feature · ⭐ Star this project
Made with ❤️ for WhatsApp users who love data