{"id":25774133,"url":"https://github.com/adity-star/whatsapp-chat-analyzer","last_synced_at":"2026-05-06T13:06:01.840Z","repository":{"id":276509299,"uuid":"929487957","full_name":"Adity-star/Whatsapp-chat-analyzer","owner":"Adity-star","description":"Analysis your whatsapp group chat or personal chat and give a detailed report of it","archived":false,"fork":false,"pushed_at":"2025-02-26T14:49:19.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-26T15:39:50.788Z","etag":null,"topics":["analysis","eda","streamlit","whatsapp"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Adity-star.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-02-08T17:02:16.000Z","updated_at":"2025-02-26T14:49:23.000Z","dependencies_parsed_at":"2025-02-08T18:26:00.059Z","dependency_job_id":"4463f170-696a-4cef-a363-d8ee23efda3f","html_url":"https://github.com/Adity-star/Whatsapp-chat-analyzer","commit_stats":null,"previous_names":["adity-star/whatsapp-chat-analyzer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adity-star%2FWhatsapp-chat-analyzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adity-star%2FWhatsapp-chat-analyzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adity-star%2FWhatsapp-chat-analyzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adity-star%2FWhatsapp-chat-analyzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Adity-star","download_url":"https://codeload.github.com/Adity-star/Whatsapp-chat-analyzer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240981746,"owners_count":19888377,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["analysis","eda","streamlit","whatsapp"],"created_at":"2025-02-27T05:18:27.237Z","updated_at":"2026-05-06T13:05:56.812Z","avatar_url":"https://github.com/Adity-star.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WhatsApp Chat Analyzer\n\nA Python-based application that reads WhatsApp exported chat logs and generates useful insights, such as:\n\n- Total message count\n- Most frequent contacts\n- Distribution of messages over time\n- Word cloud generation for popular words\n\nThis tool helps visualize chat data and can be useful for personal use or for understanding message patterns.\n\n## Features\n\n- **Message Count**: Displays the total number of messages sent and received.\n- **Frequent Contacts**: Lists the contacts you interact with the most.\n- **Time Analysis**: Shows how messages are distributed over time (e.g., daily, monthly).\n- **Word Cloud**: Generates a word cloud visualization for frequently used words in the chat.\n- **Export Data**: Option to export the analysis results to a file (CSV, JSON, etc.).\n\n## Installation\n\nFollow these steps to install and set up the WhatsApp Chat Analyzer:\n\n### Clone the repository:\n```bash\ngit clone https://github.com/Adity-star/Whatsapp-chat-analyzer.git\ncd Whatsapp-chat-analyzer\n```\n\n### Create a virtual environment (optional but recommended):\n```bash\npython3 -m venv venv\n```\n\n### Activate the virtual environment:\n- **Windows:**\n  ```bash\n  venv\\Scripts\\activate\n  ```\n- **macOS/Linux:**\n  ```bash\n  source venv/bin/activate\n  ```\n\n### Install dependencies:\n```bash\npip install -r requirements.txt\n```\n\n## Usage\n\n### Export your WhatsApp chat:\n1. Open WhatsApp and navigate to the chat you want to analyze.\n2. Tap on the three dots in the top right corner \u003e More \u003e Export Chat.\n3. Choose whether to include media or not (for this tool, it's fine to just include text).\n4. Place the exported `.txt` file in the project directory.\n\n### Run the analyzer:\n```bash\npython chat_analyzer.py your_chat.txt\n```\nReplace `your_chat.txt` with the actual name of your exported chat file.\n\n### View the results:\nThe results will be displayed in the terminal or saved to an output file, depending on your configuration.\n\n### Generate a word cloud (optional):\n```bash\npython wordcloud_generator.py\n```\nThis will generate and display a word cloud of the most frequently used words in your chat.\n\n## Technologies Used\n\n- **Python**: Core programming language.\n- **Pandas**: For data analysis and manipulation.\n- **Matplotlib**: For visualizing data.\n- **WordCloud**: For generating word cloud visualizations.\n- **Regex**: For parsing and processing the WhatsApp chat export.\n\n## Contributing\n\nWe welcome contributions and suggestions! To contribute:\n1. Fork the repository.\n2. Create a new branch:\n   ```bash\n   git checkout -b feature/your-feature\n   ```\n3. Make your changes and commit them:\n   ```bash\n   git commit -am 'Add new feature'\n   ```\n4. Push to your branch:\n   ```bash\n   git push origin feature/your-feature\n   ```\n5. Open a pull request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgements\n\n- **WhatsApp** for the exported chat format.\n- **Python Libraries**: Pandas, Matplotlib, and WordCloud for their awesome contributions.\n\nFeel free to modify this README based on your project updates. Let me know if you need further adjustments!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadity-star%2Fwhatsapp-chat-analyzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadity-star%2Fwhatsapp-chat-analyzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadity-star%2Fwhatsapp-chat-analyzer/lists"}