diff --git a/README.md b/README.md index 1ae0fe8..6e65d7f 100644 --- a/README.md +++ b/README.md @@ -28,16 +28,19 @@ Support the developer of this open-source project - **Pager Decoding** - POCSAG/FLEX via rtl_fm + multimon-ng - **433MHz Sensors** - Weather stations, TPMS, IoT devices via rtl_433 +- **Sub-GHz Analyzer** - RF capture and protocol decoding for 300-928 MHz ISM bands via HackRF - **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 - **DMR Digital Voice** - DMR/P25/NXDN/D-STAR decoding via dsd-fme with visual synthesizer -- **Listening Post** - Frequency scanner with audio monitoring -- **Weather Satellites** - NOAA APT and Meteor LRPT image decoding via SatDump -- **WebSDR** - Remote HF/shortwave listening via WebSDR servers +- **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 - **ISS SSTV** - Slow-scan TV image reception from the International Space Station -- **HF SSTV** - Terrestrial SSTV on shortwave frequencies -- **Satellite Tracking** - Pass prediction using TLE data +- **HF SSTV** - Terrestrial SSTV on shortwave frequencies (80m-10m, VHF, UHF) +- **APRS** - Amateur packet radio position reports and telemetry via direwolf +- **Satellite Tracking** - Pass prediction with polar plot and ground track map +- **Utility Meters** - Electric, gas, and water meter reading via rtl_amr - **ADS-B History** - Persistent aircraft history with reporting dashboard (Postgres optional) - **WiFi Scanning** - Monitor mode reconnaissance via aircrack-ng - **Bluetooth Scanning** - Device discovery and tracker detection (with Ubertooth support) @@ -238,6 +241,9 @@ Created by **smittix** - [GitHub](https://github.com/smittix) [dump1090](https://github.com/flightaware/dump1090) | [AIS-catcher](https://github.com/jvde-github/AIS-catcher) | [acarsdec](https://github.com/TLeconte/acarsdec) | +[dsd-fme](https://github.com/lwvmobile/dsd-fme) | +[direwolf](https://github.com/wb2osz/direwolf) | +[rtl_amr](https://github.com/bemasher/rtlamr) | [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 690cbfb..57e4e11 100644 --- a/docs/FEATURES.md +++ b/docs/FEATURES.md @@ -16,6 +16,14 @@ Complete feature list for all modules. - **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 @@ -84,6 +92,63 @@ Digital Selective Calling (DSC) monitoring on the international maritime distres - **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 diff --git a/docs/USAGE.md b/docs/USAGE.md index e84f5c9..5cd2a11 100644 --- a/docs/USAGE.md +++ b/docs/USAGE.md @@ -57,6 +57,47 @@ INTERCEPT automatically detects known trackers: - Samsung SmartTag - Chipolo +## Sub-GHz Analyzer + +1. **Connect HackRF** - Plug in your HackRF One device +2. **Set Frequency** - Enter a frequency in the 300-928 MHz ISM range or use a preset +3. **Start Capture** - Click "Start Capture" to begin signal analysis +4. **View Spectrum** - Real-time spectrum visualization of the selected band +5. **Protocol Decoding** - Identified protocols are displayed with decoded data + +### Supported Protocols + +Common ISM band protocols including garage doors, key fobs, weather stations, and IoT devices in the 300-928 MHz range. + +## DMR Digital Voice + +1. **Select Hardware** - Choose your SDR type +2. **Set Frequency** - Enter a DMR repeater frequency or use bookmarks +3. **Start Decoding** - Click "Start Decoding" to begin digital voice reception +4. **Listen** - Audio streams via WebSocket to your browser +5. **View Events** - Decoded talkgroup and radio ID information appears in the event log + +### Supported Protocols + +- **DMR** - Digital Mobile Radio (Tier I/II) +- **P25** - APCO Project 25 +- **NXDN** - Kenwood/Icom digital protocol +- **D-STAR** - Icom digital voice + +## Listening Post + +1. **Select Hardware** - Choose your SDR type +2. **Set Frequency Range** - Define start and end frequencies for scanning +3. **Start Scanning** - Click "Start Scan" for wideband sweep +4. **View Signals** - Discovered signals are listed with frequency and SNR +5. **Tune In** - Click a signal to tune the audio demodulator +6. **Listen** - Real-time audio plays in your browser + +### Demodulation Modes + +- **FM** - Narrowband and wideband FM +- **SSB** - Upper and lower sideband for amateur radio and shortwave + ## Aircraft Mode (ADS-B) 1. **Select Hardware** - Choose your SDR type (RTL-SDR uses dump1090, others use readsb) @@ -165,6 +206,58 @@ If the History dashboard shows **HISTORY DISABLED**, enable `INTERCEPT_ADSB_HIST 3. Choose a category (Amateur, Weather, ISS, Starlink, etc.) 4. Select satellites to add +## Weather Satellites + +1. **Set Location** - Enter observer coordinates or use GPS +2. **Select Satellite** - Choose NOAA (APT) or Meteor (LRPT) +3. **View Passes** - Upcoming passes shown with polar plot and ground track +4. **Start Capture** - Click "Start Capture" when a satellite is overhead, or enable auto-scheduler +5. **View Images** - Decoded imagery appears in the gallery + +### Auto-Scheduler + +Enable the auto-scheduler to automatically capture passes: +- Calculates upcoming NOAA and Meteor passes for your location +- Starts SatDump at the correct time and frequency +- Decoded images are saved with timestamps + +## AIS Vessel Tracking + +1. **Select Hardware** - Choose your SDR type +2. **Start Tracking** - Click "Start Tracking" to monitor AIS frequencies (161.975/162.025 MHz) +3. **View Map** - Vessels appear on the interactive maritime map +4. **Click Vessels** - View name, MMSI, callsign, destination, speed, heading +5. **Full Dashboard** - Click "Full Screen Dashboard" for dedicated maritime view + +### VHF DSC Channel 70 + +Digital Selective Calling monitoring runs alongside AIS: +- Distress, Urgency, Safety, and Routine messages +- Distress positions plotted with pulsing alert markers +- Audio alerts for critical messages + +## APRS + +1. **Select Hardware** - Choose your SDR type +2. **Set Frequency** - Defaults to regional APRS frequency (144.390 MHz NA, 144.800 MHz EU) +3. **Start Decoding** - Click "Start Decoding" to begin packet radio reception via direwolf +4. **View Map** - Station positions appear on the interactive map +5. **View Messages** - Position reports, telemetry, and messages displayed in real time + +## Utility Meters + +1. **Start Monitoring** - Click "Start" to begin meter broadcast reception via rtl_amr +2. **View Meters** - Decoded meter data appears with meter ID, type, and consumption +3. **Filter** - Filter by meter type (electric, gas, water) or meter ID + +## Meshtastic + +1. **Connect Device** - Plug in a Meshtastic device via USB or connect via TCP +2. **Start** - Click "Start" to connect to the mesh network +3. **View Messages** - Real-time message stream from the mesh +4. **View Nodes** - Connected nodes displayed with signal metrics (RSSI, SNR) +5. **Send Messages** - Type messages to broadcast on the mesh + ## Remote Agents (Distributed SIGINT) Deploy lightweight sensor nodes across multiple locations and aggregate data to a central controller. diff --git a/docs/index.html b/docs/index.html index ccdadc3..b48348e 100644 --- a/docs/index.html +++ b/docs/index.html @@ -35,7 +35,7 @@
- 15+ + 20+ Modes
@@ -77,6 +77,18 @@

Decode 200+ protocols including weather stations, TPMS, smart home devices, and IoT sensors via rtl_433.

+
+
📻
+

Sub-GHz Analyzer

+

HackRF-based signal capture and protocol decoding for 300-928 MHz ISM bands with spectrum analysis and replay.

+
+ +
+
🎙️
+

DMR Digital Voice

+

DMR, P25, NXDN, and D-STAR digital voice decoding via dsd-fme with audio streaming and visual synthesizer.

+
+
📻

Listening Post

@@ -143,11 +155,47 @@

LoRa mesh network integration. Connect to Meshtastic devices for decentralized, long-range communication monitoring.

+
+
🌧️
+

Weather Satellites

+

NOAA APT and Meteor LRPT image decoding via SatDump with auto-scheduler, polar plot, and ground track map.

+
+
🖼️

ISS SSTV

Receive Slow Scan Television from the ISS. Real-time tracking globe, pass predictions, and image decoding.

+ +
+
🖼️
+

HF SSTV

+

Terrestrial SSTV on shortwave frequencies. Decode amateur radio image transmissions across HF, VHF, and UHF bands.

+
+ +
+
✈️
+

ACARS

+

Aircraft datalink messages via acarsdec. Decode operational, weather, and position reports from commercial flights.

+
+ +
+
📍
+

APRS

+

Amateur packet radio position reports and telemetry via direwolf. Track amateur radio operators on an interactive map.

+
+ +
+
🌐
+

WebSDR

+

Remote HF/shortwave listening via the KiwiSDR network. Access receivers worldwide with real-time audio streaming.

+
+ +
+
⚡
+

Utility Meters

+

Smart meter monitoring via rtl_amr. Receive electric, gas, and water meter broadcasts in real time.

+