- ALPHA: Weather Satellite capture is experimental and may fail depending on SatDump version, SDR driver support, and pass conditions.
-
-
- Receive and decode Meteor LRPT weather imagery.
- Uses SatDump for live SDR capture and image processing, and also shows Meteor imagery produced by the ground-station scheduler.
-
+
+ ALPHA: Weather Satellite capture is experimental and may fail depending on SatDump version, SDR driver support, and pass conditions.
+
+
+ Receive and decode Meteor LRPT weather imagery.
+ Uses SatDump for live SDR capture and image processing, and also shows Meteor imagery produced by the ground-station scheduler.
+
@@ -18,8 +18,9 @@
-
+
+
+
@@ -69,7 +70,7 @@
Connection: Solder elements to coax center + shield, connect to SDR via SMA
- Best starter antenna. Good enough for a clean Meteor LRPT pass when the satellite gets high overhead.
+ Best starter antenna. Good enough for a clean Meteor LRPT pass when the satellite gets high overhead.
@@ -132,8 +133,8 @@
Antenna up: Point the antenna straight UP (zenith) for best overhead coverage
Avoid: Metal roofs, power lines, buildings blocking the sky
Coax length: Keep short (<10m). Signal loss at 137 MHz is ~3 dB per 10m of RG-58
-
LNA: Mount at the antenna feed point, NOT at the SDR end.
- Recommended: a low-noise 137 MHz filtered LNA near the antenna feed point
+
LNA: Mount at the antenna feed point, NOT at the SDR end.
+ Recommended: a low-noise 137 MHz filtered LNA near the antenna feed point
Bias-T: Enable the Bias-T checkbox above if your LNA is powered via the coax from the SDR
@@ -162,9 +163,9 @@
Polarization
RHCP
-
-
Meteor (LRPT) bandwidth
-
~140 kHz
+
+
Meteor (LRPT) bandwidth
+
~140 kHz
@@ -177,29 +178,30 @@
▼
-
- Decode a pre-recorded Meteor IQ file without SDR hardware.
- Shared ground-station recordings are also accepted by the backend.
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+ Decode a pre-recorded Meteor IQ file without SDR hardware.
+ Shared ground-station recordings are also accepted by the backend.
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -223,15 +225,25 @@
+
+
Debug / Test
+
+ Load sample pass data and console output to test the UI without an SDR or live satellite pass.
+
-
+
+ SatDump Documentation
+
+
+ Meteor Reception Guide
+
+
+
+
diff --git a/utils/weather_sat.py b/utils/weather_sat.py
index cdb3344..ff3fbb2 100644
--- a/utils/weather_sat.py
+++ b/utils/weather_sat.py
@@ -1,14 +1,14 @@
-"""Weather satellite decoder focused on Meteor LRPT workflows.
-
-Provides automated capture and decoding of weather imagery using SatDump.
-
-Active satellites:
- - Meteor-M2-3: 137.900 MHz (LRPT)
- - Meteor-M2-4: 137.900 MHz (LRPT)
-
-Legacy NOAA APT entries remain in ``WEATHER_SATELLITES`` for compatibility
-and historical metadata, but they are no longer active operational targets.
-"""
+"""Weather satellite decoder focused on Meteor LRPT workflows.
+
+Provides automated capture and decoding of weather imagery using SatDump.
+
+Active satellites:
+ - Meteor-M2-3: 137.900 MHz (LRPT)
+ - Meteor-M2-4: 137.900 MHz (LRPT)
+
+Legacy NOAA APT entries remain in ``WEATHER_SATELLITES`` for compatibility
+and historical metadata, but they are no longer active operational targets.
+"""
from __future__ import annotations
@@ -29,17 +29,17 @@ from typing import Callable
from utils.logging import get_logger
from utils.process import register_process, safe_terminate
-logger = get_logger('intercept.weather_sat')
-
-PROJECT_ROOT = Path(__file__).resolve().parent.parent
-ALLOWED_OFFLINE_INPUT_DIRS = (
- PROJECT_ROOT / 'data',
- PROJECT_ROOT / 'instance' / 'ground_station' / 'recordings',
-)
+logger = get_logger('intercept.weather_sat')
+
+PROJECT_ROOT = Path(__file__).resolve().parent.parent
+ALLOWED_OFFLINE_INPUT_DIRS = (
+ PROJECT_ROOT / 'data',
+ PROJECT_ROOT / 'instance' / 'ground_station' / 'recordings',
+)
-# Weather satellite definitions.
-# NOAA APT entries are retained as inactive compatibility metadata.
+# Weather satellite definitions.
+# NOAA APT entries are retained as inactive compatibility metadata.
WEATHER_SATELLITES = {
'NOAA-15': {
'name': 'NOAA 15',
@@ -86,6 +86,15 @@ WEATHER_SATELLITES = {
'description': 'Meteor-M2-4 LRPT (digital color imagery)',
'active': True,
},
+ 'METEOR-M2-4-80K': {
+ 'name': 'Meteor-M2-4 (80k)',
+ 'frequency': 137.900,
+ 'mode': 'LRPT',
+ 'pipeline': 'meteor_m2-x_lrpt_80k',
+ 'tle_key': 'METEOR-M2-4',
+ 'description': 'Meteor-M2-4 LRPT 80k baud (fallback symbol rate)',
+ 'active': True,
+ },
}
# Default sample rate for weather satellite reception
@@ -153,12 +162,12 @@ class CaptureProgress:
return result
-class WeatherSatDecoder:
- """Weather satellite decoder using SatDump CLI.
-
- Manages live SDR capture and offline decode for the active Meteor LRPT
- workflow, while preserving compatibility with older weather-sat metadata.
- """
+class WeatherSatDecoder:
+ """Weather satellite decoder using SatDump CLI.
+
+ Manages live SDR capture and offline decode for the active Meteor LRPT
+ workflow, while preserving compatibility with older weather-sat metadata.
+ """
def __init__(self, output_dir: str | Path | None = None):
self._process: subprocess.Popen | None = None
@@ -175,14 +184,14 @@ class WeatherSatDecoder:
self._pty_master_fd: int | None = None
self._current_satellite: str = ''
self._current_frequency: float = 0.0
- self._current_mode: str = ''
- self._capture_start_time: float = 0
- self._device_index: int = -1
- self._capture_output_dir: Path | None = None
- self._on_complete_callback: Callable[[], None] | None = None
- self._capture_phase: str = 'idle'
- self._last_error_message: str = ''
- self._last_process_returncode: int | None = None
+ self._current_mode: str = ''
+ self._capture_start_time: float = 0
+ self._device_index: int = -1
+ self._capture_output_dir: Path | None = None
+ self._on_complete_callback: Callable[[], None] | None = None
+ self._capture_phase: str = 'idle'
+ self._last_error_message: str = ''
+ self._last_process_returncode: int | None = None
# Ensure output directory exists
self._output_dir.mkdir(parents=True, exist_ok=True)
@@ -251,7 +260,7 @@ class WeatherSatDecoder:
No SDR hardware is required — SatDump runs in offline mode.
Args:
- satellite: Satellite key (for example ``'METEOR-M2-3'``)
+ satellite: Satellite key (for example ``'METEOR-M2-3'``)
input_file: Path to IQ baseband or WAV audio file
sample_rate: Sample rate of the recording in Hz
@@ -283,16 +292,16 @@ class WeatherSatDecoder:
input_path = Path(input_file)
- # Security: restrict offline decode inputs to application-owned
- # capture directories so external paths cannot be injected.
- try:
- resolved = input_path.resolve()
- if not any(resolved.is_relative_to(base) for base in ALLOWED_OFFLINE_INPUT_DIRS):
- logger.warning(f"Path traversal blocked in start_from_file: {input_file}")
- msg = 'Input file must be under INTERCEPT data or ground-station recordings'
- self._emit_progress(CaptureProgress(
- status='error',
- message=msg,
+ # Security: restrict offline decode inputs to application-owned
+ # capture directories so external paths cannot be injected.
+ try:
+ resolved = input_path.resolve()
+ if not any(resolved.is_relative_to(base) for base in ALLOWED_OFFLINE_INPUT_DIRS):
+ logger.warning(f"Path traversal blocked in start_from_file: {input_file}")
+ msg = 'Input file must be under INTERCEPT data or ground-station recordings'
+ self._emit_progress(CaptureProgress(
+ status='error',
+ message=msg,
))
return False, msg
except (OSError, ValueError):
@@ -314,13 +323,13 @@ class WeatherSatDecoder:
self._current_satellite = satellite
self._current_frequency = sat_info['frequency']
- self._current_mode = sat_info['mode']
- self._device_index = -1 # Offline decode does not claim an SDR device
- self._capture_start_time = time.time()
- self._capture_phase = 'decoding'
- self._last_error_message = ''
- self._last_process_returncode = None
- self._stop_event.clear()
+ self._current_mode = sat_info['mode']
+ self._device_index = -1 # Offline decode does not claim an SDR device
+ self._capture_start_time = time.time()
+ self._capture_phase = 'decoding'
+ self._last_error_message = ''
+ self._last_process_returncode = None
+ self._stop_event.clear()
try:
self._running = True
@@ -368,7 +377,7 @@ class WeatherSatDecoder:
"""Start weather satellite capture and decode.
Args:
- satellite: Satellite key (for example ``'METEOR-M2-3'``)
+ satellite: Satellite key (for example ``'METEOR-M2-3'``)
device_index: RTL-SDR device index
gain: SDR gain in dB
sample_rate: Sample rate in Hz
@@ -410,13 +419,13 @@ class WeatherSatDecoder:
self._current_satellite = satellite
self._current_frequency = sat_info['frequency']
- self._current_mode = sat_info['mode']
- self._device_index = device_index
- self._capture_start_time = time.time()
- self._capture_phase = 'tuning'
- self._last_error_message = ''
- self._last_process_returncode = None
- self._stop_event.clear()
+ self._current_mode = sat_info['mode']
+ self._device_index = device_index
+ self._capture_start_time = time.time()
+ self._capture_phase = 'tuning'
+ self._last_error_message = ''
+ self._last_process_returncode = None
+ self._stop_event.clear()
try:
self._running = True
@@ -890,17 +899,17 @@ class WeatherSatDecoder:
if was_running:
# Collect exit status (returncode is only set after poll/wait)
- if process and process.returncode is None:
- try:
- process.wait(timeout=5)
- except subprocess.TimeoutExpired:
- process.kill()
- process.wait()
- retcode = process.returncode if process else None
- self._last_process_returncode = retcode
- if retcode and retcode != 0:
- self._capture_phase = 'error'
- self._emit_progress(CaptureProgress(
+ if process and process.returncode is None:
+ try:
+ process.wait(timeout=5)
+ except subprocess.TimeoutExpired:
+ process.kill()
+ process.wait()
+ retcode = process.returncode if process else None
+ self._last_process_returncode = retcode
+ if retcode and retcode != 0:
+ self._capture_phase = 'error'
+ self._emit_progress(CaptureProgress(
status='error',
satellite=self._current_satellite,
frequency=self._current_frequency,
@@ -1143,15 +1152,15 @@ class WeatherSatDecoder:
self._images.clear()
return count
- def _emit_progress(self, progress: CaptureProgress) -> None:
- """Emit progress update to callback."""
- if progress.status == 'error' and progress.message:
- self._last_error_message = str(progress.message)
- if self._callback:
- try:
- self._callback(progress)
- except Exception as e:
- logger.error(f"Error in progress callback: {e}")
+ def _emit_progress(self, progress: CaptureProgress) -> None:
+ """Emit progress update to callback."""
+ if progress.status == 'error' and progress.message:
+ self._last_error_message = str(progress.message)
+ if self._callback:
+ try:
+ self._callback(progress)
+ except Exception as e:
+ logger.error(f"Error in progress callback: {e}")
def get_status(self) -> dict:
"""Get current decoder status."""
@@ -1159,19 +1168,19 @@ class WeatherSatDecoder:
if self._running and self._capture_start_time:
elapsed = int(time.time() - self._capture_start_time)
- return {
- 'available': self._decoder is not None,
- 'decoder': self._decoder,
- 'running': self._running,
- 'satellite': self._current_satellite,
- 'frequency': self._current_frequency,
- 'mode': self._current_mode,
- 'capture_phase': self._capture_phase,
- 'elapsed_seconds': elapsed,
- 'image_count': len(self._images),
- 'last_error': self._last_error_message,
- 'last_returncode': self._last_process_returncode,
- }
+ return {
+ 'available': self._decoder is not None,
+ 'decoder': self._decoder,
+ 'running': self._running,
+ 'satellite': self._current_satellite,
+ 'frequency': self._current_frequency,
+ 'mode': self._current_mode,
+ 'capture_phase': self._capture_phase,
+ 'elapsed_seconds': elapsed,
+ 'image_count': len(self._images),
+ 'last_error': self._last_error_message,
+ 'last_returncode': self._last_process_returncode,
+ }
# Global decoder instance
From 1e5bc0054d33ba8e53f5c9d0611fe38e8f8e0206 Mon Sep 17 00:00:00 2001
From: mitchross
Date: Wed, 25 Mar 2026 01:13:37 -0400
Subject: [PATCH 2/8] Enhance weather satellite UX with pass geometry, guides,
and wider predictions
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Pass prediction improvements:
- Widen prediction window to 48h at 5° min elevation (was 24h/15°)
- Add AOS/TCA/LOS pass geometry detail panel with times and bearings
- Fix duration display (was showing seconds labeled as minutes)
- Enhanced pass cards with AOS/LOS times, bearings, and directions
- Add REFRESH button in passes panel header
- Better empty state with clear "set your location" prompt and icon
Countdown and visual:
- Pulse animation on countdown when pass is imminent or active
- Countdown numbers scale up and change color for urgency
Sidebar getting started guide:
- New "Getting Started" section explaining what Meteor satellites are,
polar orbits, 4-8 passes/day, step-by-step workflow
- "When to look" tips (elevation, day vs night, pass direction)
- "What you need" equipment table with costs
- Collapsed antenna guide by default to reduce initial overwhelm
- Improved offline decode section with clear instructions on where
to get IQ recordings
Co-Authored-By: Claude Opus 4.6 (1M context)
---
static/css/modes/weather-satellite.css | 81 ++++++++++++++++
static/js/modes/weather-satellite.js | 86 +++++++++++++---
templates/index.html | 28 +++++-
.../partials/modes/weather-satellite.html | 97 +++++++++++++++++--
4 files changed, 268 insertions(+), 24 deletions(-)
diff --git a/static/css/modes/weather-satellite.css b/static/css/modes/weather-satellite.css
index bbdc3b8..00b078d 100644
--- a/static/css/modes/weather-satellite.css
+++ b/static/css/modes/weather-satellite.css
@@ -408,6 +408,87 @@
margin: 0 2px;
}
+/* ===== Pass Geometry Detail ===== */
+.wxsat-pass-geometry {
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ gap: 8px;
+ padding: 10px 14px;
+ background: var(--bg-primary, #0d1117);
+ border-bottom: 1px solid var(--border-color, #2a3040);
+ font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
+}
+
+.wxsat-geom-event {
+ display: flex;
+ flex-direction: column;
+ align-items: center;
+ gap: 2px;
+ min-width: 60px;
+}
+
+.wxsat-geom-event.wxsat-geom-tca {
+ color: var(--neon-green);
+}
+
+.wxsat-geom-label {
+ font-size: 9px;
+ font-weight: 600;
+ color: var(--text-dim, #666);
+ text-transform: uppercase;
+ letter-spacing: 0.5px;
+}
+
+.wxsat-geom-tca .wxsat-geom-label {
+ color: var(--neon-green);
+}
+
+.wxsat-geom-time {
+ font-size: 12px;
+ font-weight: 600;
+ color: var(--text-primary, #e0e0e0);
+}
+
+.wxsat-geom-tca .wxsat-geom-time {
+ color: var(--neon-green);
+}
+
+.wxsat-geom-az {
+ font-size: 10px;
+ color: var(--text-dim, #666);
+}
+
+.wxsat-geom-arrow {
+ font-size: 14px;
+ color: var(--text-dim, #444);
+}
+
+.wxsat-geom-meta {
+ font-size: 10px;
+ color: var(--text-dim, #666);
+ margin-left: 8px;
+ padding-left: 8px;
+ border-left: 1px solid var(--border-color, #2a3040);
+ white-space: nowrap;
+}
+
+/* ===== Countdown Pulse Animation ===== */
+.wxsat-countdown-box.imminent .wxsat-cd-value {
+ animation: wxsat-count-pulse 1s ease-in-out infinite;
+ color: var(--accent-yellow);
+}
+
+.wxsat-countdown-box.active .wxsat-cd-value {
+ animation: wxsat-count-pulse 1s ease-in-out infinite;
+ color: var(--neon-green);
+}
+
+@keyframes wxsat-count-pulse {
+ 0%, 100% { transform: scale(1); opacity: 1; }
+ 50% { transform: scale(1.15); opacity: 0.8; }
+}
+
/* ===== Pass Predictions Panel ===== */
.wxsat-passes-panel {
flex: 0 0 280px;
diff --git a/static/js/modes/weather-satellite.js b/static/js/modes/weather-satellite.js
index 4fc3db5..44f47cf 100644
--- a/static/js/modes/weather-satellite.js
+++ b/static/js/modes/weather-satellite.js
@@ -751,7 +751,7 @@ const WeatherSat = (function() {
}
try {
- const url = `/weather-sat/passes?latitude=${storedLat}&longitude=${storedLon}&hours=24&min_elevation=15&trajectory=true&ground_track=true`;
+ const url = `/weather-sat/passes?latitude=${storedLat}&longitude=${storedLon}&hours=48&min_elevation=5&trajectory=true&ground_track=true`;
const response = await fetch(url);
const data = await response.json();
@@ -815,6 +815,42 @@ const WeatherSat = (function() {
// Update polar panel subtitle
const polarSat = document.getElementById('wxsatPolarSat');
if (polarSat) polarSat.textContent = `${pass.name} ${pass.maxEl}\u00b0`;
+
+ // Update pass geometry detail panel
+ updatePassGeometry(pass);
+ }
+
+ /**
+ * Update the AOS/TCA/LOS pass geometry detail panel.
+ */
+ function updatePassGeometry(pass) {
+ const panel = document.getElementById('wxsatPassGeometry');
+ if (!panel) return;
+
+ if (!pass) {
+ panel.style.display = 'none';
+ return;
+ }
+ panel.style.display = 'flex';
+
+ const aosTime = document.getElementById('wxsatGeomAosTime');
+ const aosAz = document.getElementById('wxsatGeomAosAz');
+ const tcaEl = document.getElementById('wxsatGeomTcaEl');
+ const tcaAz = document.getElementById('wxsatGeomTcaAz');
+ const losTime = document.getElementById('wxsatGeomLosTime');
+ const losAz = document.getElementById('wxsatGeomLosAz');
+ const meta = document.getElementById('wxsatGeomMeta');
+
+ const tzLabel = getTZLabel();
+ if (aosTime) aosTime.textContent = formatShortTime(pass.startTimeISO) + tzLabel;
+ if (aosAz) aosAz.textContent = `${Math.round(pass.riseAz || 0)}\u00b0 ${azToDir(pass.riseAz)}`;
+ if (tcaEl) tcaEl.textContent = `${pass.maxEl}\u00b0 el`;
+ if (tcaAz) tcaAz.textContent = `${Math.round(pass.maxElAz || pass.tcaAz || 0)}\u00b0 ${azToDir(pass.maxElAz || pass.tcaAz)}`;
+ if (losTime) losTime.textContent = formatShortTime(pass.endTimeISO) + tzLabel;
+ if (losAz) losAz.textContent = `${Math.round(pass.setAz || 0)}\u00b0 ${azToDir(pass.setAz)}`;
+
+ const durMin = Math.round((pass.duration || 0) / 60);
+ if (meta) meta.textContent = `${durMin} min / ${pass.quality}`;
}
/**
@@ -829,12 +865,28 @@ const WeatherSat = (function() {
if (!container) return;
if (passList.length === 0) {
- const hasLocation = localStorage.getItem('observerLat') !== null;
+ const hasLocation = localStorage.getItem('observerLat') !== null ||
+ (window.ObserverLocation && ObserverLocation.isSharedEnabled() && ObserverLocation.getShared()?.lat);
container.innerHTML = `
-
${hasLocation ? 'No passes in next 24h' : 'Set location to see pass predictions'}
+
+
+ ${hasLocation ? 'No passes in next 24 hours' : 'Set your location'}
+
+
+ ${hasLocation
+ ? 'All Meteor passes may be below the minimum elevation. Try again later.'
+ : 'Enter lat/lon in the strip bar above or click GPS to load pass predictions'}
+
+ Russia's Meteor-M2-3 and Meteor-M2-4
+ are polar-orbiting weather satellites that continuously transmit real-time color imagery (clouds, land, sea) at 137.900 MHz
+ using the LRPT digital format. Unlike old analog NOAA APT, LRPT produces sharp, full-color images.
+
+
+ They orbit ~830 km high, circling the Earth every ~100 minutes in a near-polar sun-synchronous orbit.
+ From any location, you'll typically get 4–8 usable passes per day,
+ each lasting 8–15 minutes as the satellite crosses your sky.
+
+
+
+
+ Step-by-step
+
+
Set your location — Enter your lat/lon in the strip bar above (or click GPS). This is required for pass predictions.
+
Check upcoming passes — The pass list shows when each satellite will be overhead. Higher max elevation = better signal. Passes above 30° are "good", above 60° are "excellent".
+
Prepare your antenna — You need a 137 MHz antenna outdoors with clear sky (see Antenna Guide below). A $5 V-dipole works for high passes.
+
Click Capture on a pass card when it's about to start, or enable AUTO to let the scheduler capture automatically.
+
Wait for images — SatDump will tune, lock the signal, and decode. Decoded images appear in the gallery after the pass completes.
+
+
+
+
+ When to look
+
+
Best passes: When the satellite is high overhead (>30° elevation). The countdown timer shows the next one.
+
Day vs night: Daytime passes produce visible-light imagery. Night passes still work but only produce infrared/thermal images.
+
Both satellites share 137.9 MHz so they won't transmit at the same time. You'll see separate pass predictions for each.
+
Pass direction: Meteor satellites travel roughly north→south or south→north. The pass cards show the exact rise/set direction.
+
+
+
+
+ What you need
+
+
+
SDR receiver
+
RTL-SDR V3/V4 ($25-35)
+
+
+
Antenna
+
137 MHz V-dipole ($5 DIY) or QFH ($20-30)
+
+
+
LNA (optional)
+
137 MHz filtered, at antenna ($15-25)
+
+
+
Location
+
Outdoors, clear sky view
+
+
+
No hardware?
+
Use Load Demo Data below to explore the UI
+
+
+
+
+
+
Satellite
@@ -33,10 +101,13 @@
-
+
-
Antenna Guide
-
+
+ Antenna Guide
+ ▼
+
+
137 MHz band — your stock SDR antenna will NOT work.
@@ -174,14 +245,22 @@
- Test Decode (File)
+ Offline Decode (IQ File)
▼
- Decode a pre-recorded Meteor IQ file without SDR hardware.
- Shared ground-station recordings are also accepted by the backend.
+ Decode a pre-recorded Meteor IQ baseband file without SDR hardware.
+ You need an actual .raw, .sigmf-data, or .wav recording of a Meteor pass.
+
+ Where to get a test file:
+
+
Record one yourself with rtl_sdr -f 137900000 -s 2400000 meteor.raw during a pass