Skip to content

README.md

Latest commit

 

History

History
124 lines (101 loc) · 3.53 KB

README.md

File metadata and controls

124 lines (101 loc) · 3.53 KB

📡 Basic Network Sniffer

A powerful Python-based network packet sniffer for real-time traffic analysis

🚀 Overview

This project is a basic network packet sniffer built using Scapy. It captures live packets and provides detailed insights into:

  • Network protocols
  • Packet structure
  • Payload data
  • Traffic behavior

🎓 Developed by DAani Sam for CodeAlpha Cyber Security Internship – Task 1

✨ Features

✅ Real-time packet capture
✅ Deep protocol analysis (TCP, UDP, ICMP, ARP)
✅ Payload inspection
✅ Service detection (HTTP, HTTPS, SSH, etc.)
✅ Cross-platform compatibility
✅ Interactive CLI menu
✅ Packet statistics (rate, duration)

🖼️ Project Preview

📌 After successful cloning and running this image will re-directed.

🛠️ Tech Stack

  • Language: Python 3
  • Library: Scapy
  • Concepts: Networking, Packet Analysis, Cybersecurity

⚙️ Installation

git clone https://github.com/DaniSam-STU/CodeAlpha_Network-Sniffer.git
cd network-sniffer
pip install scapy
python network_sniffer.py

⚠️ Permissions

Linux/macOS

sudo python3 sniffer.py

Windows

  • Run terminal as Administrator
  • Install Npcap / WinPcap

🐞 Troubleshooting

Scapy not installed

pip install scapy

Permission error

  • Run as admin/root

No packets captured

  • Check interface
  • Ensure network activity
  • Disable firewall temporarily (if needed)

🤝 Contributing

  • Pull requests are welcome!
  • Feel free to fork and improve this project.

👨‍💻 Author & Contact Information

  • DAani Sam

📜 License

This project is intended for educational and ethical use only.

⭐ Support

If you like this project, give it a ⭐ on GitHub!