intercept/docs/FEATURES.md

INTERCEPT Features

Complete feature list for all modules.

Pager Decoding

• Real-time decoding of POCSAG (512/1200/2400) and FLEX protocols
• Customizable frequency presets stored in browser
• Auto-restart on frequency change while decoding

433MHz Sensor Decoding

• 200+ device protocols supported via rtl_433
• Weather stations - temperature, humidity, wind, rain
• TPMS - Tire pressure monitoring sensors
• Doorbells, remotes, and IoT devices
• Smart meters and utility monitors

Sub-GHz Analyzer

• HackRF-based signal capture and analysis for 300-928 MHz ISM bands
• Protocol decoding - identify and decode common Sub-GHz protocols
• Signal replay/transmit capabilities for authorized testing
• Wideband spectrum analysis with real-time visualization
• I/Q capture - record raw samples for offline analysis

AIS Vessel Tracking

• Real-time vessel tracking via AIS-catcher on 161.975/162.025 MHz
• Full-screen dashboard - dedicated popout with interactive map
• Interactive Leaflet map with OpenStreetMap tiles (dark-themed)
• Vessel details popup - name, MMSI, callsign, destination, ETA
• Navigation data - speed, course, heading, rate of turn
• Ship type classification - cargo, tanker, passenger, fishing, etc.
• Vessel dimensions - length, width, draught
• Multi-SDR support - RTL-SDR, HackRF, LimeSDR, Airspy, SDRplay

Spy Stations (Number Stations)

• Comprehensive database of active number stations and diplomatic networks
• Station profiles - frequencies, schedules, operators, descriptions
• Filter by type - number stations vs diplomatic networks
• Filter by country - Russia, Cuba, Israel, Poland, North Korea, etc.
• Filter by mode - USB, AM, CW, OFDM
• Tune integration - click to tune Listening Post to station frequency
• Source links - references to priyom.org for detailed information
• Famous stations - UVB-76 "The Buzzer", Cuban HM01, Israeli E17z

ADS-B Aircraft Tracking

• Real-time aircraft tracking via dump1090 or rtl_adsb
• Full-screen dashboard - dedicated popout with virtual radar scope
• Interactive Leaflet map with OpenStreetMap tiles (dark-themed)
• Aircraft trails - optional flight path history visualization
• Range rings - distance reference circles from observer position
• Aircraft filtering - show all, military only, civil only, or emergency only
• Marker clustering - group nearby aircraft at lower zoom levels
• Reception statistics - max range, message rate, busiest hour, total seen
• Persistent ADS-B history - optional Postgres-backed message and snapshot storage
• History reporting dashboard - session controls, aircraft timelines, and detail modal
• Observer location - manual input or GPS geolocation
• Audio alerts - notifications for military and emergency aircraft
• Emergency squawk highlighting - visual alerts for 7500/7600/7700
• Aircraft details popup - callsign, altitude, speed, heading, squawk, ICAO

AIS Vessel Tracking

• Real-time vessel tracking via AIS-catcher or rtl_ais
• Full-screen dashboard - dedicated popout with maritime map
• Interactive Leaflet map with OpenStreetMap tiles (dark-themed)
• Vessel trails - optional track history visualization
• Vessel details popup - name, MMSI, callsign, destination, ship type, speed, heading
• Country identification - flag lookup via Maritime Identification Digits (MID)

VHF DSC Channel 70 Monitoring

Digital Selective Calling (DSC) monitoring on the international maritime distress frequency.

• Real-time DSC decoding - Distress, Urgency, Safety, and Routine messages
• MMSI country lookup - 180+ Maritime Identification Digit codes
• Distress nature identification - Fire, Flooding, Collision, Sinking, Piracy, MOB, etc.
• Position extraction - Automatic lat/lon parsing from distress messages
• Map markers - Distress positions plotted with pulsing alert markers
• Visual alert overlay - Prominent popup for DISTRESS and URGENCY messages
• Audio alerts - Notification sound for critical messages
• Alert persistence - Critical alerts stored permanently in database
• Acknowledgement workflow - Track response status with notes
• SDR conflict detection - Prevents device collisions with AIS tracking
• Alert summary - Dashboard counts for unacknowledged distress/urgency

ACARS Messaging

• Real-time ACARS decoding via acarsdec
• Aircraft datalink messages - operational, weather, and position reports
• Multi-SDR support - RTL-SDR, HackRF, LimeSDR, Airspy, SDRplay
• Message filtering - filter by message type, flight, or registration

DMR Digital Voice

• Digital voice decoding via dsd-fme for DMR, P25, NXDN, and D-STAR
• Visual synthesizer with event-driven spring-physics audio bars
• Audio output with real-time streaming via WebSocket
• Frequency persistence and bookmark support
• Tuning controls with fine adjustment and state sync

Listening Post

• Wideband frequency scanning via rtl_power sweep with SNR filtering
• Real-time audio monitoring with FM and SSB demodulation
• Cross-module frequency routing from scanner to decoders
• Customizable frequency presets and band bookmarks
• Multi-SDR support - RTL-SDR, LimeSDR, HackRF, Airspy, SDRplay

