Skip to content

README.md

Latest commit

 

History

History
80 lines (54 loc) · 2.73 KB

README.md

File metadata and controls

80 lines (54 loc) · 2.73 KB

WhatsApp Chat Analyzer

Overview

WhatsApp Chat Analyzer is a web application that allows users to upload WhatsApp chat exported as a .txt file and provides various insights and summaries about the chat data. This project aims to help users understand their chat history better by visualizing data such as message statistics, word usage, active times, and more.

Table of Contents

Features

  • Total Words: Displays the total number of words in the chat.
  • Total Messages: Shows the total number of messages in the chat.
  • Links Shared: Analyzes and lists the links shared in the chat.
  • Media Shared: Provides insights into the media (images, videos) shared in the chat.
  • Heat Map: Visualizes the most active times for chat messages.
  • Word Cloud: Generates a word cloud to show the most frequently used words.
  • Most Active Users: Identifies the users who are most active in the chat.
  • Emoji Analysis: Analyzes and visualizes emoji usage in the chat.
  • Chat Timeline: Creates a timeline of chat activity over time.

Tech Stack

  • Streamlit: Used for building the web application.
  • Matplotlib: Utilized for creating data visualizations.
  • Seaborn: Enhances the aesthetics of visualizations.
  • urlextract: Extracts URLs from chat data.
  • WordCloud: Generates word clouds from text data.
  • Pandas: Used for data manipulation and analysis.
  • Emoji: Analyzes and visualizes emoji usage.

Installation

  1. Clone the repository:
git clone https://github.com/yuval207/WhatsappChatAnalyser.git

cd WhatsappChatAnalyser
  1. Create a virtual environment (optional but recommended):
python -m venv venv
source venv/bin/activate  # On Windows, use venv\Scripts\activate
  1. Install the required packages:
pip install -r requirements.txt

Usage

  1. Run the Streamlit application:
streamlit run app.py

  1. Upload your WhatsApp chat exported as a .txt file using the web interface.

  2. Explore the various insights and summaries generated by the application.

Important Note

Please Note: This application accepts input for time formatting in 24-hour time format only. Ensure that your chat data uses this format to avoid errors in the analysis.

Contributing

Contributions are welcome! If you'd like to contribute to this project, please follow the guidelines outlined in CONTRIBUTING.md.