Skip to content
Projects

Duelion/whatsapp-wrapped

View on GitHub

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.

How these counts are measured

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.

Data

README.md

Original

WhatsApp Wrapped Logo

Create beautiful Spotify Wrapped-style visualizations for your WhatsApp group chats!

Stars License Python

View Sample Report


WhatsApp Wrapped Preview


✨ 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!

Open In Colab

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) or irm 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 optional static dependencies)
  • --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

  1. Open WhatsApp → Go to your group chat
  2. Tap the group name → More → Export chat
  3. Choose "Without Media" for faster processing
  4. Save the .zip file 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]"

Buy Me A Coffee

Report Bug · Request Feature · ⭐ Star this project

Made with ❤️ for WhatsApp users who love data