diff --git a/README.md b/README.md index 272ca11..f0915c8 100644 --- a/README.md +++ b/README.md @@ -32,6 +32,7 @@ Support the developer of this open-source project - **Aircraft Tracking** - ADS-B via dump1090 with real-time map and radar - **Vessel Tracking** - AIS ship tracking with VHF DSC distress monitoring - **ACARS Messaging** - Aircraft datalink messages via acarsdec +- **VDL2** - VHF Data Link Mode 2 aircraft datalink decoding via dumpvdl2 - **Listening Post** - Wideband frequency scanner with real-time audio monitoring - **Weather Satellites** - NOAA APT and Meteor LRPT image decoding via SatDump with auto-scheduler - **WebSDR** - Remote HF/shortwave listening via KiwiSDR network @@ -244,6 +245,7 @@ Created by **smittix** - [GitHub](https://github.com/smittix) [acarsdec](https://github.com/TLeconte/acarsdec) | [direwolf](https://github.com/wb2osz/direwolf) | [rtl_amr](https://github.com/bemasher/rtlamr) | +[dumpvdl2](https://github.com/szpajder/dumpvdl2) | [aircrack-ng](https://www.aircrack-ng.org/) | [Leaflet.js](https://leafletjs.com/) | [SatDump](https://github.com/SatDump/SatDump) | diff --git a/docs/FEATURES.md b/docs/FEATURES.md index 1b752fb..6f1f8ae 100644 --- a/docs/FEATURES.md +++ b/docs/FEATURES.md @@ -99,6 +99,18 @@ Digital Selective Calling (DSC) monitoring on the international maritime distres - **Multi-SDR support** - RTL-SDR, HackRF, LimeSDR, Airspy, SDRplay - **Message filtering** - filter by message type, flight, or registration +## VDL2 (VHF Data Link Mode 2) + +- **Real-time VDL2 decoding** via dumpvdl2 on standard VDL2 frequencies +- **ACARS-over-AVLC** message capture with full frame parsing +- **Signal analysis** - frequency, signal level, noise level, SNR, burst length +- **AVLC frame details** - source/destination addresses, frame type, command/response +- **Raw JSON inspection** - expandable raw message data for each frame +- **Multi-frequency monitoring** - simultaneous reception on multiple VDL2 channels +- **Multi-SDR support** - RTL-SDR, HackRF, LimeSDR, Airspy, SDRplay +- **CSV/JSON export** - export captured messages for offline analysis +- **Integrated with ADS-B dashboard** - VDL2 messages linked to aircraft tracking + ## Listening Post - **Wideband frequency scanning** via rtl_power sweep with SNR filtering @@ -122,11 +134,23 @@ Digital Selective Calling (DSC) monitoring on the international maritime distres - **Receiver discovery** with automatic caching - **Frequency tuning** with band presets +## ISS SSTV + +- **ISS SSTV image reception** on 145.800 MHz FM during special event transmissions +- **Real-time ISS tracking** with world map and pass predictions +- **Doppler correction** - optional lat/lon input for real-time frequency shift compensation +- **Next pass countdown** - time remaining until ISS is overhead +- **Image gallery** with timestamped decoded imagery +- **TLE updates** - fetch latest ISS orbital elements +- **Multi-SDR support** - RTL-SDR, HackRF, LimeSDR, Airspy, SDRplay + ## HF SSTV - **Terrestrial SSTV decoding** across HF (80m-10m), VHF (6m, 2m), and UHF (70cm) bands -- **Predefined frequency lookup** for active SSTV calling frequencies +- **Predefined frequency lookup** for 13 active SSTV calling frequencies +- **Auto-modulation selection** - frequency table maps to correct mode (USB, LSB, FM) - **Image gallery** with decoded transmissions +- **Common modes supported** - PD120, PD180, Martin1, Scottie1, Robot36 ## APRS diff --git a/docs/USAGE.md b/docs/USAGE.md index a07acff..4cead0e 100644 --- a/docs/USAGE.md +++ b/docs/USAGE.md @@ -69,6 +69,22 @@ INTERCEPT automatically detects known trackers: Common ISM band protocols including garage doors, key fobs, weather stations, and IoT devices in the 300-928 MHz range. +## VDL2 (Aircraft Datalink) + +1. **Select Hardware** - Choose your SDR type +2. **Select Device** - Choose your SDR device +3. **Set Frequencies** - Default VDL2 frequencies are pre-configured (136.975, 136.725, 136.775 MHz etc.) +4. **Start Decoding** - Click "Start" to begin VDL2 reception via dumpvdl2 +5. **View Messages** - AVLC frames appear with source/destination, signal levels, and decoded content +6. **Inspect Details** - Click a message to view full AVLC frame details and raw JSON +7. **Export** - Use CSV or JSON export buttons to save captured messages + +### Tips + +- VDL2 is most active near airports and along flight corridors +- Multiple frequencies can be monitored simultaneously for better coverage +- VDL2 data is also accessible from the ADS-B dashboard + ## Listening Post 1. **Select Hardware** - Choose your SDR type @@ -110,6 +126,23 @@ The system highlights aircraft transmitting emergency squawks: - **7600** - Radio failure - **7700** - General emergency +## ACARS Messaging + +1. **Select Hardware** - Choose your SDR type +2. **Select Device** - Choose your SDR device +3. **Select Region** - Choose North America, Europe, or Asia-Pacific to auto-populate frequencies +4. **Select Frequencies** - Check one or more ACARS frequencies (131.550 MHz primary worldwide, 130.025 MHz secondary USA/Canada, etc.) +5. **Adjust Gain** - Set gain (0 for auto, or 0-50 dB) +6. **Start Decoding** - Click "Start" to begin ACARS reception via acarsdec +7. **View Messages** - Aircraft messages appear in real-time with flight ID, registration, and content + +### Tips + +- A vertical polarization antenna works best for ACARS +- Quarter-wave dipole: 57 cm per element at 130 MHz +- Stock SDR antenna may work at close range near airports +- Outdoor placement with clear sky view significantly improves reception + ## ADS-B History (Optional) The history dashboard persists aircraft messages and per-aircraft snapshots to Postgres for long-running tracking and reporting. @@ -221,6 +254,61 @@ Digital Selective Calling monitoring runs alongside AIS: - Distress positions plotted with pulsing alert markers - Audio alerts for critical messages +## WebSDR + +1. **Set Frequency** - Enter a frequency in kHz (e.g., 6500 for 6.5 MHz) +2. **Select Mode** - Choose demodulation mode (USB, LSB, AM, CW) +3. **Find Receivers** - Click "Find Receivers" to discover available KiwiSDR nodes worldwide +4. **Select Receiver** - Click a receiver from the list to connect +5. **Listen** - Audio streams in real-time via WebSocket +6. **Adjust Volume** - Use the volume slider and monitor the S-meter +7. **Spy Station Presets** - Use the quick-tune buttons to jump to known number station frequencies + +### Tips + +- Requires an internet connection to access the KiwiSDR network +- Receiver list is cached for 1 hour to reduce API load +- Receivers are sorted by distance from your location +- Integrated spy station presets allow quick tuning to SIGINT targets + +## ISS SSTV + +1. **Select Hardware** - Choose your SDR type +2. **Select Device** - Choose your SDR device +3. **Set Frequency** - Default is 145.800 MHz (ISS downlink) +4. **Set Location** - Enter lat/lon for Doppler correction and pass prediction +5. **Update TLE** - Click "Update TLE" to fetch latest ISS orbital elements +6. **Wait for Pass** - The next pass countdown shows when ISS will be overhead +7. **Start Decoding** - Click "Start" to begin SSTV reception +8. **View Images** - Decoded SSTV images appear in the gallery with timestamps + +### Tips + +- A V-dipole or better antenna is required (stock antenna will not work) +- V-dipole construction: 51 cm per element at 145.8 MHz, 120-degree angle between elements +- ISS SSTV events occur during special anniversaries and missions — check ARISS for schedules +- Best passes have elevation > 30 degrees above horizon +- Doppler shift tracking dramatically improves reception quality +- Common SSTV modes: PD120, PD180, Martin1, Scottie1 +- Outdoor antenna placement with clear sky view is essential + +## HF SSTV + +1. **Select Hardware** - Choose your SDR type +2. **Select Device** - Choose your SDR device +3. **Select Frequency** - Choose from 13 preset frequencies or enter a custom one +4. **Modulation** - Auto-selected based on frequency (USB for HF, FM for VHF/UHF) +5. **Start Decoding** - Click "Start" to begin SSTV reception +6. **View Images** - Decoded amateur radio images appear in the gallery + +### Tips + +- HF frequencies (3-30 MHz) require an upconverter with RTL-SDR +- VHF/UHF frequencies (145 MHz, 433 MHz) work directly with RTL-SDR +- Most popular frequency: 14.230 MHz USB (20m band) with regular activity +- Weekend activity peaks on most HF bands +- Amateur license is not required to receive (listen-only) + ## APRS 1. **Select Hardware** - Choose your SDR type @@ -283,6 +371,46 @@ Digital Selective Calling monitoring runs alongside AIS: - GPS fix may take 30-60 seconds after cold start - Accuracy improves with more satellites in view +## TSCM (Counter-Surveillance) + +1. **Select Sweep Type** - Choose from Quick Scan (2 min), Standard (5 min), Full Sweep (15 min), or presets for Wireless Cameras, Body-Worn Devices, or GPS Trackers +2. **Select Scan Sources** - Toggle WiFi, Bluetooth, and/or RF/SDR scanning and select the appropriate interfaces +3. **Select Baseline** - Optionally choose a previously recorded baseline to compare against +4. **Start Sweep** - Click "Start Sweep" to begin scanning +5. **Review Results** - Detected devices are classified and scored by threat level +6. **Record Baseline** - In a known clean environment, record a baseline for future comparison +7. **Export Report** - Generate PDF report, JSON annex, or CSV data + +### Threat Levels + +- **Informational (0-2)** - Known or expected devices +- **Needs Review (3-5)** - Unusual devices requiring assessment +- **High Interest (6+)** - Multiple indicators warrant investigation + +### Tips + +- Record a baseline in a known clean environment before conducting sweeps +- Use the meeting window feature to flag new RF signatures during sensitive periods +- Full functionality requires WiFi adapter, Bluetooth adapter, and SDR hardware +- Threat detection uses a database of 47K+ known tracker fingerprints + +## Spy Stations + +1. **Browse Database** - View the full list of documented number stations and diplomatic networks +2. **Filter by Type** - Toggle between Number Stations and Diplomatic Networks +3. **Filter by Country** - Select specific countries (Russia, Cuba, Israel, Poland, etc.) +4. **Filter by Mode** - Filter by demodulation mode (USB, AM, CW, OFDM) +5. **View Details** - Click "Details" on a station card for full information +6. **Tune In** - Click "Tune In" to route the station frequency to the Listening Post or WebSDR + +### Tips + +- Data sourced from priyom.org (non-profit monitoring community) +- Most activity is on HF bands (3-30 MHz) — propagation varies by time of day +- Notable stations: UVB-76 "The Buzzer" (4625 kHz), E06 English Man, HM01 Cuban Numbers +- Legal to monitor in most countries (check local regulations) +- No decryption or content decoding is included — this is a reference database + ## Meshtastic 1. **Connect Device** - Plug in a Meshtastic device via USB or connect via TCP @@ -291,6 +419,22 @@ Digital Selective Calling monitoring runs alongside AIS: 4. **View Nodes** - Connected nodes displayed with signal metrics (RSSI, SNR) 5. **Send Messages** - Type messages to broadcast on the mesh +## Offline Mode + +1. **Open Settings** - Click the gear icon in the navigation bar +2. **Offline Tab** - Toggle "Offline Mode" to enable local assets +3. **Configure Sources** - Switch assets and fonts from CDN to local +4. **Set Tile Provider** - Choose a map tile provider or enter a custom tile server URL +5. **Check Assets** - Click "Check Assets" to verify all local files are present + +### Tips + +- Download required assets: Leaflet JS/CSS, Chart.js, Inter and JetBrains Mono fonts +- Assets are stored in the `static/vendor/` directory +- For maps, you need a local tile server (e.g., self-hosted OpenStreetMap tiles) +- Missing assets fail gracefully with console warnings +- Useful for air-gapped environments, field deployments, or reducing latency + ## Remote Agents (Distributed SIGINT) Deploy lightweight sensor nodes across multiple locations and aggregate data to a central controller. diff --git a/docs/images/gps.png b/docs/images/gps.png new file mode 100644 index 0000000..ad0182f Binary files /dev/null and b/docs/images/gps.png differ diff --git a/docs/images/iss-sstv.png b/docs/images/iss-sstv.png new file mode 100644 index 0000000..6270772 Binary files /dev/null and b/docs/images/iss-sstv.png differ diff --git a/docs/images/satellite-tracker.png b/docs/images/satellite-tracker.png new file mode 100644 index 0000000..2139a8b Binary files /dev/null and b/docs/images/satellite-tracker.png differ diff --git a/docs/images/spy-stations.png b/docs/images/spy-stations.png new file mode 100644 index 0000000..2ad4066 Binary files /dev/null and b/docs/images/spy-stations.png differ diff --git a/docs/images/vdl2.png b/docs/images/vdl2.png new file mode 100644 index 0000000..91a0a98 Binary files /dev/null and b/docs/images/vdl2.png differ diff --git a/docs/images/weather-satellite.png b/docs/images/weather-satellite.png new file mode 100644 index 0000000..2e95dfc Binary files /dev/null and b/docs/images/weather-satellite.png differ diff --git a/docs/images/websdr.png b/docs/images/websdr.png new file mode 100644 index 0000000..9936e98 Binary files /dev/null and b/docs/images/websdr.png differ diff --git a/docs/index.html b/docs/index.html index ca86413..113ca0f 100644 --- a/docs/index.html +++ b/docs/index.html @@ -35,7 +35,7 @@
Everything you need for signal intelligence in one interface
-Decode POCSAG and FLEX pager messages using rtl_fm and multimon-ng. Monitor emergency services and legacy paging systems.
-Real-time ADS-B tracking with interactive maps, aircraft photos, emergency squawk detection, and range visualization.
-Decode 200+ protocols including weather stations, TPMS, smart home devices, and IoT sensors via rtl_433.
-HackRF-based signal capture and protocol decoding for 300-928 MHz ISM bands with spectrum analysis and replay.
-Frequency scanner with real-time audio monitoring, fine-tuning controls, and customizable frequency presets.
-Track satellites with TLE data, sky plots, ground track visualization, and pass predictions for your location.
-Monitor mode reconnaissance via aircrack-ng. Network discovery, client tracking, and handshake capture.
-Device discovery with tracker detection for AirTags, Tile, Samsung SmartTag, and other Bluetooth devices.
-SAR Bluetooth device location with GPS-tagged signal trail mapping, IRK-based RPA resolution, and proximity audio alerts.
-Real-time GPS position tracking with live map, speed, heading, altitude, satellite info, and track recording.
-Counter-surveillance with baseline recording, threat detection, device correlation, and risk scoring.
-Intercept smart utility meters via rtl_amr. Monitor electricity, gas, and water meter transmissions.
-Real-time AIS ship tracking via AIS-catcher. Monitor maritime traffic with vessel details, course, speed, and destination.
-Number stations and diplomatic HF network database. Frequencies, schedules, and background info from priyom.org.
-Distributed signal intelligence with remote sensor nodes. Deploy agents across multiple locations and aggregate data to a central controller.
-Run without internet using bundled assets. Choose from multiple map tile providers or use your own local tile server.
-LoRa mesh network integration. Connect to Meshtastic devices for decentralized, long-range communication monitoring.
-NOAA APT and Meteor LRPT image decoding via SatDump with auto-scheduler, polar plot, and ground track map.
-Receive Slow Scan Television from the ISS. Real-time tracking globe, pass predictions, and image decoding.
-Terrestrial SSTV on shortwave frequencies. Decode amateur radio image transmissions across HF, VHF, and UHF bands.
-Aircraft datalink messages via acarsdec. Decode operational, weather, and position reports from commercial flights.
-Amateur packet radio position reports and telemetry via direwolf. Track amateur radio operators on an interactive map.
-Remote HF/shortwave listening via the KiwiSDR network. Access receivers worldwide with real-time audio streaming.
-Smart meter monitoring via rtl_amr. Receive electric, gas, and water meter broadcasts in real time.
-Decode POCSAG and FLEX pager messages using rtl_fm and multimon-ng. Monitor emergency services and legacy paging systems.
+Decode 200+ protocols including weather stations, TPMS, smart home devices, and IoT sensors via rtl_433.
+HackRF-based signal capture and protocol decoding for 300-928 MHz ISM bands with spectrum analysis and replay.
+Frequency scanner with real-time audio monitoring, fine-tuning controls, and customizable frequency presets.
+Remote HF/shortwave listening via the KiwiSDR network. Access receivers worldwide with real-time audio streaming.
+Number stations and diplomatic HF network database. Frequencies, schedules, and background info from priyom.org.
+Amateur packet radio position reports and telemetry via direwolf. Track amateur radio operators on an interactive map.
+Smart meter monitoring via rtl_amr. Receive electric, gas, and water meter broadcasts in real time.
+Real-time ADS-B tracking with interactive maps, aircraft photos, emergency squawk detection, and range visualization.
+Aircraft datalink messages via acarsdec. Decode operational, weather, and position reports from commercial flights.
+VHF Data Link Mode 2 aircraft datalink decoding via dumpvdl2. Real-time ACARS-over-AVLC message capture with signal analysis.
+Real-time AIS ship tracking via AIS-catcher. Monitor maritime traffic with vessel details, course, speed, and destination.
+Track satellites with TLE data, sky plots, ground track visualization, and pass predictions for your location.
+NOAA APT and Meteor LRPT image decoding via SatDump with auto-scheduler, polar plot, and ground track map.
+Receive Slow Scan Television from the ISS. Real-time tracking globe, pass predictions, and image decoding.
+Terrestrial SSTV on shortwave frequencies. Decode amateur radio image transmissions across HF, VHF, and UHF bands.
+Real-time GPS position tracking with live map, speed, heading, altitude, satellite info, and track recording.
+Monitor mode reconnaissance via aircrack-ng. Network discovery, client tracking, and handshake capture.
+Device discovery with tracker detection for AirTags, Tile, Samsung SmartTag, and other Bluetooth devices.
+SAR Bluetooth device location with GPS-tagged signal trail mapping, IRK-based RPA resolution, and proximity audio alerts.
+Counter-surveillance with baseline recording, threat detection, device correlation, and risk scoring.
+LoRa mesh network integration. Connect to Meshtastic devices for decentralized, long-range communication monitoring.
+Distributed signal intelligence with remote sensor nodes. Deploy agents across multiple locations and aggregate data to a central controller.
+Run without internet using bundled assets. Choose from multiple map tile providers or use your own local tile server.
+
BT Locate — SAR Tracker
+ Spy Stations
+
+ GPS Receiver
+
+ WebSDR
+
+ VDL2 Aircraft Datalink
+
+ Weather Satellite
+
+ ISS SSTV
+