How oros42/imsi-catcher works
IMSI-catcher receives GSMTAP traffic decoded by gr-gsm, extracts cell and mobile identities, enriches IMSIs with country/operator data, and displays or saves observations. Its principal workflow is documented in the README; the sampled source confirms identity parsing, tracking, and SQLite/TXT/MySQL persistence. The same program also offers packet sniffing and an immediate-assignment inspection utility. Some runtime wiring is not shown in the excerpts, so only documented or excerpt-supported relationships are drawn.
Main entry points: simple_IMSI-catcher.py IMSI tracker · immediate_assignment_catcher.py Assignment inspector · mcc_codes.json MCC/MNC codes · update_codes.py Code updater
Components 16
Signal capture
- GSMTAP receiver
simple_IMSI-catcher.py - Interface sniffer
simple_IMSI-catcher.py
GSM analysis
- Assignment inspector
immediate_assignment_catcher.py - GSMTAP parser
simple_IMSI-catcher.py - IMSI tracker
simple_IMSI-catcher.py
Identity enrichment
- Identity decoder
simple_IMSI-catcher.py - MCC/MNC codes
mcc-mnc/mcc_codes.json - Code updater
mcc-mnc/update_codes.py
Observation outputs
- Console output
simple_IMSI-catcher.py - SQLite observations
simple_IMSI-catcher.py - Text observations
simple_IMSI-catcher.py - MySQL observations
simple_IMSI-catcher.py
Other components
- Operator
- SDR receiver
- gr-gsm live decoder
- MySQL server
Connections 18
- Operator → SDR receiver: tunes receiver
README.md - SDR receiver → gr-gsm live decoder: supplies radio signals
README.md - gr-gsm live decoder → GSMTAP receiver: sends decoded GSMTAP
README.md - Operator → GSMTAP receiver: starts capture
README.md - Operator → Interface sniffer: selects sniff mode
README.md - Operator → Assignment inspector: runs inspector
README.md - GSMTAP receiver → GSMTAP parser: passes packets
simple_IMSI-catcher.py - Interface sniffer → GSMTAP parser: passes packets
simple_IMSI-catcher.py - GSMTAP parser → IMSI tracker: registers identities
simple_IMSI-catcher.py - Assignment inspector → Operator: prints channel details
immediate_assignment_catcher.py - IMSI tracker → Identity decoder: decodes IMSI
simple_IMSI-catcher.py - Identity decoder → MCC/MNC codes: looks up network
- Code updater → MCC/MNC codes: writes code data
mcc-mnc/update_codes.py - IMSI tracker → Console output: displays observations
simple_IMSI-catcher.py - IMSI tracker → SQLite observations: writes observations
simple_IMSI-catcher.py - IMSI tracker → Text observations: writes observations
simple_IMSI-catcher.py - IMSI tracker → MySQL observations: writes observations
simple_IMSI-catcher.py - MySQL observations → MySQL server: stores records