---

🎯 A modern PyQt6-based SOC-style dashboard for authorized, educational network traffic analysis

---

🌟 Overview

WhatsAppTrafficTracker is a professional cybersecurity dashboard designed for: Purpose Description 📚 Learning Network traffic analysis fundamentals 🔄 Understanding Real-time packet flows & patterns 🛡️ Practicing Defensive / Blue-team concepts

╔══════════════════════════════════╗ ║ METADATA CAPTURE ONLY ║ ╠══════════════════════════════════╣ ║ ✅ IPs, Ports, Protocols ║ ║ ✅ Timestamps & Sizes ║ ║ ❌ NO Message Access ║ ║ ❌ NO Decryption ║ ║ ❌ NO MITM Attacks ║ ╚══════════════════════════════════╝

🖥️ Interface Preview

🎨 Dark SOC-inspired UI with smooth hover effects and clean alignment

🔥 Key Features

Feature	Description
🎨	Cybersecurity Dark Theme — Modern SOC-inspired UI design
📡	Smart Packet Capture — Filter-based intelligent capturing
🧭	IP Tracker — Location mapping & traffic correlation
📊	Live Monitoring — Real-time traffic visualization
🧾	Detailed Logs — Severity levels & timestamps
📤	Export Options — CSV & JSON support
🧵	Performance — Thread-safe, non-blocking GUI
📱	Responsive Design — Works on all screen sizes
🌐	Cross-Platform — Windows, macOS, Linux support

📱 Mobile View - Tap to see features

🎨 Dark Theme	📡 Packet Capture	🧭 IP Tracker
Modern UI	Smart Filtering	Location Map

📊 Live Monitor	🧾 Logs	📤 Export
Real-time	Severity	CSV/JSON

---

🚀 Quick Start

graph LR
    A[📦 Download ZIP] --> B[📂 Extract Files]
    B --> C[▶️ Run .exe]
    C --> D[🎯 Start Capture]
    D --> E[📞 Make Call]
    E --> F[📊 View Data]
    
    style A fill:#25D366,stroke:#128C7E,color:#fff
    style B fill:#25D366,stroke:#128C7E,color:#fff
    style C fill:#25D366,stroke:#128C7E,color:#fff
    style D fill:#25D366,stroke:#128C7E,color:#fff
    style E fill:#25D366,stroke:#128C7E,color:#fff
    style F fill:#25D366,stroke:#128C7E,color:#fff

Loading

📱 Mobile View - Quick Start Steps

📦 Step 1: Download ZIP
      ⬇️
📂 Step 2: Extract Files  
      ⬇️
▶️ Step 3: Run .exe
      ⬇️
🎯 Step 4: Start Capture
      ⬇️
📞 Step 5: Make Call
      ⬇️
📊 Step 6: View Data

📋 Step-by-Step Guide

📥 Click to expand installation steps

Step	Action	Details
1	📦 Download	Get the latest release ZIP
2	📂 Extract	Unzip to any location
3	▶️ Run	Launch whatsapptracker.exe
4	⚠️ Windows Warning	Click More info → Run anyway
5	🎯 Start	Click Start Capture button
6	💬 WhatsApp	Install from Microsoft Store & open
7	📞 Call	Start a voice call (with consent)
8	📊 View	Check IP Tracker tab for metadata

Note

If the remote user has "Protect IP address" enabled, IP details will not appear — this is expected behavior.

---

🔐 Security & Privacy First

✅ What We DO	❌ What We DON'T
Capture metadata only	Access messages
Log IPs & ports	Inspect payloads
Track protocols	Bypass encryption
Record timestamps	Intercept credentials
Respect privacy	Run hidden processes

Important

Use only on systems or networks you own or have explicit permission to analyze.

---

📱 Mobile View - Tech Stack

Technology	Description
🐍 Python 3.11+	Modern async/await support
🖼️ PyQt6	Beautiful dark UI framework
📡 Packet Interception	Windows native APIs
🏗️ Modular Architecture	Production-ready codebase
🌐 Cross-Platform	Windows, macOS, Linux
📱 Responsive	Mobile-friendly docs

---

⚠️ Legal Disclaimer

[!CAUTION] This project is intended strictly for educational, debugging, and defensive security purposes.
Unauthorized interception of network traffic may violate local laws.

The author takes no responsibility for misuse.
This project is not affiliated with WhatsApp or Meta.

---

🤝 Contributing

We welcome contributions! Here's how you can help:

Type	Description
🎨	UI/UX improvements
⚡	Performance optimizations
🔧	Additional analysis modules
📝	Documentation updates
🐛	Bug fixes

Tip

Please keep all contributions legal and privacy-respecting.

---

💖 Support the Project

If you find this project useful, show your support!

---

Made with 💚 for the Cybersecurity Community

_{📱 Zork Naam hai Amara}