🛡️ Advanced Network Packet Sniffer & Analyzer

A professional Python-based network monitoring and packet sniffing tool for capturing, filtering, analyzing, and logging real-time network traffic. Designed for cybersecurity students, penetration testers, and networking professionals.

---

🚀 Features

• 🔍 Real-time packet sniffing with scapy
• 🎛️ Filter by protocol (TCP, UDP, ICMP) or port
• 📊 Summary output with IPs and ports
• 📄 CSV logging with timestamp
• 🎨 Color-coded terminal output
• 🧱 Modular structure for easy extension
• 💬 Command-line interface with argument parsing

---

🧰 Technologies Used

• Python 3.x
• Scapy
• argparse
• csv
• datetime

---

📁 Project Structure

packet_sniffer/
├── packet_sniffer.py         # Main CLI script
├── sniffer_core.py           # Sniffing and filtering logic
├── packet_logger.py          # Logs to CSV
├── utils.py                  # Color output, timestamps, banner
├── README.md

---

🔧 How to Run

🐍 Step 1: Install Dependencies

pip install scapy

▶️ Step 2: Run the Sniffer

sudo python packet_sniffer.py --protocol tcp --count 100 --output traffic.csv

On Windows, run CMD as Administrator.

🧪 Other Examples:

python packet_sniffer.py --protocol udp
python packet_sniffer.py --count 50
python packet_sniffer.py --port 80 --protocol tcp

---

💡 Future Improvements

• Write to .pcap format for Wireshark analysis
• Add IP/port exclusion filters
• Integrate with basic GUI (e.g. Tkinter)
• Live protocol statistics

---

📜 License

MIT License © 2025 Aliullah

---

📬 Author

Developed with ❤️ by Aliullah
Feel free to connect on GitHub

⚠️ For educational and ethical use only. Never use on networks without permission.