mirror of
https://github.com/smittix/intercept.git
synced 2026-05-17 13:24:50 -07:00
234f254f4f
Implement 9 major TSCM feature enhancements: 1. Capability & Coverage Reality Panel - Exposes what sweeps can/cannot detect based on OS, privileges, adapters, and SDR limits 2. Baseline Diff & Health - Shows changes vs baseline with health scoring (healthy/noisy/stale) based on age and device churn 3. Per-Device Timelines - Time-bucketed observations with RSSI stability, movement patterns, and meeting correlation 4. Whitelist/Known-Good Registry + Case Grouping - Global and per-location device registry with case management for sweeps/threats/notes 5. Meeting-Window Summary Enhancements - Tracks devices first seen during meetings with scoring modifiers 6. Client-Ready PDF Report + Technical Annex - Executive summary, findings by risk tier, JSON/CSV annex export 7. WiFi Advanced Indicators - Evil twin detection, probe request tracking, deauth burst detection (auto-disables without monitor mode) 8. Bluetooth Risk Explainability - Proximity estimates, tracker brand explanations, human-readable risk descriptions 9. Operator Playbooks - Procedural guidance by risk level with steps, safety notes, and documentation requirements All features include mandatory disclaimers, preserve existing architecture, and follow TSCM best practices (no packet capture, no surveillance claims). Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
INTERCEPT
Support the developer of this open-source project
Signal Intelligence Platform
A web-based interface for software-defined radio tools.
Features
- Pager Decoding - POCSAG/FLEX via rtl_fm + multimon-ng
- 433MHz Sensors - Weather stations, TPMS, IoT devices via rtl_433
- Aircraft Tracking - ADS-B via dump1090 with real-time map and radar
- ACARS Messaging - Aircraft datalink messages via acarsdec
- Listening Post - Frequency scanner with audio monitoring
- Satellite Tracking - Pass prediction using TLE data
- WiFi Scanning - Monitor mode reconnaissance via aircrack-ng
- Bluetooth Scanning - Device discovery and tracker detection
Installation / Debian / Ubuntu / MacOS
**1. Clone and run:**
```bash
git clone https://github.com/smittix/intercept.git
cd intercept
./setup.sh
sudo -E venv/bin/python intercept.py
Docker (Alternative)
git clone https://github.com/smittix/intercept.git
cd intercept
docker compose up -d
Note: Docker requires privileged mode for USB SDR access. See
docker-compose.ymlfor configuration options.
Open the Interface
After starting, open http://localhost:5050 in your browser.
Hardware Requirements
| Hardware | Purpose | Price |
|---|---|---|
| RTL-SDR | Required for all SDR features | ~$25-35 |
| WiFi adapter | Must support promiscuous (monitor) mode | ~$20-40 |
| Bluetooth adapter | Device scanning (usually built-in) | - |
| GPS | Any Linux supported GPS Unit | ~10 |
Most features work with a basic RTL-SDR dongle (RTL2832U + R820T2).
| ❗ Not using an RTL-SDR Device? |
|---|
| Intercept supports any device that SoapySDR supports. You must however have the correct module for your device installed! For example if you have an SDRPlay device you'd need to install soapysdr-module-sdrplay. |
| ❗ GPS Usage |
|---|
| gpsd is needed for real time location. Intercept automatically checks to see if you're running gpsd in the background when any maps are rendered. |
Discord Server
Documentation
- Usage Guide - Detailed instructions for each mode
- Hardware Guide - SDR hardware and advanced setup
- Troubleshooting - Common issues and solutions
- Security - Network security and best practices
Disclaimer
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.
This software is for educational and authorized testing purposes only.
- Only use with proper authorization
- Intercepting communications without consent may be illegal
- 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 | acarsdec | aircrack-ng | Leaflet.js | Celestrak