SniffDog - Packet Sniffing Tool

Sniffdog is a lightweight, no-dependencies, Python-based packet sniffing CLI tool designed to capture and analyze Ethernet traffic.

---

Table of contents

1. Features
2. Installation
3. Usage
4. Examples
5. Output
6. Limitations
7. License

Features

• Detailed Packet Analysis: Capture and display Ethernet frame details, IPv4 headers, protocol information, and transmitted payloads.
• CLI Options:
  • --keep-alive: Displays the keep-alive packets
  • --write-log: Logs captured packets to a file for further analysis
• No External Libraries: Built using only native Python Libraries

Installation

Clone this repostiory

git clone https://github.com/p4th4k/SniffDog.git
cd SniffDog

Usage

Run SniffDog with optional commands:

python3 main.py [--keep-alive] [--write-log]

Examples

1. Capture and disaply packets:

sudo python3 sniffEther.py

2. Capture and display packets along with keep-alive packets

sudo python3 sniffEther.py --keep-alive

3. Caputre and display packets along with logging

sudo python3 sniffEther.py --write-log

4. Capture and display packets along with keep-alive and logging

sudo python3 sniffEther.py --keep-alive --write-log

Output

For each captured packet, the tool provides:

• Ethernet Frame: MAC addresses, Protocol.
• IPv4 Header: Version, Header Length, Source/destination IP, TTL, protocol.
• Protocol Information: Packet details for ICMP, TCP, UDP and others.
• Payload: Raw Data transmitted within the packet encoded in ASCII format.

Limitations

• Designed for Ethernet-based networks
• Requires root privileges for packet capture
• Works best in environment where raw socket access is permitted

License

MIT