Analyze your WhatsApp conversations with stunning visualizations and deep insights!
Ever wonder if that "busy" excuse is legit? WhatTrace exposes the cold, hard truth about your conversations:
- See exactly how long they left you on read
- Track ghosting patterns — is it always after you ask "what are we?"
- Identify who ghosts more in your conversations
- Get stats on those 24-hour+ silent treatments 💀
- Discover when they actually reply fastest (spoiler: probably not 3 AM)
- Find their peak response windows by hour
- Stop texting at times when you'll be left on read
- Pro tip: The data doesn't lie, but your situationship might 😅
- Response Time Analysis - Average, median, and distribution of response times
- Individual Response Patterns - Per-participant response time breakdown
- Conversation Initiators - Who starts conversations more often
- Best Time to Message - Optimal response windows by hour
- Conversation Enders - Who tends to end conversations
- Double Texting Analysis - Track consecutive messages (2x, 3x, 4x+)
- Ghost Periods - Identify ghosting patterns and durations
- Streak Analysis - Longest and average conversation streaks
- Conversation Gaps - Track periods of silence
- Keyword Clusters - Top words with smart stopword filtering
- Emoji Sentiment - Most used emojis with frequency
- Message Length Stats - Average characters and words per participant
- Punctuation Analysis - Questions and exclamations tracker
- Media Sharing - Track shared images, videos, and documents
- 24-Hour Activity Heatmap - Hourly messaging patterns
- Day of Week Trends - Which days are most active
- Monthly Trajectory - Long-term conversation trends
- Activity Personas - Night Owl, Morning Person, etc.
- Peak Activity Times - Busiest hours and days
- Dark Glassmorphism Theme - Premium neon-accented interface
- Interactive Charts - Built with Chart.js
- Mobile-Optimized - Fully responsive design
- Smooth Animations - Tilt effects and shimmer animations
- Intuitive Navigation - HUD-style statistics display
- Python 3.x OR Node.js
- Modern web browser (Chrome, Firefox, Safari, Edge)
Option 1: Using Python (Recommended)
# Clone the repository
git clone https://github.com/yourusername/whatsapp-chat-analyzer.git
cd whatsapp-chat-analyzer
# Start local server
python -m http.server 8000
# Open browser
# Navigate to: http://localhost:8000Option 2: Using Node.js
# Install http-server globally
npm install -g http-server
# Run server
http-server -p 8000- Open WhatsApp
- Go to the chat you want to analyze
- Tap ⋮ (three dots) → More → Export chat
- Choose "Without media"
- Save the
.txtfile
- Open WhatsApp
- Go to the chat you want to analyze
- Tap the contact/group name at the top
- Scroll down → Export Chat
- Choose "Without Media"
- Save the file (
.txtor.zip)
- Supports both
.txtand.zipfiles - Works with Android AND iPhone formats
- Drag & drop or click to upload
100% Privacy Guaranteed
- ✅ All processing happens locally in your browser
- ✅ No server uploads - your data never leaves your device
- ✅ No tracking or analytics
- ✅ No data storage - everything is cleared on page refresh
- ✅ Open source - audit the code yourself
- Frontend: Vanilla JavaScript (ES6 modules)
- Charts: Chart.js 4.4.0 with date-fns adapter
- Styling: Pure CSS with glassmorphism
- Effects: Vanilla-Tilt.js
- Fonts: Google Fonts (Outfit, Space Grotesk)
We love contributions! Whether it's bug fixes, new features, or documentation improvements.
-
Fork the repository
# Click the "Fork" button on GitHub -
Clone your fork
git clone https://github.com/YOUR-USERNAME/whatsapp-chat-analyzer.git cd whatsapp-chat-analyzer -
Create a new branch
git checkout -b feature/amazing-feature
-
Make your changes
- Follow the existing code style
- Test your changes thoroughly
- Update documentation if needed
-
Commit your changes
git add . git commit -m "Add: amazing new feature"
-
Push to your fork
git push origin feature/amazing-feature
-
Open a Pull Request
- Go to the original repository
- Click "New Pull Request"
- Select your branch
- Describe your changes
- Code Style: Use clean, readable JavaScript with meaningful variable names
- Comments: Add comments for complex logic
- Testing: Test with both Android and iPhone chat exports
- Mobile: Ensure changes work on mobile devices
- Performance: Keep the app fast and lightweight
- 🌍 Multi-language support for stopwords
- 📊 New analytics metrics (sentiment analysis, typing patterns)
- 🎨 Additional UI themes
- 📈 Export analysis to PDF/CSV
- 🔍 Search functionality within chats
- 🌙 Light mode theme
- ♿ Accessibility improvements
whatsapp-chat-analyzer/
├── index.html # Main HTML structure
├── styles.css # Glassmorphism styling
├── app.js # Main application orchestrator
├── parser.js # WhatsApp chat parser (Android + iPhone)
├── analytics.js # Analytics engine
├── visualizations.js # Chart.js visualizations
├── utils.js # Utility functions
└── README.md # You are here!
Found a bug? Have an idea? We'd love to hear from you!
- Bug Reports: Open an issue with details
- Feature Requests: Start a discussion
- Questions: Check existing issues or ask in discussions
This project is licensed under the MIT License - see the LICENSE file for details.
If you find this project useful, consider giving it a ⭐️ on GitHub!
- Chart.js - Beautiful charts
- Vanilla-Tilt.js - Smooth 3D effects
- Google Fonts - Typography
- All our contributors - Thank you! 💙
Made with ❤️ for better understanding your conversations