{"id":29111780,"url":"https://github.com/al-chris/whatsapp-dashboard-web","last_synced_at":"2026-04-28T15:37:31.013Z","repository":{"id":301641982,"uuid":"1009773174","full_name":"al-chris/whatsapp-dashboard-web","owner":"al-chris","description":"A client-side only web application for analyzing and visualizing WhatsApp chat exports. This version runs entirely in your browser without requiring any server or backend - your data never leaves your device!","archived":false,"fork":false,"pushed_at":"2025-06-27T23:30:36.000Z","size":2614,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-28T00:20:09.223Z","etag":null,"topics":["data-visualization","javascript","whatsapp"],"latest_commit_sha":null,"homepage":"https://al-chris.me/whatsapp-dashboard-web/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/al-chris.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-27T17:28:00.000Z","updated_at":"2025-06-27T23:40:04.000Z","dependencies_parsed_at":"2025-06-28T00:30:19.108Z","dependency_job_id":null,"html_url":"https://github.com/al-chris/whatsapp-dashboard-web","commit_stats":null,"previous_names":["al-chris/whatsapp-dashboard-web"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/al-chris/whatsapp-dashboard-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/al-chris%2Fwhatsapp-dashboard-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/al-chris%2Fwhatsapp-dashboard-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/al-chris%2Fwhatsapp-dashboard-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/al-chris%2Fwhatsapp-dashboard-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/al-chris","download_url":"https://codeload.github.com/al-chris/whatsapp-dashboard-web/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/al-chris%2Fwhatsapp-dashboard-web/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32387913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T14:34:11.604Z","status":"ssl_error","status_checked_at":"2026-04-28T14:32:37.009Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-visualization","javascript","whatsapp"],"created_at":"2025-06-29T10:01:48.528Z","updated_at":"2026-04-28T15:37:30.969Z","avatar_url":"https://github.com/al-chris.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WhatsApp Chat Analysis Dashboard\n\n![logo](logo.png)\n\nA **client-side only** web application for analyzing and visualizing WhatsApp chat exports. This version runs entirely in your browser without requiring any server or backend - your data never leaves your device!\n\n## ✨ Features\n\n### 📈 Comprehensive Analytics\n- **Message Statistics**: Total messages, participants, date ranges, and daily averages\n- **Timeline Analysis**: Message frequency over time with daily, weekly, and monthly views\n- **Participant Activity**: Who sends the most messages with interactive charts\n- **Message Types**: Analysis of text, media, and system messages\n\n### 🎨 Advanced Visualizations\n- **Interactive Charts**: Built with Chart.js for smooth, responsive visualizations\n- **Activity Heatmap**: See when conversations are most active throughout the week\n- **Word Cloud**: Most frequently used words in horizontal bar chart format\n- **Emoji Analysis**: Top emojis used in conversations with usage statistics\n- **Response Time Analysis**: How quickly people respond to messages\n- **Conversation Starters**: Who initiates conversations most often\n\n### 🔍 Content Analysis\n- **Word Frequency**: Filter out common stop words to find meaningful terms\n- **Shared Links**: Analyze domains and websites shared in conversations\n- **Message Length**: Distribution of short vs long messages\n- **User-Specific Analytics**: Individual statistics for each participant\n\n### 🖥️ Modern UI/UX\n- **Clean Design**: Modern, responsive interface that works on all devices\n- **Drag \u0026 Drop**: Easy file upload with visual feedback\n- **Interactive Navigation**: Seamless switching between upload and dashboard views\n- **Tab-Based Content**: Organized content analysis with easy navigation\n\n## 🚀 Getting Started\n\n### Prerequisites\n- A modern web browser (Chrome, Firefox, Safari, Edge)\n- A WhatsApp chat export file (.txt format)\n\n### Installation\n1. **Download/Clone** this repository\n2. **Open** `index.html` in your web browser\n3. That's it! No installation required.\n\n### Using a Local Server (Recommended)\nFor best performance, serve the files through a local web server:\n\n**Using Python:**\n```bash\n\n# Python 3\npython -m http.server 8080\n\n# Then open http://localhost:8080 in your browser\n```\n\n**Using Node.js:**\n```bash\n# Install a simple server globally\nnpm install -g http-server\n\n# Start server\nhttp-server -p 8080\n\n# Open http://localhost:8080 in your browser\n```\n\n## 📱 How to Export WhatsApp Chats\n\n### On Android:\n1. Open WhatsApp and go to the chat you want to export\n2. Tap the three dots (⋮) in the top right\n3. Select **More** → **Export chat**\n4. Choose **Without media** (recommended for faster processing)\n5. Save the .txt file to your device\n\n### On iPhone:\n1. Open WhatsApp and go to the chat you want to export\n2. Tap the contact/group name at the top\n3. Scroll down and tap **Export Chat**\n4. Choose **Without Media** (recommended)\n5. Save the file or share it to where you can access it\n\n## 💻 Usage\n\n1. **Upload Your Chat**\n   - Drag and drop your exported chat file onto the upload zone\n   - Or click the upload zone to browse and select your file\n   - Supports both .txt and .zip files\n\n2. **View Analytics**\n   - Once uploaded, automatically switch to the dashboard\n   - Explore different sections: Overview, Timeline, Participants, etc.\n   - Use tabs in Content Analysis to switch between Word Cloud, Emojis, and Shared Links\n\n3. **Interactive Features**\n   - Hover over charts for detailed information\n   - Click legend items to show/hide data series\n   - Use time granularity controls for timeline analysis\n\n## 🛠️ Technical Details\n\n### Architecture\n- **Frontend**: Pure HTML5, CSS3, and vanilla JavaScript\n- **Charts**: Chart.js for all visualizations\n- **Parsing**: Custom JavaScript chat parser for WhatsApp format\n- **Storage**: All data processing happens in browser memory (no data persistence)\n\n### File Structure\n```\nwhatsapp-dashboard-web/\n├── index.html         # Main application file\n├── README.md          # This file\n├── js/\n│   ├── app.js         # Main application logic\n│   ├── charts.js      # Chart creation and management\n│   └── core/\n│       └── ChatParser.js  # WhatsApp chat parsing logic\n└── styles/\n    ├── main.css       # Main stylesheet\n    └── components.css # UI component styles\n```\n\n### Supported Chat Formats\n- **Languages**: English, Spanish, Portuguese, and other major languages\n- **Date Formats**: Various international date formats\n- **Message Types**: Text, media references, system messages\n- **Group Features**: Participant name changes, admin actions\n\n## 🔒 Privacy \u0026 Security\n\n- **100% Client-Side**: Your chat data never leaves your browser\n- **No Server Required**: No backend, database, or cloud storage\n- **No Data Collection**: We don't collect, store, or transmit any of your data\n- **Local Processing**: All analysis happens locally on your device\n\n## 🌟 Key Improvements over v1\n\n- **No Backend Required**: Completely client-side application\n- **Better Performance**: Faster loading and processing\n- **Enhanced UI**: More modern and responsive design\n- **New Analytics**: Additional metrics and visualizations\n- **Better Mobile Support**: Optimized for mobile devices\n- **Improved Parsing**: Better handling of various chat formats\n\n## 🎨 Customization\n\nThe application uses CSS custom properties for easy theming. Key colors:\n- Primary: `#25d366` (WhatsApp Green)\n- Secondary: `#128c7e` (Dark Green)\n- Background: `#f5f7fa` (Light Gray)\n\n## 🤝 Contributing\n\nThis is part of a larger WhatsApp Dashboard project. Contributions are welcome!\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Test thoroughly\n5. Submit a pull request\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## 🐛 Troubleshooting\n\n### Common Issues:\n\n**File won't upload:**\n- Ensure the file is a valid WhatsApp export (.txt)\n- Check that the file isn't corrupted\n- Try with a smaller chat export first\n\n**Charts not displaying:**\n- Ensure you're using a modern browser\n- Check browser console for JavaScript errors\n- Try refreshing the page\n\n**Slow performance:**\n- Large chat files (\u003e50MB) may take time to process\n- Consider exporting chats without media\n- Use a desktop browser for better performance\n\n**Date parsing issues:**\n- The parser supports most date formats\n- If dates aren't recognized, check the chat export format\n- Ensure the chat is exported in a supported language\n\n## 📞 Support\n\nIf you encounter issues or have questions:\n1. Check the troubleshooting section above\n2. Look for errors in the browser console (F12)\n3. Create an issue in the project repository\n\n---\n\n**Made with ❤️ for WhatsApp chat analysis**\n\n*This tool helps you understand your communication patterns while keeping your data completely private and secure.*\n\n**Created by [@al-chris](https://github.com/al-chris)**  \n*Last updated: 2025-06-25*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fal-chris%2Fwhatsapp-dashboard-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fal-chris%2Fwhatsapp-dashboard-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fal-chris%2Fwhatsapp-dashboard-web/lists"}