Weather Satellites

• NOAA APT and Meteor LRPT image decoding via SatDump
• Auto-scheduler with pass prediction and automatic capture
• Polar plot - real-time satellite position on azimuth/elevation display
• Ground track map - orbit path with past/future trajectory
• Image gallery with timestamped decoded imagery

WebSDR

• KiwiSDR network integration for remote HF/shortwave listening
• WebSocket audio streaming from remote receivers
• Receiver discovery with automatic caching
• Frequency tuning with band presets

HF SSTV

• Terrestrial SSTV decoding across HF (80m-10m), VHF (6m, 2m), and UHF (70cm) bands
• Predefined frequency lookup for active SSTV calling frequencies
• Image gallery with decoded transmissions

APRS

• Amateur packet radio position reports and telemetry via direwolf
• Region-specific frequencies - 144.390 MHz (North America), 144.800 MHz (Europe), and more
• Real-time position tracking on interactive map
• Message and telemetry display from APRS network

Utility Meter Reading

• Smart meter monitoring via rtl_amr for electric, gas, and water meters
• Real-time JSON output with meter ID, consumption, and signal data
• Multiple meter protocol support via rtl_tcp integration

Satellite Tracking

• Full-screen dashboard - dedicated popout with polar plot and ground track
• Polar sky plot - real-time satellite positions on azimuth/elevation display
• Ground track map - satellite orbit path with past/future trajectory
• Pass prediction for satellites using TLE data
• Add satellites via manual TLE entry or Celestrak import
• Celestrak integration - fetch by category (Amateur, Weather, ISS, Starlink, etc.)
• Next pass countdown - time remaining, visibility duration, max elevation
• Telemetry panel - real-time azimuth, elevation, range, velocity
• Multiple satellite tracking simultaneously

WiFi Reconnaissance

• Monitor mode management via airmon-ng
• Network scanning with airodump-ng and channel hopping
• Handshake capture with real-time status and auto-detection
• Deauthentication attacks for authorized testing
• Channel utilization visualization (2.4GHz and 5GHz)
• Security overview chart and real-time radar display
• Client vendor lookup via OUI database
• Drone detection - automatic detection via SSID patterns and OUI (DJI, Parrot, Autel, etc.)
• Rogue AP detection - alerts for same SSID on multiple BSSIDs
• Signal history graph - track signal strength over time for any device
• Network topology - visual map of APs and connected clients
• Channel recommendation - optimal channel suggestions based on congestion
• Hidden SSID revealer - captures hidden networks from probe requests
• Client probe analysis - privacy leak detection from probe requests
• Device correlation - matches WiFi and Bluetooth devices by manufacturer

Bluetooth Scanning

• BLE and Classic Bluetooth device scanning
• Multiple scan modes - hcitool, bluetoothctl, bleak
• Tracker detection - AirTag, Tile, Samsung SmartTag, Chipolo
• Device classification - phones, audio, wearables, computers
• Manufacturer lookup via OUI database and Bluetooth Company IDs
• Proximity radar visualization
• Device type breakdown chart

TSCM Counter-Surveillance Mode

Technical Surveillance Countermeasures (TSCM) screening for detecting wireless surveillance indicators.

Wireless Sweep Features

• BLE scanning with manufacturer data detection (AirTags, Tile, SmartTags, ESP32)
• WiFi scanning for rogue APs, hidden SSIDs, camera devices
• RF spectrum analysis (requires RTL-SDR) - FM bugs, ISM bands, video transmitters
• Cross-protocol correlation - links devices across BLE/WiFi/RF
• Baseline comparison - detect new/unknown devices vs known environment

MAC-Randomization Resistant Detection

• Device fingerprinting based on advertisement payloads, not MAC addresses
• Behavioral clustering - groups observations into probable physical devices
• Session tracking - monitors device presence windows
• Timing pattern analysis - detects characteristic advertising intervals
• RSSI trajectory correlation - identifies co-located devices

Risk Assessment

• Three-tier scoring model:
  • Informational (0-2): Known or expected devices
  • Needs Review (3-5): Unusual devices requiring assessment
  • High Interest (6+): Multiple indicators warrant investigation
• Risk indicators: Stable RSSI, audio-capable, ESP32 chipsets, hidden identity, MAC rotation
• Audit trail - full evidence chain for each link/flag
• Client-safe disclaimers - findings are indicators, not confirmed surveillance

Limitations (Documented)

• Cannot detect non-transmitting devices
• False positives/negatives expected
• Results require professional verification
• No cryptographic de-randomization
• Passive screening only (no active probing by default)

Meshtastic Mesh Networks

Integration with Meshtastic LoRa mesh networking devices for decentralized communication.

Device Support

• Heltec - LoRa32 series
• T-Beam - TTGO T-Beam with GPS
• RAK - WisBlock series
• Any Meshtastic-compatible device via USB/Serial

Features

