How gill-singh-a/stun-ip-tracker works
STUN IP Tracker is a command-line packet analyzer for identifying IP addresses in STUN traffic, filtering them by ASN, and optionally geolocating and mapping results. Its principal workflow starts with live interface capture or a packet-capture file, then analyzes packets and performs ASN lookup before optionally producing location output. The README documents mapping and geolocation capabilities; the available source excerpt shows where those functions are called, but not their implementation inside the IP-Location submodule.
Main entry points: main.py CLI workflow · ignore_asn_names.txt Ignored ASN list · IP-Location IP geolocation
Components 13
Packet input
- CLI workflow
main.py - Packet capture
main.py
STUN analysis
- Packet callback
main.py - STUN analysis
main.py - ASN lookup
main.py - ASN filtering
main.py - Ignored ASN list
ignore_asn_names.txt
Location output
- IP geolocation
IP-Location - Map output
IP-Location
Other components
- Operator
- Live packets
- Capture file
- WHOIS service
Connections 13
- Operator → CLI workflow: runs
- CLI workflow → Packet capture: starts capture
- Live packets → Packet capture: supplies packets
- Capture file → CLI workflow: read by
- Packet capture → Packet callback: dispatches packets
- CLI workflow → Packet callback: iterates packets
- Packet callback → STUN analysis: processes packet
- STUN analysis → ASN lookup: looks up IP
- ASN lookup → WHOIS service: queries
- STUN analysis → ASN filtering: checks ASN
- ASN filtering → Ignored ASN list: reads
- Packet callback → IP geolocation: geolocates IP
- CLI workflow → Map output: maps locations