How garvits01/arp-spoof-detector works
ARP Spoof Detector is a command-line network monitor: an operator selects an interface, the detector sniffs ARP replies, learns IP-to-MAC mappings, compares them with trusted entries, and reports changed mappings through colored console alerts and persistent logs. It also lists available interfaces and prints a session summary when monitoring stops. The repository documents a separate Scapy-based attack simulator that sends forged replies. Relationships are based on the sampled source and README; the network and user are external actors.
Main entry points: detector.py ARP Detector · main.py CLI Entry · alerter.py Alert Formatter · attacker.py Packet Simulator
Components 11
Command Entry
- CLI Entry
main.py - Interface Discovery
main.py
ARP Detection
- ARP Detector
detector.py - IP-MAC Cache
detector.py - Static Whitelist
whitelist.py
Alert Reporting
- Alert Formatter
alerter.py - Alert Log
alerter.py
Attack Simulation
- Packet Simulator
attacker.py
Other components
- Operator
- ARP Network Traffic
- Terminal Output
Connections 12
- Operator → CLI Entry: runs
README.md - CLI Entry → Interface Discovery: lists interfaces
main.py - CLI Entry → ARP Detector: starts
main.py - ARP Detector → Static Whitelist: loads entries
detector.py - ARP Detector → IP-MAC Cache: seeds and updates
detector.py - ARP Network Traffic → ARP Detector: delivers ARP replies
detector.py - ARP Detector → Alert Formatter: reports mismatch
detector.py - Alert Formatter → Alert Log: writes alerts
alerter.py - Alert Formatter → Terminal Output: prints alerts
alerter.py - ARP Detector → Terminal Output: prints status and summary
detector.py - Operator → Packet Simulator: runs simulation
README.md - Packet Simulator → ARP Network Traffic: sends forged replies
README.md