WhatsApp Wrapped: Your Privacy-First Chat Analytics Tool
WhatsApp has become an integral part of our daily communication, but what if you could gain insights into your conversations? WhatsApp Wrapped offers a unique way to visualize your chat data with rich analytics, interactive charts, and privacy-first processing. Whether you're curious about your group's activity or want to explore your own messaging habits, WhatsApp Wrapped is the tool you need.
What is WhatsApp Wrapped?
WhatsApp Wrapped is an open-source project created by Duelion. It generates beautiful visual reports for your WhatsApp chats, offering insights like message stats, emoji analysis, calendar heatmaps, and more. The project is trending now because it combines powerful analytics with a strong emphasis on user privacy. All processing happens on your device or in Google Colab, ensuring that your data remains private and secure.
Key Features
WhatsApp Wrapped boasts a range of features that make it stand out:
- Rich Analytics: Get detailed message counts, patterns, and emoji statistics.
- Interactive Charts: Enjoy beautiful Plotly visualizations that bring your data to life.
- User Insights: Discover top contributors and activity sparklines within your chat.
- Calendar Heatmaps: View a year-at-a-glance activity view to see when your group is most active.
- Multiple Formats: Choose between interactive HTML for desktop and static HTML for mobile.
- 100% Private: All processing stays on your device, ensuring your conversations remain private.
Use Cases
WhatsApp Wrapped shines in various real-world scenarios:
- Group Activity Analysis: Quickly understand the activity patterns of your WhatsApp group. Identify peak times and the most active members.
- Personal Insights: Gain insights into your own messaging habits. See how often you use certain emojis or how active you are in different groups.
- Event Planning: Use the calendar heatmaps to plan events or meetings when the group is most active.
- Content Creation: Create engaging content for social media by sharing interesting insights about your group's activity.
Step-by-Step Installation & Setup Guide
Option 1: Google Colab (Recommended)
The easiest way to get started is through Google Colab. No installation is required — just upload your chat and generate your report.
# Open in Google Colab
https://colab.research.google.com/github/Duelion/whatsapp-wrapped/blob/main/whatsapp_wrapped.ipynb
Option 2: Local Installation
For local installation, follow these steps:
# 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
If you don't have uv, you can install it with the following commands:
# For macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# For Windows
irm https://astral.sh/uv/install.ps1 | iex
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
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
WhatsApp Wrapped prioritizes your privacy:
- Runs entirely offline (after install)
- Never uploads or shares your data
- Generates reports locally
Real Code Examples from the Repository
Example 1: Basic Report Generation
Here's a basic example of generating a report using the uv command:
# Generate a report from your-chat.zip
uv run whatsapp-wrapped your-chat.zip
This command processes the chat data and generates an interactive HTML report.
Example 2: Custom Report with Options
You can customize your report with various options. For instance, to generate a report for a specific year and save it to a custom directory, use the following command:
# Generate a custom report
uv run whatsapp-wrapped your-chat.zip --name "My Group 2024" --year 2024 --output reports/
Example 3: Static HTML Generation
For mobile-friendly reports, you can generate static HTML files using the --static flag:
# Generate a static HTML report
uv run whatsapp-wrapped your-chat.zip --static
Advanced Usage & Best Practices
- Regular Updates: Keep WhatsApp Wrapped updated to benefit from the latest features and improvements.
- Data Backup: Always keep backups of your chat data before processing to avoid data loss.
- Explore Options: Experiment with different options to tailor the reports to your needs.
Comparison with Alternatives
| Feature/Tool | WhatsApp Wrapped | Alternative A | Alternative B |
|---|---|---|---|
| Privacy | Runs locally, 100% private | Cloud-based, data upload required | Partially private, some data upload |
| Ease of Use | Google Colab & Local options | Complex setup | Moderate setup |
| Visualization | Rich, interactive plots | Basic charts | Limited visualizations |
| Customization | High | Low | Moderate |
FAQ
-
How do I export my WhatsApp chat?
- Open WhatsApp, go to your group chat, tap the group name, select More → Export chat, choose "Without Media", and save the
.zipfile.
- Open WhatsApp, go to your group chat, tap the group name, select More → Export chat, choose "Without Media", and save the
-
Is WhatsApp Wrapped free?
- Yes, WhatsApp Wrapped is completely free and open-source.
-
Can I use WhatsApp Wrapped on my mobile device?
- Yes, you can generate mobile-friendly static HTML reports using the
--staticflag.
- Yes, you can generate mobile-friendly static HTML reports using the
-
How do I install
uv?- For macOS/Linux, use
curl -LsSf https://astral.sh/uv/install.sh | sh. For Windows, useirm https://astral.sh/uv/install.ps1 | iex.
- For macOS/Linux, use
-
Is my data safe with WhatsApp Wrapped?
- Absolutely! WhatsApp Wrapped processes all data locally and never uploads or shares your conversations.
Conclusion
WhatsApp Wrapped is a powerful tool for analyzing your WhatsApp chats, offering rich insights while prioritizing your privacy. Whether you're a data enthusiast or just curious about your group's activity, WhatsApp Wrapped is the perfect solution. Give it a try today by visiting the GitHub repository and start exploring your chat data in a whole new way!