• Real-time messaging - Stream messages as they arrive
• Channel configuration - Set encryption keys and channel names
• Node information - View connected nodes with signal metrics
• Message history - Up to 500 messages retained
• Signal quality - RSSI and SNR for each message
• Hop tracking - See message hop count

Requirements

• Physical Meshtastic device connected via USB
• Meshtastic Python SDK (pip install meshtastic)

Ubertooth One BLE Scanning

Advanced Bluetooth Low Energy scanning using Ubertooth One hardware.

Capabilities

• 40-channel scanning - Capture BLE advertisements across all channels
• Raw payload access - Full advertising data for analysis
• Passive sniffing - No active scanning required
• MAC address extraction - Public and random address types
• RSSI measurement - Signal strength for proximity estimation

Integration

• Works alongside standard BlueZ/DBus Bluetooth scanning
• Automatically detected when ubertooth-btle is available
• Falls back to standard adapter if Ubertooth not present

Requirements

• Ubertooth One hardware
• ubertooth-btle command-line tool installed
• libubertooth library

Remote Agents (Distributed SIGINT)

Deploy lightweight sensor nodes across multiple locations and aggregate data to a central controller.

Architecture

• Hub-and-spoke model - Central controller with multiple remote agents
• Push and Pull modes - Agents can push data automatically or respond to on-demand requests
• API key authentication - Secure communication between agents and controller

Agent Features

• Standalone deployment - Run on Raspberry Pi, mini PCs, or any Linux device with SDR
• All modes supported - Pager, sensor, ADS-B, AIS, WiFi, Bluetooth, and more
• GPS integration - Automatic location tagging from USB GPS receivers
• Multi-SDR support - Run multiple modes simultaneously on agents with multiple SDRs
• Capability discovery - Controller auto-detects available modes and devices

Controller Features

• Agent management UI - Register, test, and remove agents from /controller/manage
• Real-time status - Health monitoring with online/offline indicators
• Unified data stream - Aggregate data from all agents via SSE
• Dashboard integration - Agent selector in ADS-B, AIS, and main dashboards
• Device conflict detection - Smart warnings when SDR is in use

Use Cases

• Wide-area monitoring - Cover larger geographic areas with distributed sensors
• Remote installations - Deploy sensors in locations without direct access
• Redundancy - Multiple nodes for reliable coverage
• Triangulation - Use multiple GPS-enabled agents for signal location

User Interface

• Mode-specific header stats - real-time badges showing key metrics per mode
• UTC clock - always visible in header for time-critical operations
• Active mode indicator - shows current mode with pulse animation
• Collapsible sections - click any header to collapse/expand
• Panel styling - gradient backgrounds with indicator dots
• Tabbed mode selector with icons (grouped by SDR/RF and Wireless)
• Consistent design - unified styling across main dashboard and popouts
• Dark/Light theme toggle - click moon/sun icon in header, preference saved
• Browser notifications - desktop alerts for critical events (drones, rogue APs, handshakes)
• Built-in help page - accessible via ? button or F1 key

Keyboard Shortcuts

Key	Action
F1	Open help
?	Open help (when not typing)
Escape	Close help/modals

Offline Mode

Run iNTERCEPT without internet connectivity by using bundled local assets.

Bundled Assets

• Leaflet 1.9.4 - Map library with marker images
• Chart.js 4.4.1 - Signal strength graphs
• Inter font - Primary UI font (400, 500, 600, 700 weights)
• JetBrains Mono font - Monospace/code font (400, 500, 600, 700 weights)

Settings Modal

Access via the gear icon in the navigation bar:

• Offline Tab - Toggle offline mode, configure asset sources (CDN vs local)
• Display Tab - Theme and animation preferences
• About Tab - Version info and links

Map Tile Providers

Choose from multiple tile sources for maps:

• OpenStreetMap - Default, general purpose
• CartoDB Dark - Dark themed, matches UI
• CartoDB Positron - Light themed
• ESRI World Imagery - Satellite imagery
• Custom URL - Connect to your own tile server (e.g., local OpenStreetMap tile cache)

Local Asset Status

The settings modal shows availability status for each bundled asset:

• Green "Available" badge when asset is present
• Red "Missing" badge when asset is not found
• Click "Check Assets" to refresh status

Use Cases

• Air-gapped environments - Run on isolated networks
• Field deployments - Operate without reliable internet
• Local tile servers - Use pre-cached map tiles for specific regions
• Reduced latency - Faster loading with local assets

General

• Web-based interface - no desktop app needed
• Live message streaming via Server-Sent Events (SSE)
• Audio alerts with mute toggle
• Message export to CSV/JSON
• Signal activity meter and waterfall display
• Message logging to file with timestamps
• Multi-SDR hardware support - RTL-SDR, LimeSDR, HackRF
• Automatic device detection across all supported hardware
• Hardware-specific validation - frequency/gain ranges per device type
• Configurable gain and PPM correction
• Device intelligence dashboard with tracking
• GPS dongle support - USB GPS receivers for precise observer location
• Disclaimer acceptance on first use
• Auto-stop when switching between modes