How parathputhuvai/packet-watch works
Packet Watch is a passive, Windows command-line network intrusion analyzer. Its principal workflow captures live packets, parses them into normalized fields, enriches TLS fingerprints, updates rolling per-source state, evaluates signature detectors, scores and filters alerts, then presents them and writes periodic or final PDF/CSV reports. The graph also preserves the documented reputation, MITRE, and timeline capabilities. Source excerpts support the main orchestration and several internal calls; some subsystem links are based on the README, and unsampled integrations are not expanded beyond documented behavior.
Main entry points: app.py Monitor orchestration · engine.py Detection engine · main.py CLI commands · live.py Live capture
Components 24
CLI and capture
- CLI commands
packet_watch/cli/main.py - Configuration
packet_watch/config/settings.py - Live capture
packet_watch/capture/live.py - Monitor orchestration
packet_watch/cli/app.py
Packet analysis
- Packet parser
packet_watch/parser/packet_parser.py - JA3 enrichment
packet_watch/threat_intel/pipeline.py - SSLBL feed client
packet_watch/threat_intel/ja3.py - Rolling state
packet_watch/state/rolling.py - Signature detectors
packet_watch/detectors - Rule helpers
packet_watch/detectors/common.py - Detection engine
packet_watch/detection/engine.py - Packet and alert models
packet_watch/models/models.py
Alert enrichment
- Severity scoring
packet_watch/severity/scoring.py - Whitelist filtering
packet_watch/whitelist/filter.py - IP reputation
packet_watch/threat_intel/abuseipdb.py - MITRE mapping
packet_watch/mitre/mapping.py - Alert timeline
packet_watch/correlation/timeline.py - Logging
packet_watch/utils/logging.py
Presentation and reports
- Rich terminal output
packet_watch/cli/app.py - CSV reports
packet_watch/reporting/csv_report.py - PDF reports
packet_watch/reporting/pdf_report.py
Other components
- Operator
- AbuseIPDB
- SSLBL threat feed
Connections 24
- Operator → CLI commands: runs commands
README.md - CLI commands → Configuration: loads settings
packet_watch/cli/main.py - CLI commands → Monitor orchestration: dispatches commands
packet_watch/cli/main.py - Monitor orchestration → Live capture: starts capture
packet_watch/cli/app.py - Live capture → Monitor orchestration: delivers packets
packet_watch/cli/app.py - Monitor orchestration → Packet parser: parses packets
packet_watch/cli/app.py - Monitor orchestration → JA3 enrichment: enriches TLS
packet_watch/cli/app.py - JA3 enrichment → SSLBL feed client: calculates and looks up
packet_watch/threat_intel/pipeline.py - SSLBL feed client → SSLBL threat feed: fetches feed
packet_watch/threat_intel/ja3.py - Monitor orchestration → Detection engine: processes parsed packets
packet_watch/cli/app.py - Detection engine → Rolling state: observes packet
packet_watch/detection/engine.py - Detection engine → Signature detectors: dispatches detection
packet_watch/detection/engine.py - Signature detectors → Rule helpers: uses rule helpers
packet_watch/detectors/dns_tunneling.py - Rolling state → Rule helpers: uses request heuristics
packet_watch/state/rolling.py - Detection engine → Severity scoring: scores results
packet_watch/detection/engine.py - Detection engine → Whitelist filtering: checks suppression
packet_watch/detection/engine.py - Detection engine → Packet and alert models: creates alerts
packet_watch/detection/engine.py - Monitor orchestration → IP reputation: enriches alert IPs
- Monitor orchestration → Alert timeline: records alerts
packet_watch/cli/app.py - Monitor orchestration → Rich terminal output: prints alerts
packet_watch/cli/app.py - Monitor orchestration → CSV reports: writes CSV
packet_watch/cli/app.py - Monitor orchestration → PDF reports: writes PDF
packet_watch/cli/app.py - IP reputation → AbuseIPDB: queries reputation
- Monitor orchestration → Logging: sets up logging
packet_watch/cli/app.py