Files
intercept/README.md
2026-01-06 08:20:33 +01:00

3.6 KiB

INTERCEPT

Python 3.9+ MIT License Platform

Signal Intelligence Platform
A web-based front-end for signal intelligence tools.

Screenshot


What is INTERCEPT?

INTERCEPT provides a unified web interface for signal intelligence tools:

  • Pager Decoding - POCSAG/FLEX via rtl_fm + multimon-ng
  • 433MHz Sensors - Weather stations, TPMS, IoT via rtl_433
  • Aircraft Tracking - ADS-B via dump1090 with real-time map
  • Satellite Tracking - Pass prediction using TLE data
  • WiFi Recon - Monitor mode scanning via aircrack-ng
  • Bluetooth Scanning - Device discovery and tracker detection

Community

Join our Discord


Quick Start

git clone https://github.com/smittix/intercept.git
cd intercept
./setup.sh
sudo python3 intercept.py

Open http://localhost:5050 in your browser.

Usage of Black Formatter

uv run black . # If you use UV
black . # For Python
Alternative: Install with uv
git clone https://github.com/smittix/intercept.git
cd intercept
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv sync
sudo python3 intercept.py

Note: Requires Python 3.9+ and external tools. See Hardware & Installation.


Requirements

  • Python 3.9+
  • SDR Hardware - RTL-SDR (~$25), LimeSDR, or HackRF
  • External Tools - rtl-sdr, multimon-ng, rtl_433, dump1090, aircrack-ng

Quick install (Ubuntu/Debian):

sudo apt install rtl-sdr multimon-ng rtl-433 dump1090-mutability aircrack-ng bluez

See Hardware & Installation for full details.


Documentation

Document Description
Features Complete feature list for all modules
Usage Guide Detailed instructions for each mode
Troubleshooting Solutions for common issues
Hardware & Installation SDR hardware and tool installation

Development

This project was developed using AI as a coding partner, combining human direction with AI-assisted implementation. The goal: make Software Defined Radio more accessible by providing a clean, unified interface for common SDR tools.

Contributions and improvements welcome.


Disclaimer

This software is for educational purposes only.

  • Only use with proper authorization
  • Intercepting communications without consent may be illegal
  • WiFi/Bluetooth attacks require explicit permission
  • You are responsible for compliance with applicable laws

License

MIT License - see LICENSE

Author

Created by smittix - GitHub

Acknowledgments

rtl-sdr | multimon-ng | rtl_433 | dump1090 | aircrack-ng | Leaflet.js | Celestrak