fix: first-load rendering for Waterfall CSS and WebSDR globe

- Waterfall: load waterfall.css eagerly in <head> instead of lazily on mode switch; the lazy inject raced with the panel becoming visible, leaving unstyled HTML for up to 20 s on cold cache - WebSDR: await a requestAnimationFrame before calling Globe()(mapEl) so the browser has committed the display:flex layout and clientWidth/ clientHeight are non-zero; previously the globe WebGL renderer was created at 0×0 (especially on warm-cache refreshes) and could not recover via the deferred resize calls - Bump version to 2.22.2 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
docs: remove RF Heatmap references — feature was not shipped
2026-06-13 00:03:33 -07:00 · 2026-02-23 20:25:05 +00:00 · 2026-02-23 19:40:15 +00:00 · 2026-02-23 19:37:44 +00:00 · 2026-02-23 19:36:55 +00:00 · 2026-02-23 19:36:28 +00:00
197 changed files with 32615 additions and 13144 deletions
@@ -2,6 +2,89 @@
 All notable changes to iNTERCEPT will be documented in this file.
 ## [2.22.2] - 2026-02-23
 ### Fixed
 - Waterfall control panel rendered as unstyled text for up to 20 seconds on first visit — CSS is now loaded eagerly with the rest of the page assets
 - WebSDR globe failed to render on first page load — initialization now waits for a layout frame before mounting the WebGL renderer, ensuring the container has non-zero dimensions
 ---
 ## [2.22.1] - 2026-02-23
 ### Fixed
 - PWA install prompt not appearing — manifest now includes required PNG icons (192×192, 512×512)
 - Apple touch icon updated to PNG for iOS Safari compatibility
 - Service worker cache bumped to bust stale cached assets
 ---
 ## [2.22.0] - 2026-02-23
 ### Added
 - **Waterfall Receiver Overhaul** - WebSocket-based I/Q streaming with server-side FFT, click-to-tune, zoom controls, and auto-scaling
 - **Voice Alerts** - Configurable text-to-speech event notifications across modes
 - **Signal Fingerprinting** - RF device identification and pattern analysis mode
 - **SignalID** - Automatic signal classification via SigIDWiki API integration
 - **PWA Support** - Installable web app with service worker caching and manifest
 - **Real-time Signal Scope** - Live signal visualization for pager, sensor, and SSTV modes
 - **ADS-B MSG2 Surface Parsing** - Ground vehicle movement tracking from MSG2 frames
 - **Cheat Sheets** - Quick reference overlays for keyboard shortcuts and mode controls
 - App icon (SVG) for PWA and browser tab
 ### Changed
 - **WebSDR overhaul** - Improved receiver management, audio streaming, and UI
 - **Mode stop responsiveness** - Faster timeout handling and improved WiFi/Bluetooth scanner shutdown
 - **Mode transitions** - Smoother navigation with performance instrumentation
 - **BT Locate** - Refactored JS engine with improved trail management and signal smoothing
 - **Listening Post** - Refactored with cross-module frequency routing
 - **SSTV decoder** - State machine improvements and partial image streaming
 - Analytics mode removed; per-mode analytics panels integrated into existing dashboards
 ### Fixed
 - ADS-B SSE multi-client fanout stability and update flush timing
 - WiFi scanner robustness and monitor mode teardown reliability
 - Agent client reliability improvements for remote sensor nodes
 - SSTV VIS detector state reporting in signal monitor diagnostics
 ### Documentation
 - Complete documentation audit across README, FEATURES, USAGE, help modal, and GitHub Pages
 - Fixed license badge (MIT → Apache 2.0) to match actual LICENSE file
 - Fixed tool name `rtl_amr` → `rtlamr` throughout all docs
 - Fixed incorrect entry point examples (`python app.py` → `sudo -E venv/bin/python intercept.py`)
 - Removed duplicate AIS Vessel Tracking section from FEATURES.md
 - Updated SSTV requirements: pure Python decoder, no external `slowrx` needed
 - Added ACARS and VDL2 mode descriptions to in-app help modal
 - GitHub Pages site: corrected Docker command, license, and tool name references
 ---
 ## [2.21.1] - 2026-02-20
 ### Fixed
 - BT Locate map first-load rendering race that could cause blank/late map initialization
 - BT Locate mode switch timing so Leaflet invalidation runs after panel visibility settles
 - BT Locate trail restore startup latency by batching historical GPS point rendering
 ---
 ## [2.21.0] - 2026-02-20
 ### Added
 - Analytics panels for operational insights and temporal pattern analysis
 ### Changed
 - Global map theme refresh with improved contrast and cross-dashboard consistency
 - Cross-app UX refinements for accessibility, mode consistency, and render performance
 - BT Locate enhancements including improved continuity, smoothing, and confidence reporting
 ### Fixed
 - Weather satellite auto-scheduler and Mercator tracking reliability issues
 - Bluetooth/WiFi runtime health issues affecting scanner continuity
 - ADS-B SSE multi-client fanout stability and remote VDL2 streaming reliability
 ---
 ## [2.15.0] - 2026-02-09
 ### Added
@@ -41,6 +41,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    bluez \
    bluetooth \
    # GPS support
    gpsd \
    gpsd-clients \
    # Utilities
    # APRS
@@ -56,7 +57,6 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    soapysdr-module-airspy \
    airspy \
    limesuite \
    hackrf \
    # Utilities
    curl \
    procps \
@@ -93,7 +93,8 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    libpulse-dev \
    libfftw3-dev \
    liblapack-dev \
-    libcodec2-dev \
+    libglib2.0-dev \
    libxml2-dev \
    # Build dump1090
    && cd /tmp \
    && git clone --depth 1 https://github.com/flightaware/dump1090.git \
@@ -136,10 +137,29 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    && git clone --depth 1 https://github.com/TLeconte/acarsdec.git \
    && cd acarsdec \
    && mkdir build && cd build \
-    && cmake .. -Drtl=ON \
+    && cmake .. -Drtl=ON -DCMAKE_POLICY_VERSION_MINIMUM=3.5 \
    && make \
    && cp acarsdec /usr/bin/acarsdec \
    && rm -rf /tmp/acarsdec \
    # Build libacars (required by dumpvdl2)
    && cd /tmp \
    && git clone --depth 1 https://github.com/szpajder/libacars.git \
    && cd libacars \
    && mkdir build && cd build \
    && cmake .. \
    && make \
    && make install \
    && ldconfig \
    && rm -rf /tmp/libacars \
    # Build dumpvdl2 (VDL2 aircraft datalink decoder)
    && cd /tmp \
    && git clone --depth 1 https://github.com/szpajder/dumpvdl2.git \
    && cd dumpvdl2 \
    && mkdir build && cd build \
    && cmake .. \
    && make \
    && cp src/dumpvdl2 /usr/bin/dumpvdl2 \
    && rm -rf /tmp/dumpvdl2 \
    # Build slowrx (SSTV decoder) — pinned to known-good commit
    && cd /tmp \
    && git clone https://github.com/windytan/slowrx.git \
@@ -169,6 +189,17 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    fi \
    && cd /tmp \
    && rm -rf /tmp/SatDump \
    # Build hackrf CLI tools from source — avoids libhackrf0 version conflict
    # between the 'hackrf' apt package and soapysdr-module-hackrf's newer libhackrf0
    && cd /tmp \
    && git clone --depth 1 https://github.com/greatscottgadgets/hackrf.git \
    && cd hackrf/host \
    && mkdir build && cd build \
    && cmake .. \
    && make \
    && make install \
    && ldconfig \
    && rm -rf /tmp/hackrf \
    # Build rtlamr (utility meter decoder - requires Go)
    && cd /tmp \
    && curl -fsSL "https://go.dev/dl/go1.22.5.linux-$(dpkg --print-architecture).tar.gz" | tar -C /usr/local -xz \
@@ -177,27 +208,6 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    && go install github.com/bemasher/rtlamr@latest \
    && cp /tmp/gopath/bin/rtlamr /usr/bin/rtlamr \
    && rm -rf /usr/local/go /tmp/gopath \
    # Build mbelib (required by DSD)
    && cd /tmp \
    && git clone https://github.com/lwvmobile/mbelib.git \
    && cd mbelib \
    && (git checkout ambe_tones || true) \
    && mkdir build && cd build \
    && cmake .. \
    && make -j$(nproc) \
    && make install \
    && ldconfig \
    && rm -rf /tmp/mbelib \
    # Build DSD-FME (Digital Speech Decoder for DMR/P25)
    && cd /tmp \
    && git clone --depth 1 https://github.com/lwvmobile/dsd-fme.git \
    && cd dsd-fme \
    && mkdir build && cd build \
    && cmake .. \
    && make -j$(nproc) \
    && make install \
    && ldconfig \
    && rm -rf /tmp/dsd-fme \
    # Cleanup build tools to reduce image size
    # libgtk-3-dev is explicitly removed; runtime GTK libs remain for slowrx
    && apt-get remove -y \
@@ -225,7 +235,6 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    libpulse-dev \
    libfftw3-dev \
    liblapack-dev \
    libcodec2-dev \
    && apt-get autoremove -y \
    && rm -rf /var/lib/apt/lists/*
@@ -1,21 +1,200 @@
 MIT License
-Copyright (c) 2025 smittix
+                                 Apache License
                           Version 2.0, January 2004
                        http://www.apache.org/licenses/
-Permission is hereby granted, free of charge, to any person obtaining a copy
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
+   1. Definitions.
 copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+      "License" shall mean the terms and conditions for use, reproduction,
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+      and distribution as defined by Sections 1 through 9 of this document.
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+      "Licensor" shall mean the copyright owner or entity authorized by
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+      the copyright owner that is granting the License.
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+
-SOFTWARE.
+      "Legal Entity" shall mean the union of the acting entity and all
      other entities that control, are controlled by, or are under common
      control with that entity. For the purposes of this definition,
      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or
      otherwise, or (ii) ownership of fifty percent (50%) or more of the
      outstanding shares, or (iii) beneficial ownership of such entity.
      "You" (or "Your") shall mean an individual or Legal Entity
      exercising permissions granted by this License.
      "Source" form shall mean the preferred form for making modifications,
      including but not limited to software source code, documentation
      source, and configuration files.
      "Object" form shall mean any form resulting from mechanical
      transformation or translation of a Source form, including but
      not limited to compiled object code, generated documentation,
      and conversions to other media types.
      "Work" shall mean the work of authorship, whether in Source or
      Object form, made available under the License, as indicated by a
      copyright notice that is included in or attached to the work
      (an example is provided in the Appendix below).
      "Derivative Works" shall mean any work, whether in Source or Object
      form, that is based on (or derived from) the Work and for which the
      editorial revisions, annotations, elaborations, or other modifications
      represent, as a whole, an original work of authorship. For the purposes
      of this License, Derivative Works shall not include works that remain
      separable from, or merely link (or bind by name) to the interfaces of,
      the Work and Derivative Works thereof.
      "Contribution" shall mean any work of authorship, including
      the original version of the Work and any modifications or additions
      to that Work or Derivative Works thereof, that is intentionally
      submitted to the Licensor for inclusion in the Work by the copyright owner
      or by an individual or Legal Entity authorized to submit on behalf of
      the copyright owner. For the purposes of this definition, "submitted"
      means any form of electronic, verbal, or written communication sent
      to the Licensor or its representatives, including but not limited to
      communication on electronic mailing lists, source code control systems,
      and issue tracking systems that are managed by, or on behalf of, the
      Licensor for the purpose of discussing and improving the Work, but
      excluding communication that is conspicuously marked or otherwise
      designated in writing by the copyright owner as "Not a Contribution."
      "Contributor" shall mean Licensor and any individual or Legal Entity
      on behalf of whom a Contribution has been received by the Licensor and
      subsequently incorporated within the Work.
   2. Grant of Copyright License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      copyright license to reproduce, prepare Derivative Works of,
      publicly display, publicly perform, sublicense, and distribute the
      Work and such Derivative Works in Source or Object form.
   3. Grant of Patent License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      (except as stated in this section) patent license to make, have made,
      use, offer to sell, sell, import, and otherwise transfer the Work,
      where such license applies only to those patent claims licensable
      by such Contributor that are necessarily infringed by their
      Contribution(s) alone or by combination of their Contribution(s)
      with the Work to which such Contribution(s) was submitted. If You
      institute patent litigation against any entity (including a
      cross-claim or counterclaim in a lawsuit) alleging that the Work
      or a Contribution incorporated within the Work constitutes direct
      or contributory patent infringement, then any patent licenses
      granted to You under this License for that Work shall terminate
      as of the date such litigation is filed.
   4. Redistribution. You may reproduce and distribute copies of the
      Work or Derivative Works thereof in any medium, with or without
      modifications, and in Source or Object form, provided that You
      meet the following conditions:
      (a) You must give any other recipients of the Work or
          Derivative Works a copy of this License; and
      (b) You must cause any modified files to carry prominent notices
          stating that You changed the files; and
      (c) You must retain, in the Source form of any Derivative Works
          that You distribute, all copyright, patent, trademark, and
          attribution notices from the Source form of the Work,
          excluding those notices that do not pertain to any part of
          the Derivative Works; and
      (d) If the Work includes a "NOTICE" text file as part of its
          distribution, then any Derivative Works that You distribute must
          include a readable copy of the attribution notices contained
          within such NOTICE file, excluding any notices that do not
          pertain to any part of the Derivative Works, in at least one
          of the following places: within a NOTICE text file distributed
          as part of the Derivative Works; within the Source form or
          documentation, if provided along with the Derivative Works; or,
          within a display generated by the Derivative Works, if and
          wherever such third-party notices normally appear. The contents
          of the NOTICE file are for informational purposes only and
          do not modify the License. You may add Your own attribution
          notices within Derivative Works that You distribute, alongside
          or as an addendum to the NOTICE text from the Work, provided
          that such additional attribution notices cannot be construed
          as modifying the License.
      You may add Your own copyright statement to Your modifications and
      may provide additional or different license terms and conditions
      for use, reproduction, or distribution of Your modifications, or
      for any such Derivative Works as a whole, provided Your use,
      reproduction, and distribution of the Work otherwise complies with
      the conditions stated in this License.
   5. Submission of Contributions. Unless You explicitly state otherwise,
      any Contribution intentionally submitted for inclusion in the Work
      by You to the Licensor shall be under the terms and conditions of
      this License, without any additional terms or conditions.
      Notwithstanding the above, nothing herein shall supersede or modify
      the terms of any separate license agreement you may have executed
      with Licensor regarding such Contributions.
   6. Trademarks. This License does not grant permission to use the trade
      names, trademarks, service marks, or product names of the Licensor,
      except as required for reasonable and customary use in describing the
      origin of the Work and reproducing the content of the NOTICE file.
   7. Disclaimer of Warranty. Unless required by applicable law or
      agreed to in writing, Licensor provides the Work (and each
      Contributor provides its Contributions) on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
      implied, including, without limitation, any warranties or conditions
      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
      PARTICULAR PURPOSE. You are solely responsible for determining the
      appropriateness of using or redistributing the Work and assume any
      risks associated with Your exercise of permissions under this License.
   8. Limitation of Liability. In no event and under no legal theory,
      whether in tort (including negligence), contract, or otherwise,
      unless required by applicable law (such as deliberate and grossly
      negligent acts) or agreed to in writing, shall any Contributor be
      liable to You for damages, including any direct, indirect, special,
      incidental, or consequential damages of any character arising as a
      result of this License or out of the use or inability to use the
      Work (including but not limited to damages for loss of goodwill,
      work stoppage, computer failure or malfunction, or any and all
      other commercial damages or losses), even if such Contributor
      has been advised of the possibility of such damages.
   9. Accepting Warranty or Additional Liability. While redistributing
      the Work or Derivative Works thereof, You may choose to offer,
      and charge a fee for, acceptance of support, warranty, indemnity,
      or other liability obligations and/or rights consistent with this
      License. However, in accepting such obligations, You may act only
      on Your own behalf and on Your sole responsibility, not on behalf
      of any other Contributor, and only if You agree to indemnify,
      defend, and hold each Contributor harmless for any liability
      incurred by, or claims asserted against, such Contributor by reason
      of your accepting any such warranty or additional liability.
   END OF TERMS AND CONDITIONS
   APPENDIX: How to apply the Apache License to your work.
      To apply the Apache License to your work, attach the following
      boilerplate notice, with the fields enclosed by brackets "[]"
      replaced with your own identifying information. (Don't include
      the brackets!)  The text should be enclosed in the appropriate
      comment syntax for the file format. Please also get an OpenPGP
      key and encrypt outgoing communications.
   Copyright 2025 smittix
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at
       http://www.apache.org/licenses/LICENSE-2.0
   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
@@ -2,7 +2,7 @@
 <p align="center">
  <img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python 3.9+">
-  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT License">
+  <img src="https://img.shields.io/badge/license-Apache--2.0-green.svg" alt="Apache 2.0 License">
  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey.svg" alt="Platform">
 </p>
@@ -28,21 +28,27 @@ 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
+- **VDL2** - VHF Data Link Mode 2 aircraft datalink decoding via dumpvdl2
- **Listening Post** - Frequency scanner with audio monitoring
+- **Listening Post** - Wideband frequency scanner with real-time audio monitoring
- **Weather Satellites** - NOAA APT and Meteor LRPT image decoding via SatDump
+- **Weather Satellites** - NOAA APT and Meteor LRPT image decoding via SatDump with auto-scheduler
- **WebSDR** - Remote HF/shortwave listening via WebSDR servers
+- **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
+- **HF SSTV** - Terrestrial SSTV on shortwave frequencies (80m-10m, VHF, UHF)
- **Satellite Tracking** - Pass prediction using TLE data
+- **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 rtlamr
 - **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)
 - **BT Locate** - SAR Bluetooth device location with GPS-tagged signal trail mapping and proximity alerts
 - **GPS** - Real-time GPS position tracking with live map, speed, altitude, and satellite info
 - **TSCM** - Counter-surveillance with RF baseline comparison and threat detection
 - **Meshtastic** - LoRa mesh network integration
 - **Space Weather** - Real-time solar and geomagnetic data from NOAA SWPC, NASA SDO, and HamQSL (no SDR required)
 - **Spy Stations** - Number stations and diplomatic HF network database
 - **Remote Agents** - Distributed SIGINT with remote sensor nodes
 - **Offline Mode** - Bundled assets for air-gapped/field deployments
@@ -51,8 +57,6 @@ Support the developer of this open-source project
 ## Installation / Debian / Ubuntu / MacOS
 ```
 **1. Clone and run:**
 ```bash
 git clone https://github.com/smittix/intercept.git
@@ -144,7 +148,7 @@ Set these as environment variables for either local installs or Docker:
 ```bash
 INTERCEPT_ADSB_AUTO_START=true \
 INTERCEPT_SHARED_OBSERVER_LOCATION=false \
-python app.py
+sudo -E venv/bin/python intercept.py
 ```
 **Docker example (.env)**
@@ -166,7 +170,7 @@ Then open **/adsb/history** for the reporting dashboard.
 After starting, open **http://localhost:5050** in your browser. The username and password is <b>admin</b>:<b>admin</b> 
-The credentials can be change in the ADMIN_USERNAME & ADMIN_PASSWORD variables in config.py
+The credentials can be changed in the ADMIN_USERNAME & ADMIN_PASSWORD variables in config.py
 ---
@@ -224,7 +228,7 @@ This project was developed using AI as a coding partner, combining human directi
 ## License
-MIT License - see [LICENSE](LICENSE)
+Apache 2.0 License - see [LICENSE](LICENSE)
 ## Author
@@ -238,6 +242,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) |
 [direwolf](https://github.com/wb2osz/direwolf) |
 [rtlamr](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) |
@@ -252,3 +259,4 @@ Created by **smittix** - [GitHub](https://github.com/smittix)
@@ -1,4 +1,4 @@
 {
-  "version": "2026-02-01_ba81b697",
+  "version": "2026-02-15_ae16bb62",
-  "downloaded": "2026-02-04T17:06:54.806043Z"
+  "downloaded": "2026-02-20T00:29:06.228007Z"
 }
@@ -25,11 +25,11 @@ import subprocess
 from typing import Any
-from flask import Flask, render_template, jsonify, send_file, Response, request,redirect, url_for, flash, session
+from flask import Flask, render_template, jsonify, send_file, Response, request,redirect, url_for, flash, session, send_from_directory
 from werkzeug.security import check_password_hash
 from config import VERSION, CHANGELOG, SHARED_OBSERVER_LOCATION_ENABLED, DEFAULT_LATITUDE, DEFAULT_LONGITUDE
 from utils.dependencies import check_tool, check_all_dependencies, TOOL_DEPENDENCIES
-from utils.process import cleanup_stale_processes
+from utils.process import cleanup_stale_processes, cleanup_stale_dump1090
 from utils.sdr import SDRFactory
 from utils.cleanup import DataStore, cleanup_manager
 from utils.constants import (
@@ -100,11 +100,24 @@ def add_security_headers(response):
 def inject_offline_settings():
    """Inject offline settings into all templates."""
    from utils.database import get_setting
    # Privacy-first defaults: keep dashboard assets/fonts local to avoid
    # third-party tracker/storage defenses in strict browsers.
    assets_source = str(get_setting('offline.assets_source', 'local') or 'local').lower()
    fonts_source = str(get_setting('offline.fonts_source', 'local') or 'local').lower()
    if assets_source not in ('local', 'cdn'):
        assets_source = 'local'
    if fonts_source not in ('local', 'cdn'):
        fonts_source = 'local'
    # Force local delivery for core dashboard pages.
    assets_source = 'local'
    fonts_source = 'local'
    return {
        'offline_settings': {
            'enabled': get_setting('offline.enabled', False),
-            'assets_source': get_setting('offline.assets_source', 'cdn'),
+            'assets_source': assets_source,
-            'fonts_source': get_setting('offline.fonts_source', 'cdn'),
+            'fonts_source': fonts_source,
            'tile_provider': get_setting('offline.tile_provider', 'cartodb_dark_cyan'),
            'tile_server_url': get_setting('offline.tile_server_url', '')
        }
@@ -150,6 +163,11 @@ acars_process = None
 acars_queue = queue.Queue(maxsize=QUEUE_MAX_SIZE)
 acars_lock = threading.Lock()
 # VDL2 aircraft datalink
 vdl2_process = None
 vdl2_queue = queue.Queue(maxsize=QUEUE_MAX_SIZE)
 vdl2_lock = threading.Lock()
 # APRS amateur radio tracking
 aprs_process = None
 aprs_rtl_process = None
@@ -172,12 +190,6 @@ dsc_rtl_process = None
 dsc_queue = queue.Queue(maxsize=QUEUE_MAX_SIZE)
 dsc_lock = threading.Lock()
 # DMR / Digital Voice
 dmr_process = None
 dmr_rtl_process = None
 dmr_queue = queue.Queue(maxsize=QUEUE_MAX_SIZE)
 dmr_lock = threading.Lock()
 # TSCM (Technical Surveillance Countermeasures)
 tscm_queue = queue.Queue(maxsize=QUEUE_MAX_SIZE)
 tscm_lock = threading.Lock()
@@ -384,6 +396,18 @@ def favicon() -> Response:
    return send_file('favicon.svg', mimetype='image/svg+xml')
@app.route('/sw.js')
 def service_worker() -> Response:
    resp = send_from_directory('static', 'sw.js', mimetype='application/javascript')
    resp.headers['Service-Worker-Allowed'] = '/'
    return resp
@app.route('/manifest.json')
 def pwa_manifest() -> Response:
    return send_from_directory('static', 'manifest.json', mimetype='application/manifest+json')
@app.route('/devices')
 def get_devices() -> Response:
    """Get all detected SDR devices with hardware type info."""
@@ -647,29 +671,75 @@ def export_bluetooth() -> Response:
        })
-def _get_subghz_active() -> bool:
+def _get_subghz_active() -> bool:
-    """Check if SubGHz manager has an active process."""
+    """Check if SubGHz manager has an active process."""
-    try:
+    try:
-        from utils.subghz import get_subghz_manager
+        from utils.subghz import get_subghz_manager
-        return get_subghz_manager().active_mode != 'idle'
+        return get_subghz_manager().active_mode != 'idle'
-    except Exception:
+    except Exception:
-        return False
+        return False
-
+
-
+
-def _get_dmr_active() -> bool:
+def _get_bluetooth_health() -> tuple[bool, int]:
-    """Check if Digital Voice decoder has an active process."""
+    """Return Bluetooth active state and best-effort device count."""
-    try:
+    legacy_running = bt_process is not None and (bt_process.poll() is None if bt_process else False)
-        from routes import dmr as dmr_module
+    scanner_running = False
-        proc = dmr_module.dmr_dsd_process
+    scanner_count = 0
-        return bool(dmr_module.dmr_running and proc and proc.poll() is None)
+
-    except Exception:
+    try:
-        return False
+        from utils.bluetooth.scanner import _scanner_instance as bt_scanner
-
+        if bt_scanner is not None:
-
+            scanner_running = bool(bt_scanner.is_scanning)
-@app.route('/health')
+            scanner_count = int(bt_scanner.device_count)
-def health_check() -> Response:
+    except Exception:
        scanner_running = False
        scanner_count = 0
    locate_running = False
    try:
        from utils.bt_locate import get_locate_session
        session = get_locate_session()
        if session and getattr(session, 'active', False):
            scanner = getattr(session, '_scanner', None)
            locate_running = bool(scanner and scanner.is_scanning)
    except Exception:
        locate_running = False
    return (legacy_running or scanner_running or locate_running), max(len(bt_devices), scanner_count)
 def _get_wifi_health() -> tuple[bool, int, int]:
    """Return WiFi active state and best-effort network/client counts."""
    legacy_running = wifi_process is not None and (wifi_process.poll() is None if wifi_process else False)
    scanner_running = False
    scanner_networks = 0
    scanner_clients = 0
    try:
        from utils.wifi.scanner import _scanner_instance as wifi_scanner
        if wifi_scanner is not None:
            status = wifi_scanner.get_status()
            scanner_running = bool(status.is_scanning)
            scanner_networks = int(status.networks_found or 0)
            scanner_clients = int(status.clients_found or 0)
    except Exception:
        scanner_running = False
        scanner_networks = 0
        scanner_clients = 0
    return (
        legacy_running or scanner_running,
        max(len(wifi_networks), scanner_networks),
        max(len(wifi_clients), scanner_clients),
    )
@app.route('/health')
 def health_check() -> Response:
    """Health check endpoint for monitoring."""
    import time
    bt_active, bt_device_count = _get_bluetooth_health()
    wifi_active, wifi_network_count, wifi_client_count = _get_wifi_health()
    return jsonify({
        'status': 'healthy',
        'version': VERSION,
@@ -680,19 +750,19 @@ def health_check() -> Response:
            'adsb': adsb_process is not None and (adsb_process.poll() is None if adsb_process else False),
            'ais': ais_process is not None and (ais_process.poll() is None if ais_process else False),
            'acars': acars_process is not None and (acars_process.poll() is None if acars_process else False),
            'vdl2': vdl2_process is not None and (vdl2_process.poll() is None if vdl2_process else False),
            'aprs': aprs_process is not None and (aprs_process.poll() is None if aprs_process else False),
-            'wifi': wifi_process is not None and (wifi_process.poll() is None if wifi_process else False),
+            'wifi': wifi_active,
-            'bluetooth': bt_process is not None and (bt_process.poll() is None if bt_process else False),
+            'bluetooth': bt_active,
-            'dsc': dsc_process is not None and (dsc_process.poll() is None if dsc_process else False),
+            'dsc': dsc_process is not None and (dsc_process.poll() is None if dsc_process else False),
-            'dmr': _get_dmr_active(),
+            'subghz': _get_subghz_active(),
-            'subghz': _get_subghz_active(),
+        },
        },
        'data': {
            'aircraft_count': len(adsb_aircraft),
            'vessel_count': len(ais_vessels),
-            'wifi_networks_count': len(wifi_networks),
+            'wifi_networks_count': wifi_network_count,
-            'wifi_clients_count': len(wifi_clients),
+            'wifi_clients_count': wifi_client_count,
-            'bt_devices_count': len(bt_devices),
+            'bt_devices_count': bt_device_count,
            'dsc_messages_count': len(dsc_messages),
        }
    })
@@ -702,8 +772,8 @@ def health_check() -> Response:
 def kill_all() -> Response:
    """Kill all decoder, WiFi, and Bluetooth processes."""
    global current_process, sensor_process, wifi_process, adsb_process, ais_process, acars_process
    global vdl2_process
    global aprs_process, aprs_rtl_process, dsc_process, dsc_rtl_process, bt_process
    global dmr_process, dmr_rtl_process
    # Import adsb and ais modules to reset their state
    from routes import adsb as adsb_module
@@ -714,8 +784,8 @@ def kill_all() -> Response:
    processes_to_kill = [
        'rtl_fm', 'multimon-ng', 'rtl_433',
        'airodump-ng', 'aireplay-ng', 'airmon-ng',
-        'dump1090', 'acarsdec', 'direwolf', 'AIS-catcher',
+        'dump1090', 'acarsdec', 'dumpvdl2', 'direwolf', 'AIS-catcher',
-        'hcitool', 'bluetoothctl', 'satdump', 'dsd',
+        'hcitool', 'bluetoothctl', 'satdump',
        'rtl_tcp', 'rtl_power', 'rtlamr', 'ffmpeg',
        'hackrf_transfer', 'hackrf_sweep'
    ]
@@ -751,6 +821,10 @@ def kill_all() -> Response:
    with acars_lock:
        acars_process = None
    # Reset VDL2 state
    with vdl2_lock:
        vdl2_process = None
    # Reset APRS state
    with aprs_lock:
        aprs_process = None
@@ -761,11 +835,6 @@ def kill_all() -> Response:
        dsc_process = None
        dsc_rtl_process = None
    # Reset DMR state
    with dmr_lock:
        dmr_process = None
        dmr_rtl_process = None
    # Reset Bluetooth state (legacy)
    with bt_lock:
        if bt_process:
@@ -877,6 +946,7 @@ def main() -> None:
    # Clean up any stale processes from previous runs
    cleanup_stale_processes()
    cleanup_stale_dump1090()
    # Initialize database for settings storage
    from utils.database import init_db
@@ -7,10 +7,103 @@ import os
 import sys
 # Application version
-VERSION = "2.16.0"
+VERSION = "2.22.2"
 # Changelog - latest release notes (shown on welcome screen)
 CHANGELOG = [
    {
        "version": "2.22.2",
        "date": "February 2026",
        "highlights": [
            "Waterfall control panel no longer shows as unstyled text on first visit",
            "WebSDR globe renders correctly on first page load without requiring a refresh",
        ]
    },
    {
        "version": "2.22.1",
        "date": "February 2026",
        "highlights": [
            "Waterfall receiver overhaul: WebSocket I/Q streaming with server-side FFT, click-to-tune, and zoom controls",
            "Voice alerts for configurable event notifications across modes",
            "Signal fingerprinting mode for RF device identification and pattern analysis",
            "SignalID integration via SigIDWiki API for automatic signal classification",
            "PWA support: installable web app with service worker and manifest",
            "Mode stop responsiveness improvements with faster timeout handling",
            "Navigation performance instrumentation and smoother mode transitions",
            "Pager, sensor, and SSTV real-time signal scope visualization",
            "ADS-B MSG2 surface movement parsing for ground vehicle tracking",
            "WebSDR major overhaul with improved receiver management and audio streaming",
            "Documentation audit: fixed license, tool names, entry points, and SSTV decoder references",
            "Help modal updated with ACARS and VDL2 mode descriptions",
        ]
    },
    {
        "version": "2.21.1",
        "date": "February 2026",
        "highlights": [
            "BT Locate map first-load fix with render stabilization retries during initial mode open",
            "BT Locate trail restore optimization for faster startup when historical GPS points exist",
            "BT Locate mode-switch map invalidation timing fix to prevent delayed/blank map render",
        ]
    },
    {
        "version": "2.21.0",
        "date": "February 2026",
        "highlights": [
            "Global map theme refresh with improved contrast and cross-dashboard consistency",
            "Cross-app UX updates for accessibility, mode consistency, and render performance",
            "Weather satellite reliability fixes for auto-scheduler and Mercator pass tracking",
            "Bluetooth/WiFi runtime health fixes with BT Locate continuity and confidence improvements",
            "ADS-B/VDL2 streaming reliability upgrades for multi-client SSE fanout and remote decoding",
            "Analytics enhancements with operational insights and temporal pattern panels",
        ]
    },
    {
        "version": "2.20.0",
        "date": "February 2026",
        "highlights": [
            "Space Weather mode: real-time solar and geomagnetic monitoring from NOAA SWPC, NASA SDO, and HamQSL",
            "Kp index, solar wind, X-ray flux charts with Chart.js visualization",
            "HF band conditions, D-RAP absorption maps, aurora forecast, and solar imagery",
            "NOAA Space Weather Scales (G/S/R), flare probability, and active solar regions",
            "No SDR hardware required — all data from public APIs with server-side caching",
        ]
    },
    {
        "version": "2.19.0",
        "date": "February 2026",
        "highlights": [
            "VDL2 mode with modal message viewer, consolidated into ADS-B dashboard",
            "ADS-B: trails enabled by default, radar modes removed, CSV export added",
            "Bundled Roboto Condensed font for offline mode with SVG icon overhaul",
            "Help modal updated with all modes and correct SVG icons",
            "Setup script overhauled for reliability and macOS compatibility",
            "GPS fix for preserving satellites across DOP-only SKY messages",
            "Fix gpsd deadlock causing GPS connect to hang",
        ]
    },
    {
        "version": "2.18.0",
        "date": "February 2026",
        "highlights": [
            "Bluetooth: service data inspector, appearance codes, MAC cluster tracking, and behavioral flags",
            "Bluetooth: IRK badge display, distance estimation with confidence, and signal stability metrics",
            "ACARS: SoapySDR device support for SDRplay, LimeSDR, Airspy, and other non-RTL backends",
            "ADS-B: stale dump1090 process cleanup via PID file tracking",
            "GPS: error state indicator and UI refinements",
            "Proximity radar and signal card UI improvements",
        ]
    },
    {
        "version": "2.17.0",
        "date": "February 2026",
        "highlights": [
            "BT Locate: SAR Bluetooth device location with GPS-tagged signal trail and proximity alerts",
            "IRK auto-detection: extract Identity Resolving Keys from paired devices (macOS/Linux)",
            "GPS mode: real-time position tracking with live map, speed, altitude, and satellite info",
            "Bluetooth scanner lifecycle fix for bleak scan timeout tracking",
        ]
    },
    {
        "version": "2.16.0",
        "date": "February 2026",
@@ -18,7 +111,6 @@ CHANGELOG = [
            "Sub-GHz analyzer with real-time RF capture and protocol decoding",
            "Weather satellite auto-scheduler with polar plot and ground track map",
            "SatDump support for local (non-Docker) installs via setup.sh",
            "DMR audio output, frequency persistence, and bookmarks",
            "Shared waterfall UI across SDR modes",
            "Listening post audio stuttering fix and SDR race condition fixes",
            "Multi-arch Docker build support (amd64 + arm64)",
@@ -33,7 +125,6 @@ CHANGELOG = [
            "Pure Python SSTV decoder replacing broken slowrx dependency",
            "Real-time signal scope for pager, sensor, and SSTV modes",
            "USB-level device probe to prevent cryptic rtl_fm crashes",
            "DMR dsd-fme protocol fixes, tuning controls, and state sync",
            "SDR device lock-up fix from unreleased device registry on crash",
        ]
    },
@@ -41,8 +132,6 @@ CHANGELOG = [
        "version": "2.14.0",
        "date": "February 2026",
        "highlights": [
            "DMR/P25/NXDN/D-STAR digital voice decoder with dsd-fme",
            "DMR visual synthesizer with event-driven spring-physics bars",
            "HF SSTV general mode with predefined shortwave frequencies",
            "WebSDR integration for remote HF/shortwave listening",
            "Listening Post signal scanner and audio pipeline improvements",
@@ -16,16 +16,13 @@ Complete feature list for all modules.
 - **Doorbells, remotes, and IoT devices**
 - **Smart meters** and utility monitors
-## AIS Vessel Tracking
+## Sub-GHz Analyzer
- **Real-time vessel tracking** via AIS-catcher on 161.975/162.025 MHz
+- **HackRF-based** signal capture and analysis for 300-928 MHz ISM bands
- **Full-screen dashboard** - dedicated popout with interactive map
+- **Protocol decoding** - identify and decode common Sub-GHz protocols
- **Interactive Leaflet map** with OpenStreetMap tiles (dark-themed)
+- **Signal replay/transmit** capabilities for authorized testing
- **Vessel details popup** - name, MMSI, callsign, destination, ETA
+- **Wideband spectrum analysis** with real-time visualization
- **Navigation data** - speed, course, heading, rate of turn
+- **I/Q capture** - record raw samples for offline analysis
 - **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)
@@ -84,6 +81,95 @@ 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
 ## 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
 - **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
 ## 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 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
 - **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
 ## Space Weather
 - **Real-time solar indices** - Solar Flux Index (SFI), Kp index, A-index, sunspot number
 - **NOAA Space Weather Scales** - Geomagnetic storms (G), solar radiation (S), radio blackouts (R)
 - **HF band conditions** - Day/night propagation from HamQSL for 80m through 10m bands
 - **Solar wind monitoring** - Speed, density, and IMF Bz from DSCOVR satellite
 - **X-ray flux chart** - GOES X-ray data with flare class scale (A/B/C/M/X)
 - **Flare probability** - 1-day and 3-day C/M/X-class flare forecasts
 - **Solar imagery** - NASA SDO 193A, 304A, and magnetogram images
 - **D-RAP absorption maps** - HF radio absorption at 5-30 MHz frequency bands
 - **Aurora forecast** - OVATION aurora oval visualization
 - **SWPC alerts** - Real-time space weather alerts and warnings
 - **Active solar regions** - Current sunspot region data with location and area
 - **Auto-refresh** - 5-minute polling with manual refresh option
 - **No SDR required** - Data fetched from NOAA SWPC, NASA SDO, and HamQSL public APIs
 ## Satellite Tracking
 - **Full-screen dashboard** - dedicated popout with polar plot and ground track
@@ -131,6 +217,52 @@ Digital Selective Calling (DSC) monitoring on the international maritime distres
 - **Proximity radar** visualization
 - **Device type breakdown** chart
 ## BT Locate (SAR Bluetooth Device Location)
 Search and rescue Bluetooth device location with GPS-tagged signal trail mapping.
 ### Core Features
 - **Target tracking** - Locate devices by MAC address, name pattern, or IRK (Identity Resolving Key)
 - **RPA resolution** - Resolve BLE Resolvable Private Addresses using IRK for tracking devices with randomized addresses
 - **IRK auto-detection** - Extract IRKs from paired devices on macOS and Linux
 - **GPS-tagged signal trail** - Every detection is tagged with GPS coordinates for trail mapping
 - **Proximity bands** - IMMEDIATE (<1m), NEAR (1-5m), FAR (>5m) with color-coded HUD
 - **RSSI history chart** - Real-time signal strength sparkline for trend analysis
 - **Distance estimation** - Log-distance path loss model with environment presets
 - **Audio proximity alerts** - Web Audio API tones that increase in pitch as signal strengthens
 - **Hand-off from Bluetooth mode** - One-click transfer of a device from BT scanner to BT Locate
 ### Environment Presets
 - **Open Field** (n=2.0) - Free space path loss
 - **Outdoor** (n=2.2) - Typical outdoor environment
 - **Indoor** (n=3.0) - Indoor with walls and obstacles
 ### Map & Trail
 - Interactive Leaflet map with GPS trail visualization
 - Trail points color-coded by proximity band
 - Polyline connecting detection points for path visualization
 - Supports user-configured tile providers
 ### Requirements
 - Bluetooth adapter (built-in or USB)
 - GPS receiver (optional, falls back to manual coordinates)
 ## GPS Mode
 Real-time GPS position tracking with live map visualization.
 ### Features
 - **Live position tracking** - Real-time latitude, longitude, altitude display
 - **Interactive map** - Current position on Leaflet map with track history
 - **Speed and heading** - Real-time speed (km/h) and compass heading
 - **Satellite info** - Number of satellites in view and fix quality
 - **Track recording** - Record GPS tracks with export capability
 - **Accuracy display** - Horizontal and vertical position accuracy (EPX/EPY)
 ### Requirements
 - USB GPS receiver connected via gpsd
 - gpsd daemon running (`sudo gpsd /dev/ttyUSB0 -F /var/run/gpsd.sock`)
 ## TSCM Counter-Surveillance Mode
 Technical Surveillance Countermeasures (TSCM) screening for detecting wireless surveillance indicators.
@@ -206,14 +206,22 @@ Extended base for full-screen dashboards (maps, visualizations).
 | `listening` | Listening post |
 | `spystations` | Spy stations |
 | `meshtastic` | Mesh networking |
-
+| `weathersat` | Weather satellites |
-### Navigation Groups
+| `sstv_general` | HF SSTV |
 | `gps` | GPS tracking |
 | `websdr` | WebSDR |
 | `subghz` | Sub-GHz analyzer |
 | `bt_locate` | BT Locate |
 | `analytics` | Analytics dashboard |
 | `spaceweather` | Space weather |
 ### Navigation Groups
 The navigation is organized into groups:
- **SDR / RF**: Pager, 433MHz, Meters, Aircraft, Vessels, APRS, Listening Post, Spy Stations, Meshtastic
+- **Signals**: Pager, 433MHz, Meters, Listening Post, SubGHz
- **Wireless**: WiFi, Bluetooth
+- **Tracking**: Aircraft, Vessels, APRS, GPS
- **Security**: TSCM
+- **Space**: Satellite, ISS SSTV, Weather Sat, HF SSTV, Space Weather
- **Space**: Satellite, ISS SSTV
+- **Wireless**: WiFi, Bluetooth, BT Locate, Meshtastic
 - **Intel**: TSCM, Analytics, Spy Stations, WebSDR
 ---
@@ -57,6 +57,48 @@ 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.
 ## 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
 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)
@@ -84,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.
@@ -113,7 +172,7 @@ Set the following environment variables (Docker recommended):
 ```bash
 INTERCEPT_ADSB_AUTO_START=true \
 INTERCEPT_SHARED_OBSERVER_LOCATION=false \
-python app.py
+sudo -E venv/bin/python intercept.py
 ```
 **Docker example (.env)**
@@ -165,6 +224,236 @@ 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
 ## Space Weather
 1. **Switch to Space Weather mode** - Select "Space Weather" from the Space navigation group
 2. **View Dashboard** - Solar indices, NOAA scales, band conditions, and charts load automatically
 3. **Solar Imagery** - Toggle between SDO 193A, 304A, and Magnetogram views
 4. **D-RAP Maps** - Select frequency (5-30 MHz) to view HF radio absorption maps
 5. **Aurora Forecast** - View the OVATION aurora oval for the northern hemisphere
 6. **Alerts** - Review current SWPC space weather alerts and warnings
 7. **Active Regions** - View solar active region data (number, location, area)
 8. **Refresh** - Data auto-refreshes every 5 minutes, or click "Refresh Now"
 ### Tips
 - No SDR hardware required — all data comes from public APIs (NOAA SWPC, NASA SDO, HamQSL)
 - Check HF band conditions before operating on shortwave frequencies
 - Kp >= 5 indicates geomagnetic storm conditions that may affect HF propagation
 - D-RAP maps show where HF absorption is highest — useful for path planning
 - Solar imagery updates approximately every 15 minutes from NASA SDO
 ## 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
 ## 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
 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
 ## BT Locate (SAR Device Location)
 1. **Set Target** - Enter one or more target identifiers:
   - **MAC Address** - Exact Bluetooth address (AA:BB:CC:DD:EE:FF)
   - **Name Pattern** - Substring match (e.g., "iPhone", "Galaxy")
   - **IRK** - 32-character hex Identity Resolving Key for RPA resolution
   - **Detect IRKs** - Click "Detect" to auto-extract IRKs from paired devices
 2. **Choose Environment** - Select the RF environment preset:
   - **Open Field** (n=2.0) - Best for open areas with line-of-sight
   - **Outdoor** (n=2.2) - Default, works well in most outdoor settings
   - **Indoor** (n=3.0) - For buildings with walls and obstacles
 3. **Start Locate** - Click "Start Locate" to begin tracking
 4. **Monitor HUD** - The proximity display shows:
   - Proximity band (IMMEDIATE / NEAR / FAR)
   - Estimated distance in meters
   - Raw RSSI and smoothed RSSI average
   - Detection count and GPS-tagged points
 5. **Follow the Signal** - Move towards stronger signal (higher RSSI / closer distance)
 6. **Audio Alerts** - Enable audio for proximity tones that increase in pitch as you get closer
 7. **Review Trail** - Check the map for GPS-tagged detection trail
 ### Hand-off from Bluetooth Mode
 1. Open Bluetooth scanning mode and find the target device
 2. Click the "Locate" button on the device card
 3. BT Locate opens with the device pre-filled
 4. Click "Start Locate" to begin tracking
 ### Tips
 - For devices with address randomization (iPhones, modern Android), use the IRK method
 - Click "Detect" next to the IRK field to auto-extract IRKs from paired devices
 - The RSSI chart shows signal trend over time — use it to determine if you're getting closer
 - Clear the trail when starting a new search area
 ## GPS Mode
 1. **Start GPS** - Click "Start" to connect to gpsd and begin position tracking
 2. **View Map** - Your position appears on the interactive map with a track trail
 3. **Monitor Stats** - Speed, heading, altitude, and satellite count displayed in real-time
 4. **Record Track** - Enable track recording to save your path
 ### Tips
 - Ensure gpsd is running: `sudo gpsd /dev/ttyUSB0 -F /var/run/gpsd.sock`
 - 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
 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
 ## 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.
@@ -11,6 +11,7 @@
    <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
 </head>
 <body>
    <canvas id="bg-canvas"></canvas>
    <nav class="navbar">
        <div class="nav-container">
            <a href="#" class="nav-logo">iNTERCEPT</a>
@@ -35,7 +36,7 @@
            </div>
            <div class="hero-stats">
                <div class="stat">
-                    <span class="stat-value">15+</span>
+                    <span class="stat-value">25+</span>
                    <span class="stat-label">Modes</span>
                </div>
                <div class="stat">
@@ -58,97 +59,149 @@
            <h2>Capabilities</h2>
            <p class="section-subtitle">Everything you need for signal intelligence in one interface</p>
-            <div class="features-grid">
+            <div class="carousel-filters">
-                <div class="feature-card">
+                <button class="filter-btn active" data-filter="all">All</button>
-                    <div class="feature-icon">📟</div>
+                <button class="filter-btn" data-filter="signals">Signals</button>
-                    <h3>Pager Decoding</h3>
+                <button class="filter-btn" data-filter="tracking">Tracking</button>
-                    <p>Decode POCSAG and FLEX pager messages using rtl_fm and multimon-ng. Monitor emergency services and legacy paging systems.</p>
+                <button class="filter-btn" data-filter="space">Space</button>
-                </div>
+                <button class="filter-btn" data-filter="wireless">Wireless</button>
-
+                <button class="filter-btn" data-filter="intel">Intel</button>
-                <div class="feature-card">
+                <button class="filter-btn" data-filter="platform">Platform</button>
                    <div class="feature-icon">✈️</div>
                    <h3>Aircraft Tracking</h3>
                    <p>Real-time ADS-B tracking with interactive maps, aircraft photos, emergency squawk detection, and range visualization.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">📡</div>
                    <h3>433MHz Sensors</h3>
                    <p>Decode 200+ protocols including weather stations, TPMS, smart home devices, and IoT sensors via rtl_433.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">📻</div>
                    <h3>Listening Post</h3>
                    <p>Frequency scanner with real-time audio monitoring, fine-tuning controls, and customizable frequency presets.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">🛰️</div>
                    <h3>Satellite Tracking</h3>
                    <p>Track satellites with TLE data, sky plots, ground track visualization, and pass predictions for your location.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">📶</div>
                    <h3>WiFi Scanning</h3>
                    <p>Monitor mode reconnaissance via aircrack-ng. Network discovery, client tracking, and handshake capture.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">🔵</div>
                    <h3>Bluetooth Scanning</h3>
                    <p>Device discovery with tracker detection for AirTags, Tile, Samsung SmartTag, and other Bluetooth devices.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">🛡️</div>
                    <h3>TSCM</h3>
                    <p>Counter-surveillance with baseline recording, threat detection, device correlation, and risk scoring.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">⚡</div>
                    <h3>Meter Reading</h3>
                    <p>Intercept smart utility meters via rtl_amr. Monitor electricity, gas, and water meter transmissions.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">🚢</div>
                    <h3>Vessel Tracking</h3>
                    <p>Real-time AIS ship tracking via AIS-catcher. Monitor maritime traffic with vessel details, course, speed, and destination.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">🔢</div>
                    <h3>Spy Stations</h3>
                    <p>Number stations and diplomatic HF network database. Frequencies, schedules, and background info from priyom.org.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">🌐</div>
                    <h3>Remote Agents</h3>
                    <p>Distributed signal intelligence with remote sensor nodes. Deploy agents across multiple locations and aggregate data to a central controller.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">📴</div>
                    <h3>Offline Mode</h3>
                    <p>Run without internet using bundled assets. Choose from multiple map tile providers or use your own local tile server.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">📡</div>
                    <h3>Meshtastic</h3>
                    <p>LoRa mesh network integration. Connect to Meshtastic devices for decentralized, long-range communication monitoring.</p>
                </div>
                <div class="feature-card">
                    <div class="feature-icon">🖼️</div>
                    <h3>ISS SSTV</h3>
                    <p>Receive Slow Scan Television from the ISS. Real-time tracking globe, pass predictions, and image decoding.</p>
                </div>
            </div>
            <div class="carousel-wrapper">
                <button class="carousel-arrow carousel-arrow-left" aria-label="Scroll left">&#8249;</button>
                <div class="carousel-track">
                    <div class="feature-card" data-category="signals">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="5" width="20" height="14" rx="2"/><line x1="6" y1="9" x2="6" y2="15"/><line x1="10" y1="9" x2="10" y2="15"/><line x1="14" y1="11" x2="18" y2="11"/><line x1="14" y1="13" x2="18" y2="13"/></svg></div>
                        <h3>Pager Decoding</h3>
                        <p>Decode POCSAG and FLEX pager messages using rtl_fm and multimon-ng. Monitor emergency services and legacy paging systems.</p>
                    </div>
                    <div class="feature-card" data-category="signals">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v4"/><path d="M12 18v4"/><circle cx="12" cy="12" r="4"/><path d="M4.93 4.93l2.83 2.83"/><path d="M16.24 16.24l2.83 2.83"/><path d="M2 12h4"/><path d="M18 12h4"/><path d="M4.93 19.07l2.83-2.83"/><path d="M16.24 7.76l2.83-2.83"/></svg></div>
                        <h3>433MHz Sensors</h3>
                        <p>Decode 200+ protocols including weather stations, TPMS, smart home devices, and IoT sensors via rtl_433.</p>
                    </div>
                    <div class="feature-card" data-category="signals">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M2 12h4l3-9 6 18 3-9h4"/></svg></div>
                        <h3>Sub-GHz Analyzer</h3>
                        <p>HackRF-based signal capture and protocol decoding for 300-928 MHz ISM bands with spectrum analysis and replay.</p>
                    </div>
                    <div class="feature-card" data-category="signals">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 18.5a6.5 6.5 0 1 1 0-13"/><path d="M17 12h5"/><path d="M12 7V2"/><circle cx="12" cy="12" r="2"/><path d="M8.5 8.5L5 5"/></svg></div>
                        <h3>Listening Post</h3>
                        <p>Frequency scanner with real-time audio monitoring, fine-tuning controls, and customizable frequency presets.</p>
                    </div>
                    <div class="feature-card" data-category="intel">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></div>
                        <h3>WebSDR</h3>
                        <p>Remote HF/shortwave listening via the KiwiSDR network. Access receivers worldwide with real-time audio streaming.</p>
                    </div>
                    <div class="feature-card" data-category="intel">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="4" y="4" width="16" height="16" rx="2"/><path d="M8 8h2v2H8z"/><path d="M14 8h2v2h-2z"/><path d="M8 14h2v2H8z"/><path d="M14 14h2v2h-2z"/><path d="M11 8h2v2h-2z"/><path d="M11 11h2v2h-2z"/></svg></div>
                        <h3>Spy Stations</h3>
                        <p>Number stations and diplomatic HF network database. Frequencies, schedules, and background info from priyom.org.</p>
                    </div>
                    <div class="feature-card" data-category="tracking">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z"/><circle cx="12" cy="10" r="3"/></svg></div>
                        <h3>APRS</h3>
                        <p>Amateur packet radio position reports and telemetry via direwolf. Track amateur radio operators on an interactive map.</p>
                    </div>
                    <div class="feature-card" data-category="signals">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M13 2L3 14h9l-1 8 10-12h-9l1-8z"/></svg></div>
                        <h3>Utility Meters</h3>
                        <p>Smart meter monitoring via rtlamr. Receive electric, gas, and water meter broadcasts in real time.</p>
                    </div>
                    <div class="feature-card" data-category="tracking">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M17.8 19.2L16 11l3.5-3.5C21 6 21.5 4 21 3c-1-.5-3 0-4.5 1.5L13 8 4.8 6.2c-.5-.1-.9.1-1.1.5l-.3.5c-.2.5-.1 1 .3 1.3L9 12l-2 3H4l-1 1 3 2 2 3 1-1v-3l3-2 3.5 5.3c.3.4.8.5 1.3.3l.5-.2c.4-.3.6-.7.5-1.2z"/></svg></div>
                        <h3>Aircraft Tracking</h3>
                        <p>Real-time ADS-B tracking with interactive maps, aircraft photos, emergency squawk detection, and range visualization.</p>
                    </div>
                    <div class="feature-card" data-category="tracking">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M7 8h10"/><path d="M7 12h6"/><path d="M7 16h8"/></svg></div>
                        <h3>ACARS</h3>
                        <p>Aircraft datalink messages via acarsdec. Decode operational, weather, and position reports from commercial flights.</p>
                    </div>
                    <div class="feature-card" data-category="tracking">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 5v14"/><path d="M5 12h14"/><circle cx="12" cy="12" r="9"/><path d="M3.5 9h17"/><path d="M3.5 15h17"/></svg></div>
                        <h3>VDL2</h3>
                        <p>VHF Data Link Mode 2 aircraft datalink decoding via dumpvdl2. Real-time ACARS-over-AVLC message capture with signal analysis.</p>
                    </div>
                    <div class="feature-card" data-category="tracking">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M2 20l4-4h3l4-7 2 4h2l5-9"/><path d="M22 20H2"/><path d="M6 16v4"/></svg></div>
                        <h3>Vessel Tracking</h3>
                        <p>Real-time AIS ship tracking via AIS-catcher. Monitor maritime traffic with vessel details, course, speed, and destination.</p>
                    </div>
                    <div class="feature-card" data-category="space">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M12 1v4"/><path d="M12 19v4"/><path d="M5 5l2 2"/><path d="M17 17l2 2"/><path d="M1 12h4"/><path d="M19 12h4"/><path d="M5 19l2-2"/><path d="M17 7l2-2"/><ellipse cx="12" cy="12" rx="10" ry="4" transform="rotate(45 12 12)"/></svg></div>
                        <h3>Satellite Tracking</h3>
                        <p>Track satellites with TLE data, sky plots, ground track visualization, and pass predictions for your location.</p>
                    </div>
                    <div class="feature-card" data-category="space">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v2"/><path d="M12 20v2"/><path d="m4.93 4.93 1.41 1.41"/><path d="m17.66 17.66 1.41 1.41"/><path d="M2 12h2"/><path d="M20 12h2"/><path d="m6.34 17.66-1.41 1.41"/><path d="m19.07 4.93-1.41 1.41"/><circle cx="12" cy="12" r="4"/><path d="M16 12a4 4 0 0 0-4-4"/></svg></div>
                        <h3>Weather Satellites</h3>
                        <p>NOAA APT and Meteor LRPT image decoding via SatDump with auto-scheduler, polar plot, and ground track map.</p>
                    </div>
                    <div class="feature-card" data-category="space">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><path d="M21 15l-5-5L5 21"/></svg></div>
                        <h3>ISS SSTV</h3>
                        <p>Receive Slow Scan Television from the ISS. Real-time tracking globe, pass predictions, and image decoding.</p>
                    </div>
                    <div class="feature-card" data-category="space">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18"/><path d="M9 3v18"/></svg></div>
                        <h3>HF SSTV</h3>
                        <p>Terrestrial SSTV on shortwave frequencies. Decode amateur radio image transmissions across HF, VHF, and UHF bands.</p>
                    </div>
                    <div class="feature-card" data-category="tracking">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/><path d="M12 8l4 4-4 4"/></svg></div>
                        <h3>GPS Tracking</h3>
                        <p>Real-time GPS position tracking with live map, speed, heading, altitude, satellite info, and track recording.</p>
                    </div>
                    <div class="feature-card" data-category="space">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/></svg></div>
                        <h3>Space Weather</h3>
                        <p>Real-time solar and geomagnetic monitoring. Kp index, HF band conditions, solar imagery, D-RAP maps, and aurora forecasts from NOAA SWPC.</p>
                    </div>
                    <div class="feature-card" data-category="wireless">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12.55a11 11 0 0 1 14.08 0"/><path d="M1.42 9a16 16 0 0 1 21.16 0"/><path d="M8.53 16.11a6 6 0 0 1 6.95 0"/><circle cx="12" cy="20" r="1"/></svg></div>
                        <h3>WiFi Scanning</h3>
                        <p>Monitor mode reconnaissance via aircrack-ng. Network discovery, client tracking, and handshake capture.</p>
                    </div>
                    <div class="feature-card" data-category="wireless">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="10" r="6"/><path d="M12 16v5"/><path d="M8 21h8"/><path d="M9.5 7.5L12 10l2.5-2.5"/></svg></div>
                        <h3>Bluetooth Scanning</h3>
                        <p>Device discovery with tracker detection for AirTags, Tile, Samsung SmartTag, and other Bluetooth devices.</p>
                    </div>
                    <div class="feature-card" data-category="wireless">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><circle cx="12" cy="12" r="7" stroke-dasharray="4 2"/><circle cx="12" cy="12" r="11" stroke-dasharray="2 3"/><line x1="12" y1="1" x2="12" y2="3"/></svg></div>
                        <h3>BT Locate</h3>
                        <p>SAR Bluetooth device location with GPS-tagged signal trail mapping, IRK-based RPA resolution, and proximity audio alerts.</p>
                    </div>
                    <div class="feature-card" data-category="intel">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 22s-8-4.5-8-11.8A8 8 0 0 1 12 2a8 8 0 0 1 8 8.2c0 7.3-8 11.8-8 11.8z"/><circle cx="12" cy="10" r="3"/><path d="M12 2v3"/><path d="M4.93 4.93l2.12 2.12"/><path d="M20 12h-3"/></svg></div>
                        <h3>TSCM</h3>
                        <p>Counter-surveillance with baseline recording, threat detection, device correlation, and risk scoring.</p>
                    </div>
                    <div class="feature-card" data-category="wireless">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg></div>
                        <h3>Meshtastic</h3>
                        <p>LoRa mesh network integration. Connect to Meshtastic devices for decentralized, long-range communication monitoring.</p>
                    </div>
                    <div class="feature-card" data-category="platform">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="3" width="20" height="14" rx="2"/><line x1="8" y1="21" x2="16" y2="21"/><line x1="12" y1="17" x2="12" y2="21"/><circle cx="9" cy="10" r="1.5"/><circle cx="15" cy="10" r="1.5"/><path d="M5 10h2"/><path d="M17 10h2"/></svg></div>
                        <h3>Remote Agents</h3>
                        <p>Distributed signal intelligence with remote sensor nodes. Deploy agents across multiple locations and aggregate data to a central controller.</p>
                    </div>
                    <div class="feature-card" data-category="platform">
                        <div class="feature-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M18.36 6.64A9 9 0 0 1 20.77 15"/><path d="M6.16 6.16a9 9 0 0 0-2.57 8.84"/><path d="M12 2v4"/><path d="M2 12h4"/><line x1="2" y1="2" x2="22" y2="22"/><circle cx="12" cy="12" r="3"/></svg></div>
                        <h3>Offline Mode</h3>
                        <p>Run without internet using bundled assets. Choose from multiple map tile providers or use your own local tile server.</p>
                    </div>
                </div>
                <button class="carousel-arrow carousel-arrow-right" aria-label="Scroll right">&#8250;</button>
            </div>
            <div class="carousel-indicators" id="carousel-indicators"></div>
        </div>
    </section>
@@ -194,6 +247,50 @@
                    <img src="images/ais.png" alt="AIS Vessel Tracking">
                    <span class="screenshot-label">AIS Vessel Tracking</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/bt-locate.png" alt="BT Locate SAR Tracker">
                    <span class="screenshot-label">BT Locate — SAR Tracker</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/spy-stations.png" alt="Spy Stations Database">
                    <span class="screenshot-label">Spy Stations</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/gps.png" alt="GPS Receiver">
                    <span class="screenshot-label">GPS Receiver</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/websdr.png" alt="WebSDR Remote Listening">
                    <span class="screenshot-label">WebSDR</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/aprs.png" alt="APRS Tracker">
                    <span class="screenshot-label">APRS Tracker</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/vdl2.png" alt="VDL2 Aircraft Datalink">
                    <span class="screenshot-label">VDL2 Aircraft Datalink</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/weather-satellite.png" alt="Weather Satellite Decoder">
                    <span class="screenshot-label">Weather Satellite</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/space-weather-1.png" alt="Space Weather Dashboard">
                    <span class="screenshot-label">Space Weather</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/space-weather-2.png" alt="Space Weather Solar Imagery">
                    <span class="screenshot-label">Space Weather — Solar &amp; Aurora</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/satellite-tracker.png" alt="Satellite Tracker">
                    <span class="screenshot-label">Satellite Tracker</span>
                </div>
                <div class="screenshot-item">
                    <img src="images/iss-sstv.png" alt="ISS SSTV Decoder">
                    <span class="screenshot-label">ISS SSTV</span>
                </div>
            </div>
        </div>
    </section>
@@ -224,7 +321,7 @@ sudo -E venv/bin/python intercept.py</code></pre>
                    <div class="code-block">
                        <pre><code>git clone https://github.com/smittix/intercept.git
 cd intercept
-docker compose up -d</code></pre>
+docker compose --profile basic up -d --build</code></pre>
                    </div>
                    <p class="install-note">Requires privileged mode for USB SDR access</p>
                </div>
@@ -278,6 +375,36 @@ docker compose up -d</code></pre>
        </div>
    </section>
    <section class="support">
        <div class="container">
            <h2>Support & Contact</h2>
            <p class="section-subtitle">Help keep iNTERCEPT alive or get in touch</p>
            <div class="support-grid">
                <a href="https://www.buymeacoffee.com/smittix" target="_blank" class="support-card support-coffee">
                    <div class="support-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M17 8h1a4 4 0 0 1 0 8h-1"/><path d="M3 8h14v9a4 4 0 0 1-4 4H7a4 4 0 0 1-4-4V8z"/><line x1="6" y1="2" x2="6" y2="4"/><line x1="10" y1="2" x2="10" y2="4"/><line x1="14" y1="2" x2="14" y2="4"/></svg></div>
                    <h3>Buy Me a Coffee</h3>
                    <p>Support development with a one-time donation</p>
                </a>
                <a href="#" id="email-card" class="support-card" onclick="return false;">
                    <div class="support-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="4" width="20" height="16" rx="2"/><path d="M22 4L12 13 2 4"/></svg></div>
                    <h3>Email</h3>
                    <p id="email-text">Click to reveal</p>
                </a>
                <a href="https://discord.gg/EyeksEJmWE" target="_blank" class="support-card">
                    <div class="support-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/><circle cx="12" cy="12" r="10"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg></div>
                    <h3>Discord</h3>
                    <p>Join the community for help and discussion</p>
                </a>
                <a href="https://github.com/smittix/intercept/issues" target="_blank" class="support-card">
                    <div class="support-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="12" y1="8" x2="12" y2="12"/><line x1="12" y1="16" x2="12.01" y2="16"/></svg></div>
                    <h3>Report an Issue</h3>
                    <p>Bug reports and feature requests on GitHub</p>
                </a>
            </div>
        </div>
    </section>
    <footer class="footer">
        <div class="container">
            <div class="footer-content">
@@ -288,12 +415,14 @@ docker compose up -d</code></pre>
                <div class="footer-links">
                    <a href="https://github.com/smittix/intercept" target="_blank">GitHub</a>
                    <a href="https://discord.gg/EyeksEJmWE" target="_blank">Discord</a>
                    <a href="#" id="footer-email">Email</a>
                    <a href="https://www.buymeacoffee.com/smittix" target="_blank">Donate</a>
                    <a href="https://github.com/smittix/intercept/blob/main/docs/USAGE.md">Documentation</a>
                    <a href="https://github.com/smittix/intercept/blob/main/docs/DISTRIBUTED_AGENTS.md">Remote Agents</a>
                </div>
            </div>
            <div class="footer-bottom">
-                <p>Created by <a href="https://github.com/smittix" target="_blank">smittix</a> · MIT License</p>
+                <p>Created by <a href="https://github.com/smittix" target="_blank">smittix</a> · Apache 2.0 License</p>
                <p class="disclaimer">For educational and authorized testing purposes only.</p>
            </div>
        </div>
@@ -336,6 +465,334 @@ docker compose up -d</code></pre>
        document.addEventListener('keydown', (e) => {
            if (e.key === 'Escape') closeLightbox();
        });
        // Carousel functionality
        (function() {
            const track = document.querySelector('.carousel-track');
            const cards = Array.from(track.querySelectorAll('.feature-card'));
            const leftArrow = document.querySelector('.carousel-arrow-left');
            const rightArrow = document.querySelector('.carousel-arrow-right');
            const filterBtns = document.querySelectorAll('.filter-btn');
            const indicatorContainer = document.getElementById('carousel-indicators');
            const SCROLL_AMOUNT = 300;
            function updateArrows() {
                leftArrow.disabled = track.scrollLeft <= 0;
                rightArrow.disabled = track.scrollLeft + track.clientWidth >= track.scrollWidth - 2;
            }
            function buildIndicators() {
                const visible = cards.filter(c => !c.classList.contains('hidden'));
                const totalWidth = visible.length * 300;
                const pages = Math.max(1, Math.ceil(totalWidth / track.clientWidth));
                indicatorContainer.innerHTML = '';
                for (let i = 0; i < pages; i++) {
                    const dot = document.createElement('button');
                    dot.className = 'carousel-dot' + (i === 0 ? ' active' : '');
                    dot.addEventListener('click', () => {
                        track.scrollTo({ left: (track.scrollWidth / pages) * i, behavior: 'smooth' });
                    });
                    indicatorContainer.appendChild(dot);
                }
            }
            function updateIndicators() {
                const dots = indicatorContainer.querySelectorAll('.carousel-dot');
                if (!dots.length) return;
                const ratio = track.scrollLeft / Math.max(1, track.scrollWidth - track.clientWidth);
                const idx = Math.round(ratio * (dots.length - 1));
                dots.forEach((d, i) => d.classList.toggle('active', i === idx));
            }
            leftArrow.addEventListener('click', () => {
                track.scrollBy({ left: -SCROLL_AMOUNT, behavior: 'smooth' });
            });
            rightArrow.addEventListener('click', () => {
                track.scrollBy({ left: SCROLL_AMOUNT, behavior: 'smooth' });
            });
            track.addEventListener('scroll', () => {
                updateArrows();
                updateIndicators();
            });
            filterBtns.forEach(btn => {
                btn.addEventListener('click', () => {
                    filterBtns.forEach(b => b.classList.remove('active'));
                    btn.classList.add('active');
                    const filter = btn.dataset.filter;
                    cards.forEach(card => {
                        if (filter === 'all' || card.dataset.category === filter) {
                            card.classList.remove('hidden');
                        } else {
                            card.classList.add('hidden');
                        }
                    });
                    track.scrollTo({ left: 0 });
                    buildIndicators();
                    updateArrows();
                });
            });
            buildIndicators();
            updateArrows();
            window.addEventListener('resize', () => { buildIndicators(); updateArrows(); });
        })();
        // Obfuscated email - assembled at runtime to defeat scrapers
        (function() {
            const p = ['smittix', 'outlook', 'com'];
            const addr = p[0] + '@' + p[1] + '.' + p[2];
            const card = document.getElementById('email-card');
            const text = document.getElementById('email-text');
            const footerLink = document.getElementById('footer-email');
            let revealed = false;
            card.addEventListener('click', function(e) {
                e.preventDefault();
                if (!revealed) {
                    text.textContent = addr;
                    revealed = true;
                } else {
                    window.location.href = 'mail' + 'to:' + addr;
                }
            });
            footerLink.addEventListener('click', function(e) {
                e.preventDefault();
                window.location.href = 'mail' + 'to:' + addr;
            });
        })();
    </script>
    <script>
    // Animated satellite & signal background
    (function() {
        const canvas = document.getElementById('bg-canvas');
        const ctx = canvas.getContext('2d');
        let w, h, dpr;
        let orbits = [];
        let pulses = [];
        let particles = [];
        let mouse = { x: -1000, y: -1000 };
        function resize() {
            dpr = Math.min(window.devicePixelRatio || 1, 2);
            w = window.innerWidth;
            h = document.documentElement.scrollHeight;
            canvas.width = w * dpr;
            canvas.height = h * dpr;
            canvas.style.width = w + 'px';
            canvas.style.height = h + 'px';
            ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
        }
        // Orbital paths with satellites
        function createOrbits() {
            orbits = [];
            const count = Math.max(4, Math.floor(w / 300));
            for (let i = 0; i < count; i++) {
                const cx = Math.random() * w;
                const cy = Math.random() * h;
                const rx = 120 + Math.random() * 280;
                const ry = 40 + Math.random() * 100;
                const tilt = (Math.random() - 0.5) * 1.2;
                const speed = (0.0002 + Math.random() * 0.0004) * (Math.random() > 0.5 ? 1 : -1);
                const sats = [];
                const satCount = 1 + Math.floor(Math.random() * 2);
                for (let j = 0; j < satCount; j++) {
                    sats.push({ angle: Math.random() * Math.PI * 2, pulseTimer: 0 });
                }
                orbits.push({ cx, cy, rx, ry, tilt, speed, sats });
            }
        }
        // Floating signal particles (tiny dots drifting upward)
        function createParticles() {
            particles = [];
            const count = Math.max(30, Math.floor((w * h) / 25000));
            for (let i = 0; i < count; i++) {
                particles.push({
                    x: Math.random() * w,
                    y: Math.random() * h,
                    vy: -(0.08 + Math.random() * 0.15),
                    vx: (Math.random() - 0.5) * 0.1,
                    size: 0.5 + Math.random() * 1.2,
                    alpha: 0.1 + Math.random() * 0.25,
                    flicker: Math.random() * Math.PI * 2,
                });
            }
        }
        function spawnPulse(x, y) {
            pulses.push({ x, y, r: 2, maxR: 50 + Math.random() * 40, alpha: 0.35 });
        }
        function drawOrbitPath(orbit) {
            ctx.save();
            ctx.translate(orbit.cx, orbit.cy);
            ctx.rotate(orbit.tilt);
            ctx.beginPath();
            ctx.ellipse(0, 0, orbit.rx, orbit.ry, 0, 0, Math.PI * 2);
            ctx.strokeStyle = 'rgba(0, 212, 170, 0.04)';
            ctx.lineWidth = 1;
            ctx.stroke();
            ctx.restore();
        }
        function drawSatellite(orbit, sat, dt) {
            sat.angle += orbit.speed * dt;
            const cos = Math.cos(orbit.tilt);
            const sin = Math.sin(orbit.tilt);
            const ex = orbit.rx * Math.cos(sat.angle);
            const ey = orbit.ry * Math.sin(sat.angle);
            const sx = orbit.cx + ex * cos - ey * sin;
            const sy = orbit.cy + ex * sin + ey * cos;
            // Satellite dot
            ctx.beginPath();
            ctx.arc(sx, sy, 2, 0, Math.PI * 2);
            ctx.fillStyle = 'rgba(0, 212, 170, 0.7)';
            ctx.fill();
            // Faint glow
            ctx.beginPath();
            ctx.arc(sx, sy, 6, 0, Math.PI * 2);
            const g = ctx.createRadialGradient(sx, sy, 0, sx, sy, 6);
            g.addColorStop(0, 'rgba(0, 212, 170, 0.15)');
            g.addColorStop(1, 'rgba(0, 212, 170, 0)');
            ctx.fillStyle = g;
            ctx.fill();
            // Periodic signal pulse
            sat.pulseTimer += dt;
            if (sat.pulseTimer > 3000 + Math.random() * 500) {
                sat.pulseTimer = 0;
                spawnPulse(sx, sy);
            }
        }
        function drawPulses(dt) {
            for (let i = pulses.length - 1; i >= 0; i--) {
                const p = pulses[i];
                p.r += dt * 0.025;
                p.alpha = 0.35 * (1 - p.r / p.maxR);
                if (p.r >= p.maxR) { pulses.splice(i, 1); continue; }
                ctx.beginPath();
                ctx.arc(p.x, p.y, p.r, 0, Math.PI * 2);
                ctx.strokeStyle = `rgba(0, 212, 170, ${p.alpha})`;
                ctx.lineWidth = 1;
                ctx.stroke();
                // Second ring
                if (p.r > 12) {
                    ctx.beginPath();
                    ctx.arc(p.x, p.y, p.r * 0.6, 0, Math.PI * 2);
                    ctx.strokeStyle = `rgba(0, 136, 255, ${p.alpha * 0.5})`;
                    ctx.stroke();
                }
            }
        }
        function drawParticles(dt, time) {
            for (const p of particles) {
                p.y += p.vy * dt * 0.06;
                p.x += p.vx * dt * 0.06;
                p.flicker += dt * 0.002;
                if (p.y < -10) { p.y = h + 10; p.x = Math.random() * w; }
                if (p.x < -10) p.x = w + 10;
                if (p.x > w + 10) p.x = -10;
                const flick = p.alpha * (0.6 + 0.4 * Math.sin(p.flicker));
                // Mouse interaction - subtle brighten
                const dx = p.x - mouse.x;
                const dy = p.y - mouse.y;
                const dist = Math.sqrt(dx * dx + dy * dy);
                const boost = dist < 150 ? 0.3 * (1 - dist / 150) : 0;
                ctx.beginPath();
                ctx.arc(p.x, p.y, p.size, 0, Math.PI * 2);
                ctx.fillStyle = `rgba(0, 212, 170, ${Math.min(flick + boost, 0.6)})`;
                ctx.fill();
            }
        }
        // Faint grid lines (signal grid)
        function drawGrid(time) {
            ctx.strokeStyle = 'rgba(0, 212, 170, 0.015)';
            ctx.lineWidth = 1;
            const spacing = 120;
            const offset = (time * 0.005) % spacing;
            for (let x = -spacing + offset; x < w + spacing; x += spacing) {
                ctx.beginPath();
                ctx.moveTo(x, 0);
                ctx.lineTo(x, h);
                ctx.stroke();
            }
            for (let y = -spacing + offset * 0.7; y < h + spacing; y += spacing) {
                ctx.beginPath();
                ctx.moveTo(0, y);
                ctx.lineTo(w, y);
                ctx.stroke();
            }
        }
        let last = 0;
        function animate(now) {
            const dt = last ? Math.min(now - last, 50) : 16;
            last = now;
            ctx.clearRect(0, 0, w, h);
            drawGrid(now);
            for (const orbit of orbits) {
                drawOrbitPath(orbit);
                for (const sat of orbit.sats) {
                    drawSatellite(orbit, sat, dt);
                }
            }
            drawPulses(dt);
            drawParticles(dt, now);
            requestAnimationFrame(animate);
        }
        // Track mouse for particle interaction
        document.addEventListener('mousemove', (e) => {
            mouse.x = e.clientX;
            mouse.y = e.clientY + window.scrollY;
        });
        // Resize handling
        let resizeTimer;
        function handleResize() {
            clearTimeout(resizeTimer);
            resizeTimer = setTimeout(() => {
                resize();
                createOrbits();
                createParticles();
            }, 200);
        }
        // Keep canvas height synced with document
        const ro = new ResizeObserver(() => { handleResize(); });
        ro.observe(document.documentElement);
        window.addEventListener('resize', handleResize);
        resize();
        createOrbits();
        createParticles();
        requestAnimationFrame(animate);
    })();
    </script>
 </body>
 </html>
@@ -17,6 +17,22 @@
    --gradient-end: #0088ff;
 }
 /* Animated background canvas */
 #bg-canvas {
    position: fixed;
    top: 0;
    left: 0;
    width: 100%;
    height: 100%;
    z-index: 0;
    pointer-events: none;
 }
 body > *:not(#bg-canvas) {
    position: relative;
    z-index: 1;
 }
 * {
    margin: 0;
    padding: 0;
@@ -245,18 +261,74 @@ section h2 {
    background: var(--bg-secondary);
 }
-.features-grid {
+/* Category filter tabs */
-    display: grid;
+.carousel-filters {
-    grid-template-columns: repeat(4, 1fr);
+    display: flex;
-    gap: 24px;
+    justify-content: center;
    gap: 8px;
    margin-bottom: 40px;
    flex-wrap: wrap;
 }
 .filter-btn {
    font-family: 'JetBrains Mono', monospace;
    font-size: 0.8rem;
    font-weight: 500;
    padding: 8px 20px;
    border-radius: 20px;
    border: 1px solid var(--border);
    background: transparent;
    color: var(--text-secondary);
    cursor: pointer;
    transition: all 0.25s;
    letter-spacing: 0.5px;
 }
 .filter-btn:hover {
    border-color: var(--accent);
    color: var(--text-primary);
 }
 .filter-btn.active {
    background: var(--accent);
    color: var(--bg-primary);
    border-color: var(--accent);
 }
 /* Carousel */
 .carousel-wrapper {
    position: relative;
    padding: 0 56px;
 }
 .carousel-track {
    display: flex;
    gap: 20px;
    overflow-x: auto;
    scroll-behavior: smooth;
    scroll-snap-type: x mandatory;
    -webkit-overflow-scrolling: touch;
    scrollbar-width: none;
    padding: 8px 0 16px;
 }
 .carousel-track::-webkit-scrollbar {
    display: none;
 }
 .feature-card {
    flex: 0 0 280px;
    scroll-snap-align: start;
    background: var(--bg-card);
    border: 1px solid var(--border);
    border-radius: 12px;
    padding: 32px 24px;
    transition: all 0.3s;
    min-height: 200px;
 }
 .feature-card.hidden {
    display: none;
 }
 .feature-card:hover {
@@ -266,8 +338,15 @@ section h2 {
 }
 .feature-icon {
-    font-size: 2rem;
+    width: 36px;
    height: 36px;
    margin-bottom: 16px;
    color: var(--accent);
 }
 .feature-icon svg {
    width: 100%;
    height: 100%;
 }
 .feature-card h3 {
@@ -283,6 +362,81 @@ section h2 {
    line-height: 1.7;
 }
 /* Carousel arrows */
 .carousel-arrow {
    position: absolute;
    top: 50%;
    transform: translateY(-50%);
    width: 44px;
    height: 44px;
    border-radius: 50%;
    border: 1px solid var(--border);
    background: var(--bg-card);
    color: var(--text-primary);
    font-size: 1.5rem;
    cursor: pointer;
    transition: all 0.25s;
    display: flex;
    align-items: center;
    justify-content: center;
    z-index: 10;
    line-height: 1;
 }
 .carousel-arrow:hover {
    background: var(--bg-card-hover);
    border-color: var(--accent);
    color: var(--accent);
 }
 .carousel-arrow:disabled {
    opacity: 0.3;
    cursor: default;
 }
 .carousel-arrow:disabled:hover {
    background: var(--bg-card);
    border-color: var(--border);
    color: var(--text-primary);
 }
 .carousel-arrow-left {
    left: 0;
 }
 .carousel-arrow-right {
    right: 0;
 }
 /* Carousel indicators */
 .carousel-indicators {
    display: flex;
    justify-content: center;
    gap: 8px;
    margin-top: 28px;
 }
 .carousel-dot {
    width: 8px;
    height: 8px;
    border-radius: 50%;
    background: var(--border);
    border: none;
    cursor: pointer;
    transition: all 0.25s;
    padding: 0;
 }
 .carousel-dot.active {
    background: var(--accent);
    width: 24px;
    border-radius: 4px;
 }
 .carousel-dot:hover {
    background: var(--text-muted);
 }
 /* Screenshots */
 .screenshot-gallery {
    display: grid;
@@ -550,6 +704,72 @@ section h2 {
    gap: 16px;
 }
 /* Support & Contact */
 .support {
    background: var(--bg-secondary);
 }
 .support-grid {
    display: grid;
    grid-template-columns: repeat(4, 1fr);
    gap: 24px;
 }
 .support-card {
    background: var(--bg-card);
    border: 1px solid var(--border);
    border-radius: 12px;
    padding: 32px 24px;
    text-align: center;
    text-decoration: none;
    transition: all 0.3s;
    display: block;
 }
 .support-card:hover {
    background: var(--bg-card-hover);
    border-color: var(--accent);
    transform: translateY(-4px);
 }
 .support-card.support-coffee {
    border-color: rgba(255, 193, 59, 0.3);
 }
 .support-card.support-coffee:hover {
    border-color: #ffc13b;
    box-shadow: 0 8px 30px rgba(255, 193, 59, 0.1);
 }
 .support-card.support-coffee .support-icon {
    color: #ffc13b;
 }
 .support-icon {
    width: 36px;
    height: 36px;
    margin: 0 auto 16px;
    color: var(--accent);
 }
 .support-icon svg {
    width: 100%;
    height: 100%;
 }
 .support-card h3 {
    font-size: 1.1rem;
    font-weight: 600;
    margin-bottom: 8px;
    color: var(--text-primary);
 }
 .support-card p {
    font-size: 0.85rem;
    color: var(--text-secondary);
    line-height: 1.6;
 }
 /* Footer */
 .footer {
    background: var(--bg-secondary);
@@ -641,14 +861,22 @@ section h2 {
        margin: 0 auto;
    }
-    .features-grid {
+    .carousel-wrapper {
-        grid-template-columns: repeat(2, 1fr);
+        padding: 0 48px;
    }
    .feature-card {
        flex: 0 0 260px;
    }
    .screenshot-gallery {
        grid-template-columns: repeat(2, 1fr);
    }
    .support-grid {
        grid-template-columns: repeat(2, 1fr);
    }
    .install-options {
        grid-template-columns: 1fr;
    }
@@ -669,14 +897,35 @@ section h2 {
        gap: 24px;
    }
-    .features-grid {
+    .carousel-wrapper {
-        grid-template-columns: 1fr;
+        padding: 0 4px;
    }
    .carousel-arrow {
        display: none;
    }
    .feature-card {
        flex: 0 0 260px;
    }
    .carousel-filters {
        gap: 6px;
    }
    .filter-btn {
        font-size: 0.7rem;
        padding: 6px 14px;
    }
    .screenshot-gallery {
        grid-template-columns: 1fr;
    }
    .support-grid {
        grid-template-columns: 1fr;
    }
    .nav-links {
        display: none;
    }
@@ -838,15 +838,15 @@ class ModeManager:
            data['data'] = list(getattr(self, 'ais_vessels', {}).values())
        elif mode == 'aprs':
            data['data'] = list(getattr(self, 'aprs_stations', {}).values())
-        elif mode == 'tscm':
+        elif mode == 'tscm':
-            data['data'] = {
+            data['data'] = {
-                'anomalies': getattr(self, 'tscm_anomalies', []),
+                'anomalies': getattr(self, 'tscm_anomalies', []),
-                'baseline': getattr(self, 'tscm_baseline', {}),
+                'baseline': getattr(self, 'tscm_baseline', {}),
-                'wifi_devices': list(self.wifi_networks.values()),
+                'wifi_devices': list(self.wifi_networks.values()),
-                'wifi_clients': list(getattr(self, 'tscm_wifi_clients', {}).values()),
+                'wifi_clients': list(getattr(self, 'tscm_wifi_clients', {}).values()),
-                'bt_devices': list(self.bluetooth_devices.values()),
+                'bt_devices': list(self.bluetooth_devices.values()),
-                'rf_signals': getattr(self, 'tscm_rf_signals', []),
+                'rf_signals': getattr(self, 'tscm_rf_signals', []),
-            }
+            }
        elif mode == 'listening_post':
            data['data'] = {
                'activity': getattr(self, 'listening_post_activity', []),
@@ -1105,24 +1105,24 @@ class ModeManager:
            self.wifi_clients.clear()
        elif mode == 'bluetooth':
            self.bluetooth_devices.clear()
-        elif mode == 'tscm':
+        elif mode == 'tscm':
-            # Clean up TSCM sub-threads
+            # Clean up TSCM sub-threads
-            for sub_thread_name in ['tscm_wifi', 'tscm_bt', 'tscm_rf']:
+            for sub_thread_name in ['tscm_wifi', 'tscm_bt', 'tscm_rf']:
-                if sub_thread_name in self.output_threads:
+                if sub_thread_name in self.output_threads:
-                    thread = self.output_threads[sub_thread_name]
+                    thread = self.output_threads[sub_thread_name]
-                    if thread and thread.is_alive():
+                    if thread and thread.is_alive():
-                        thread.join(timeout=2)
+                        thread.join(timeout=2)
-                    del self.output_threads[sub_thread_name]
+                    del self.output_threads[sub_thread_name]
-            # Clear TSCM data
+            # Clear TSCM data
-            self.tscm_anomalies = []
+            self.tscm_anomalies = []
-            self.tscm_baseline = {}
+            self.tscm_baseline = {}
-            self.tscm_rf_signals = []
+            self.tscm_rf_signals = []
-            self.tscm_wifi_clients = {}
+            self.tscm_wifi_clients = {}
-            # Clear reported threat tracking sets
+            # Clear reported threat tracking sets
-            if hasattr(self, '_tscm_reported_wifi'):
+            if hasattr(self, '_tscm_reported_wifi'):
-                self._tscm_reported_wifi.clear()
+                self._tscm_reported_wifi.clear()
-            if hasattr(self, '_tscm_reported_bt'):
+            if hasattr(self, '_tscm_reported_bt'):
-                self._tscm_reported_bt.clear()
+                self._tscm_reported_bt.clear()
        elif mode == 'dsc':
            # Clear DSC data
            if hasattr(self, 'dsc_messages'):
@@ -1542,10 +1542,10 @@ class ModeManager:
    def _start_wifi(self, params: dict) -> dict:
        """Start WiFi scanning using Intercept's UnifiedWiFiScanner."""
        interface = params.get('interface')
-        channel = params.get('channel')
+        channel = params.get('channel')
-        channels = params.get('channels')
+        channels = params.get('channels')
-        band = params.get('band', 'abg')
+        band = params.get('band', 'abg')
-        scan_type = params.get('scan_type', 'deep')
+        scan_type = params.get('scan_type', 'deep')
        # Handle quick scan - returns results synchronously
        if scan_type == 'quick':
@@ -1574,21 +1574,21 @@ class ModeManager:
            else:
                scan_band = 'all'
-            channel_list = None
+            channel_list = None
-            if channels:
+            if channels:
-                if isinstance(channels, str):
+                if isinstance(channels, str):
-                    channel_list = [c.strip() for c in channels.split(',') if c.strip()]
+                    channel_list = [c.strip() for c in channels.split(',') if c.strip()]
-                elif isinstance(channels, (list, tuple, set)):
+                elif isinstance(channels, (list, tuple, set)):
-                    channel_list = list(channels)
+                    channel_list = list(channels)
-                else:
+                else:
-                    channel_list = [channels]
+                    channel_list = [channels]
-                try:
+                try:
-                    channel_list = [int(c) for c in channel_list]
+                    channel_list = [int(c) for c in channel_list]
-                except (TypeError, ValueError):
+                except (TypeError, ValueError):
-                    return {'status': 'error', 'message': 'Invalid channels'}
+                    return {'status': 'error', 'message': 'Invalid channels'}
-
+
-            # Start deep scan
+            # Start deep scan
-            if scanner.start_deep_scan(interface=interface, band=scan_band, channel=channel, channels=channel_list):
+            if scanner.start_deep_scan(interface=interface, band=scan_band, channel=channel, channels=channel_list):
                # Start thread to sync data to agent's dictionaries
                thread = threading.Thread(
                    target=self._wifi_data_sync,
@@ -1607,12 +1607,12 @@ class ModeManager:
            else:
                return {'status': 'error', 'message': scanner.get_status().error or 'Failed to start deep scan'}
-        except ImportError:
+        except ImportError:
-            # Fallback to direct airodump-ng
+            # Fallback to direct airodump-ng
-            return self._start_wifi_fallback(interface, channel, band, channels)
+            return self._start_wifi_fallback(interface, channel, band, channels)
-        except Exception as e:
+        except Exception as e:
-            logger.error(f"WiFi scanner error: {e}")
+            logger.error(f"WiFi scanner error: {e}")
-            return {'status': 'error', 'message': str(e)}
+            return {'status': 'error', 'message': str(e)}
    def _wifi_data_sync(self, scanner):
        """Sync WiFi scanner data to agent's data structures."""
@@ -1646,14 +1646,14 @@ class ModeManager:
        if hasattr(self, '_wifi_scanner_instance') and self._wifi_scanner_instance:
            self._wifi_scanner_instance.stop_deep_scan()
-    def _start_wifi_fallback(
+    def _start_wifi_fallback(
-        self,
+        self,
-        interface: str | None,
+        interface: str | None,
-        channel: int | None,
+        channel: int | None,
-        band: str,
+        band: str,
-        channels: list[int] | str | None = None,
+        channels: list[int] | str | None = None,
-    ) -> dict:
+    ) -> dict:
-        """Fallback WiFi deep scan using airodump-ng directly."""
+        """Fallback WiFi deep scan using airodump-ng directly."""
        if not interface:
            return {'status': 'error', 'message': 'WiFi interface required'}
@@ -1680,23 +1680,23 @@ class ModeManager:
        cmd = [airodump_path, '-w', csv_path, '--output-format', output_formats, '--band', band]
        if gps_manager.is_running:
            cmd.append('--gpsd')
-        channel_list = None
+        channel_list = None
-        if channels:
+        if channels:
-            if isinstance(channels, str):
+            if isinstance(channels, str):
-                channel_list = [c.strip() for c in channels.split(',') if c.strip()]
+                channel_list = [c.strip() for c in channels.split(',') if c.strip()]
-            elif isinstance(channels, (list, tuple, set)):
+            elif isinstance(channels, (list, tuple, set)):
-                channel_list = list(channels)
+                channel_list = list(channels)
-            else:
+            else:
-                channel_list = [channels]
+                channel_list = [channels]
-            try:
+            try:
-                channel_list = [int(c) for c in channel_list]
+                channel_list = [int(c) for c in channel_list]
-            except (TypeError, ValueError):
+            except (TypeError, ValueError):
-                return {'status': 'error', 'message': 'Invalid channels'}
+                return {'status': 'error', 'message': 'Invalid channels'}
-
+
-        if channel_list:
+        if channel_list:
-            cmd.extend(['-c', ','.join(str(c) for c in channel_list)])
+            cmd.extend(['-c', ','.join(str(c) for c in channel_list)])
-        elif channel:
+        elif channel:
-            cmd.extend(['-c', str(channel)])
+            cmd.extend(['-c', str(channel)])
        cmd.append(interface)
        try:
@@ -2022,7 +2022,7 @@ class ModeManager:
                    'agent_gps': gps_manager.position
                }
-            scanner.set_on_device_updated(on_device_updated)
+            scanner.add_device_callback(on_device_updated)
            # Start scanning
            if scanner.start_scan(mode=mode_param, duration_s=duration):
@@ -3148,21 +3148,21 @@ class ModeManager:
            self.tscm_baseline = {}
        if not hasattr(self, 'tscm_anomalies'):
            self.tscm_anomalies = []
-        if not hasattr(self, 'tscm_rf_signals'):
+        if not hasattr(self, 'tscm_rf_signals'):
-            self.tscm_rf_signals = []
+            self.tscm_rf_signals = []
-        if not hasattr(self, 'tscm_wifi_clients'):
+        if not hasattr(self, 'tscm_wifi_clients'):
-            self.tscm_wifi_clients = {}
+            self.tscm_wifi_clients = {}
-        self.tscm_anomalies.clear()
+        self.tscm_anomalies.clear()
-        self.tscm_wifi_clients.clear()
+        self.tscm_wifi_clients.clear()
        # Get params for what to scan
        scan_wifi = params.get('wifi', True)
        scan_bt = params.get('bluetooth', True)
-        scan_rf = params.get('rf', True)
+        scan_rf = params.get('rf', True)
-        wifi_interface = params.get('wifi_interface') or params.get('interface')
+        wifi_interface = params.get('wifi_interface') or params.get('interface')
-        bt_adapter = params.get('bt_interface') or params.get('adapter', 'hci0')
+        bt_adapter = params.get('bt_interface') or params.get('adapter', 'hci0')
-        sdr_device = params.get('sdr_device', params.get('device', 0))
+        sdr_device = params.get('sdr_device', params.get('device', 0))
-        sweep_type = params.get('sweep_type')
+        sweep_type = params.get('sweep_type')
        # Get baseline_id for comparison (same as local mode)
        baseline_id = params.get('baseline_id')
@@ -3170,11 +3170,11 @@ class ModeManager:
        started_scans = []
        # Start the combined TSCM scanner thread using existing Intercept functions
-        thread = threading.Thread(
+        thread = threading.Thread(
-            target=self._tscm_scanner_thread,
+            target=self._tscm_scanner_thread,
-            args=(scan_wifi, scan_bt, scan_rf, wifi_interface, bt_adapter, sdr_device, baseline_id, sweep_type),
+            args=(scan_wifi, scan_bt, scan_rf, wifi_interface, bt_adapter, sdr_device, baseline_id, sweep_type),
-            daemon=True
+            daemon=True
-        )
+        )
        thread.start()
        self.output_threads['tscm'] = thread
@@ -3193,9 +3193,9 @@ class ModeManager:
            'scanning': started_scans
        }
-    def _tscm_scanner_thread(self, scan_wifi: bool, scan_bt: bool, scan_rf: bool,
+    def _tscm_scanner_thread(self, scan_wifi: bool, scan_bt: bool, scan_rf: bool,
-                              wifi_interface: str | None, bt_adapter: str, sdr_device: int,
+                              wifi_interface: str | None, bt_adapter: str, sdr_device: int,
-                              baseline_id: int | None = None, sweep_type: str | None = None):
+                              baseline_id: int | None = None, sweep_type: str | None = None):
        """Combined TSCM scanner using existing Intercept functions.
        NOTE: This matches local mode behavior exactly:
@@ -3208,20 +3208,20 @@ class ModeManager:
        stop_event = self.stop_events.get(mode)
        # Import existing Intercept TSCM functions
-        from routes.tscm import _scan_wifi_networks, _scan_wifi_clients, _scan_bluetooth_devices, _scan_rf_signals
+        from routes.tscm import _scan_wifi_networks, _scan_wifi_clients, _scan_bluetooth_devices, _scan_rf_signals
-        logger.info("TSCM imports successful")
+        logger.info("TSCM imports successful")
-
+
-        sweep_ranges = None
+        sweep_ranges = None
-        if sweep_type:
+        if sweep_type:
-            try:
+            try:
-                from data.tscm_frequencies import get_sweep_preset, SWEEP_PRESETS
+                from data.tscm_frequencies import get_sweep_preset, SWEEP_PRESETS
-                preset = get_sweep_preset(sweep_type) or SWEEP_PRESETS.get('standard')
+                preset = get_sweep_preset(sweep_type) or SWEEP_PRESETS.get('standard')
-                sweep_ranges = preset.get('ranges') if preset else None
+                sweep_ranges = preset.get('ranges') if preset else None
-            except Exception:
+            except Exception:
-                sweep_ranges = None
+                sweep_ranges = None
-
+
-        # Load baseline if specified (same as local mode)
+        # Load baseline if specified (same as local mode)
-        baseline = None
+        baseline = None
        if baseline_id and HAS_BASELINE_DB and get_tscm_baseline:
            baseline = get_tscm_baseline(baseline_id)
            if baseline:
@@ -3242,9 +3242,9 @@ class ModeManager:
            self._tscm_correlation = None
        # Track devices seen during this sweep (like local mode's all_wifi/all_bt dicts)
-        seen_wifi = {}
+        seen_wifi = {}
-        seen_wifi_clients = {}
+        seen_wifi_clients = {}
-        seen_bt = {}
+        seen_bt = {}
        last_rf_scan = 0
        rf_scan_interval = 30
@@ -3290,63 +3290,63 @@ class ModeManager:
                                    enriched['is_new'] = not classification.get('in_baseline', False)
                                    enriched['reasons'] = classification.get('reasons', [])
-                                if self._tscm_correlation:
+                                if self._tscm_correlation:
-                                    profile = self._tscm_correlation.analyze_wifi_device(enriched)
+                                    profile = self._tscm_correlation.analyze_wifi_device(enriched)
-                                    enriched['classification'] = profile.risk_level.value
+                                    enriched['classification'] = profile.risk_level.value
-                                    enriched['score'] = profile.total_score
+                                    enriched['score'] = profile.total_score
-                                    enriched['score_modifier'] = profile.score_modifier
+                                    enriched['score_modifier'] = profile.score_modifier
-                                    enriched['known_device'] = profile.known_device
+                                    enriched['known_device'] = profile.known_device
-                                    enriched['known_device_name'] = profile.known_device_name
+                                    enriched['known_device_name'] = profile.known_device_name
-                                    enriched['indicators'] = [
+                                    enriched['indicators'] = [
-                                        {'type': i.type.value, 'desc': i.description}
+                                        {'type': i.type.value, 'desc': i.description}
-                                        for i in profile.indicators
+                                        for i in profile.indicators
-                                    ]
+                                    ]
-                                    enriched['recommended_action'] = profile.recommended_action
+                                    enriched['recommended_action'] = profile.recommended_action
-
+
-                                self.wifi_networks[bssid] = enriched
+                                self.wifi_networks[bssid] = enriched
-
+
-                        # WiFi clients (monitor mode only)
+                        # WiFi clients (monitor mode only)
-                        try:
+                        try:
-                            wifi_clients = _scan_wifi_clients(wifi_interface or '')
+                            wifi_clients = _scan_wifi_clients(wifi_interface or '')
-                            for client in wifi_clients:
+                            for client in wifi_clients:
-                                mac = (client.get('mac') or '').upper()
+                                mac = (client.get('mac') or '').upper()
-                                if not mac or mac in seen_wifi_clients:
+                                if not mac or mac in seen_wifi_clients:
-                                    continue
+                                    continue
-                                seen_wifi_clients[mac] = client
+                                seen_wifi_clients[mac] = client
-
+
-                                rssi_val = client.get('rssi_current')
+                                rssi_val = client.get('rssi_current')
-                                if rssi_val is None:
+                                if rssi_val is None:
-                                    rssi_val = client.get('rssi_median') or client.get('rssi_ema')
+                                    rssi_val = client.get('rssi_median') or client.get('rssi_ema')
-
+
-                                client_device = {
+                                client_device = {
-                                    'mac': mac,
+                                    'mac': mac,
-                                    'vendor': client.get('vendor'),
+                                    'vendor': client.get('vendor'),
-                                    'name': client.get('vendor') or 'WiFi Client',
+                                    'name': client.get('vendor') or 'WiFi Client',
-                                    'rssi': rssi_val,
+                                    'rssi': rssi_val,
-                                    'associated_bssid': client.get('associated_bssid'),
+                                    'associated_bssid': client.get('associated_bssid'),
-                                    'probed_ssids': client.get('probed_ssids', []),
+                                    'probed_ssids': client.get('probed_ssids', []),
-                                    'probe_count': client.get('probe_count', len(client.get('probed_ssids', []))),
+                                    'probe_count': client.get('probe_count', len(client.get('probed_ssids', []))),
-                                    'is_client': True,
+                                    'is_client': True,
-                                }
+                                }
-
+
-                                if self._tscm_correlation:
+                                if self._tscm_correlation:
-                                    profile = self._tscm_correlation.analyze_wifi_device(client_device)
+                                    profile = self._tscm_correlation.analyze_wifi_device(client_device)
-                                    client_device['classification'] = profile.risk_level.value
+                                    client_device['classification'] = profile.risk_level.value
-                                    client_device['score'] = profile.total_score
+                                    client_device['score'] = profile.total_score
-                                    client_device['score_modifier'] = profile.score_modifier
+                                    client_device['score_modifier'] = profile.score_modifier
-                                    client_device['known_device'] = profile.known_device
+                                    client_device['known_device'] = profile.known_device
-                                    client_device['known_device_name'] = profile.known_device_name
+                                    client_device['known_device_name'] = profile.known_device_name
-                                    client_device['indicators'] = [
+                                    client_device['indicators'] = [
-                                        {'type': i.type.value, 'desc': i.description}
+                                        {'type': i.type.value, 'desc': i.description}
-                                        for i in profile.indicators
+                                        for i in profile.indicators
-                                    ]
+                                    ]
-                                    client_device['recommended_action'] = profile.recommended_action
+                                    client_device['recommended_action'] = profile.recommended_action
-
+
-                                self.tscm_wifi_clients[mac] = client_device
+                                self.tscm_wifi_clients[mac] = client_device
-                        except Exception as e:
+                        except Exception as e:
-                            logger.debug(f"WiFi client scan error: {e}")
+                            logger.debug(f"WiFi client scan error: {e}")
-                    except Exception as e:
+                    except Exception as e:
-                        logger.debug(f"WiFi scan error: {e}")
+                        logger.debug(f"WiFi scan error: {e}")
                # Bluetooth scan using Intercept's function (same as local mode)
                if scan_bt:
@@ -3380,18 +3380,18 @@ class ModeManager:
                                    enriched['is_new'] = not classification.get('in_baseline', False)
                                    enriched['reasons'] = classification.get('reasons', [])
-                                if self._tscm_correlation:
+                                if self._tscm_correlation:
-                                    profile = self._tscm_correlation.analyze_bluetooth_device(enriched)
+                                    profile = self._tscm_correlation.analyze_bluetooth_device(enriched)
-                                    enriched['classification'] = profile.risk_level.value
+                                    enriched['classification'] = profile.risk_level.value
-                                    enriched['score'] = profile.total_score
+                                    enriched['score'] = profile.total_score
-                                    enriched['score_modifier'] = profile.score_modifier
+                                    enriched['score_modifier'] = profile.score_modifier
-                                    enriched['known_device'] = profile.known_device
+                                    enriched['known_device'] = profile.known_device
-                                    enriched['known_device_name'] = profile.known_device_name
+                                    enriched['known_device_name'] = profile.known_device_name
-                                    enriched['indicators'] = [
+                                    enriched['indicators'] = [
-                                        {'type': i.type.value, 'desc': i.description}
+                                        {'type': i.type.value, 'desc': i.description}
-                                        for i in profile.indicators
+                                        for i in profile.indicators
-                                    ]
+                                    ]
-                                    enriched['recommended_action'] = profile.recommended_action
+                                    enriched['recommended_action'] = profile.recommended_action
                                self.bluetooth_devices[mac] = enriched
                    except Exception as e:
@@ -3402,11 +3402,11 @@ class ModeManager:
                    try:
                        # Pass a stop check that uses our stop_event (not the module's _sweep_running)
                        agent_stop_check = lambda: stop_event and stop_event.is_set()
-                        rf_signals = _scan_rf_signals(
+                        rf_signals = _scan_rf_signals(
-                            sdr_device,
+                            sdr_device,
-                            stop_check=agent_stop_check,
+                            stop_check=agent_stop_check,
-                            sweep_ranges=sweep_ranges
+                            sweep_ranges=sweep_ranges
-                        )
+                        )
                        # Analyze each RF signal like local mode does
                        analyzed_signals = []
@@ -3426,17 +3426,17 @@ class ModeManager:
                                analyzed['reasons'] = classification.get('reasons', [])
                            # Use correlation engine for scoring (same as local mode)
-                            if hasattr(self, '_tscm_correlation') and self._tscm_correlation:
+                            if hasattr(self, '_tscm_correlation') and self._tscm_correlation:
-                                profile = self._tscm_correlation.analyze_rf_signal(signal)
+                                profile = self._tscm_correlation.analyze_rf_signal(signal)
-                                analyzed['classification'] = profile.risk_level.value
+                                analyzed['classification'] = profile.risk_level.value
-                                analyzed['score'] = profile.total_score
+                                analyzed['score'] = profile.total_score
-                                analyzed['score_modifier'] = profile.score_modifier
+                                analyzed['score_modifier'] = profile.score_modifier
-                                analyzed['known_device'] = profile.known_device
+                                analyzed['known_device'] = profile.known_device
-                                analyzed['known_device_name'] = profile.known_device_name
+                                analyzed['known_device_name'] = profile.known_device_name
-                                analyzed['indicators'] = [
+                                analyzed['indicators'] = [
-                                    {'type': i.type.value, 'desc': i.description}
+                                    {'type': i.type.value, 'desc': i.description}
-                                    for i in profile.indicators
+                                    for i in profile.indicators
-                                ]
+                                ]
                            analyzed['is_threat'] = is_threat
                            analyzed_signals.append(analyzed)
@@ -1,10 +1,10 @@
 [project]
 name = "intercept"
-version = "2.16.0"
+version = "2.21.1"
 description = "Signal Intelligence Platform - Pager/433MHz/ADS-B/Satellite/WiFi/Bluetooth"
 readme = "README.md"
 requires-python = ">=3.9"
-license = {text = "MIT"}
+license = {text = "Apache-2.0"}
 authors = [
    {name = "Intercept Contributors"}
 ]
@@ -14,7 +14,7 @@ classifiers = [
    "Environment :: Web Environment",
    "Framework :: Flask",
    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
+    "License :: OSI Approved :: Apache Software License",
    "Operating System :: POSIX :: Linux",
    "Operating System :: MacOS",
    "Programming Language :: Python :: 3",
@@ -32,6 +32,9 @@ scapy>=2.4.5
 # QR code generation for Meshtastic channels (optional)
 qrcode[pil]>=7.4
 # BLE RPA resolution for BT Locate (optional - for SAR device tracking)
 cryptography>=41.0.0
 # Development dependencies (install with: pip install -r requirements-dev.txt)
 # pytest>=7.0.0
 # pytest-cov>=4.0.0
@@ -2,37 +2,40 @@
 def register_blueprints(app):
    """Register all route blueprints with the Flask app."""
-    from .pager import pager_bp
+    from .acars import acars_bp
    from .sensor import sensor_bp
    from .rtlamr import rtlamr_bp
    from .wifi import wifi_bp
    from .wifi_v2 import wifi_v2_bp
    from .bluetooth import bluetooth_bp
    from .bluetooth_v2 import bluetooth_v2_bp
    from .adsb import adsb_bp
    from .ais import ais_bp
    from .dsc import dsc_bp
    from .acars import acars_bp
    from .aprs import aprs_bp
    from .satellite import satellite_bp
    from .gps import gps_bp
    from .settings import settings_bp
    from .correlation import correlation_bp
    from .listening_post import listening_post_bp
    from .meshtastic import meshtastic_bp
    from .tscm import tscm_bp, init_tscm_state
    from .spy_stations import spy_stations_bp
    from .controller import controller_bp
    from .offline import offline_bp
    from .updater import updater_bp
    from .sstv import sstv_bp
    from .weather_sat import weather_sat_bp
    from .sstv_general import sstv_general_bp
    from .dmr import dmr_bp
    from .websdr import websdr_bp
    from .alerts import alerts_bp
    from .aprs import aprs_bp
    from .bluetooth import bluetooth_bp
    from .bluetooth_v2 import bluetooth_v2_bp
    from .bt_locate import bt_locate_bp
    from .controller import controller_bp
    from .correlation import correlation_bp
    from .dsc import dsc_bp
    from .gps import gps_bp
    from .listening_post import receiver_bp
    from .meshtastic import meshtastic_bp
    from .offline import offline_bp
    from .pager import pager_bp
    from .recordings import recordings_bp
    from .rtlamr import rtlamr_bp
    from .satellite import satellite_bp
    from .sensor import sensor_bp
    from .settings import settings_bp
    from .signalid import signalid_bp
    from .space_weather import space_weather_bp
    from .spy_stations import spy_stations_bp
    from .sstv import sstv_bp
    from .sstv_general import sstv_general_bp
    from .subghz import subghz_bp
    from .tscm import init_tscm_state, tscm_bp
    from .updater import updater_bp
    from .vdl2 import vdl2_bp
    from .weather_sat import weather_sat_bp
    from .websdr import websdr_bp
    from .wifi import wifi_bp
    from .wifi_v2 import wifi_v2_bp
    app.register_blueprint(pager_bp)
    app.register_blueprint(sensor_bp)
@@ -45,12 +48,13 @@ def register_blueprints(app):
    app.register_blueprint(ais_bp)
    app.register_blueprint(dsc_bp)  # VHF DSC maritime distress
    app.register_blueprint(acars_bp)
    app.register_blueprint(vdl2_bp)
    app.register_blueprint(aprs_bp)
    app.register_blueprint(satellite_bp)
    app.register_blueprint(gps_bp)
    app.register_blueprint(settings_bp)
    app.register_blueprint(correlation_bp)
-    app.register_blueprint(listening_post_bp)
+    app.register_blueprint(receiver_bp)
    app.register_blueprint(meshtastic_bp)
    app.register_blueprint(tscm_bp)
    app.register_blueprint(spy_stations_bp)
@@ -60,11 +64,13 @@ def register_blueprints(app):
    app.register_blueprint(sstv_bp)  # ISS SSTV decoder
    app.register_blueprint(weather_sat_bp)  # NOAA/Meteor weather satellite decoder
    app.register_blueprint(sstv_general_bp)  # General terrestrial SSTV
    app.register_blueprint(dmr_bp)  # DMR / P25 / Digital Voice
    app.register_blueprint(websdr_bp)  # HF/Shortwave WebSDR
    app.register_blueprint(alerts_bp)  # Cross-mode alerts
    app.register_blueprint(recordings_bp)  # Session recordings
    app.register_blueprint(subghz_bp)  # SubGHz transceiver (HackRF)
    app.register_blueprint(bt_locate_bp)  # BT Locate SAR device tracking
    app.register_blueprint(space_weather_bp)  # Space weather monitoring
    app.register_blueprint(signalid_bp)  # External signal ID enrichment
    # Initialize TSCM state with queue and lock from app
    import app as app_module
@@ -20,8 +20,9 @@ from flask import Blueprint, jsonify, request, Response
 import app as app_module
 from utils.logging import sensor_logger as logger
 from utils.validation import validate_device_index, validate_gain, validate_ppm
-from utils.sse import format_sse
+from utils.sdr import SDRFactory, SDRType
-from utils.event_pipeline import process_event
+from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.constants import (
    PROCESS_TERMINATE_TIMEOUT,
    SSE_KEEPALIVE_INTERVAL,
@@ -34,11 +35,8 @@ acars_bp = Blueprint('acars', __name__, url_prefix='/acars')
 # Default VHF ACARS frequencies (MHz) - common worldwide
 DEFAULT_ACARS_FREQUENCIES = [
-    '131.550',  # Primary worldwide
+    '131.725',  # North America
-    '130.025',  # Secondary USA/Canada
+    '131.825',  # North America
    '129.125',  # USA
    '131.525',  # Europe
    '131.725',  # Europe secondary
 ]
 # Message counter for statistics
@@ -128,6 +126,13 @@ def stream_acars_output(process: subprocess.Popen, is_text_mode: bool = False) -
                app_module.acars_queue.put(data)
                # Feed flight correlator
                try:
                    from utils.flight_correlator import get_flight_correlator
                    get_flight_correlator().add_acars_message(data)
                except Exception:
                    pass
                # Log if enabled
                if app_module.logging_enabled:
                    try:
@@ -250,12 +255,22 @@ def start_acars() -> Response:
    acars_message_count = 0
    acars_last_message_time = None
    # Resolve SDR type for device selection
    sdr_type_str = data.get('sdr_type', 'rtlsdr')
    try:
        sdr_type = SDRType(sdr_type_str)
    except ValueError:
        sdr_type = SDRType.RTL_SDR
    is_soapy = sdr_type not in (SDRType.RTL_SDR,)
    # Build acarsdec command
    # Different forks have different syntax:
    # - TLeconte v4+: acarsdec -j -g <gain> -p <ppm> -r <device> <freq1> <freq2> ...
    # - TLeconte v3: acarsdec -o 4 -g <gain> -p <ppm> -r <device> <freq1> <freq2> ...
    # - f00b4r0 (DragonOS): acarsdec --output json:file:- -g <gain> -p <ppm> -r <device> <freq1> ...
-    # Note: gain/ppm must come BEFORE -r
+    # SoapySDR devices: TLeconte uses -d <device_string>, f00b4r0 uses --soapysdr <device_string>
    # Note: gain/ppm must come BEFORE -r/-d
    json_flag = get_acarsdec_json_flag(acarsdec_path)
    cmd = [acarsdec_path]
    if json_flag == '--output':
@@ -266,21 +281,33 @@ def start_acars() -> Response:
    else:
        cmd.extend(['-o', '4'])  # JSON output (TLeconte v3.x)
-    # Add gain if not auto (must be before -r)
+    # Add gain if not auto (must be before -r/-d)
    if gain and str(gain) != '0':
        cmd.extend(['-g', str(gain)])
-    # Add PPM correction if specified (must be before -r)
+    # Add PPM correction if specified (must be before -r/-d)
    if ppm and str(ppm) != '0':
        cmd.extend(['-p', str(ppm)])
    # Add device and frequencies
-    # f00b4r0 uses --rtlsdr <device>, TLeconte uses -r <device>
+    if is_soapy:
-    if json_flag == '--output':
+        # SoapySDR device (SDRplay, LimeSDR, Airspy, etc.)
        sdr_device = SDRFactory.create_default_device(sdr_type, index=device_int)
        # Build SoapySDR driver string (e.g., "driver=sdrplay,serial=...")
        builder = SDRFactory.get_builder(sdr_type)
        device_str = builder._build_device_string(sdr_device)
        if json_flag == '--output':
            cmd.extend(['-m', '256'])
            cmd.extend(['--soapysdr', device_str])
        else:
            cmd.extend(['-d', device_str])
    elif json_flag == '--output':
        # f00b4r0 fork RTL-SDR: --rtlsdr <device>
        # Use 3.2 MS/s sample rate for wider bandwidth (handles NA frequency span)
        cmd.extend(['-m', '256'])
        cmd.extend(['--rtlsdr', str(device)])
    else:
        # TLeconte fork RTL-SDR: -r <device>
        cmd.extend(['-r', str(device)])
    cmd.extend(frequencies)
@@ -384,31 +411,25 @@ def stop_acars() -> Response:
    return jsonify({'status': 'stopped'})
-@acars_bp.route('/stream')
+@acars_bp.route('/stream')
-def stream_acars() -> Response:
+def stream_acars() -> Response:
-    """SSE stream for ACARS messages."""
+    """SSE stream for ACARS messages."""
-    def generate() -> Generator[str, None, None]:
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('acars', msg, msg.get('type'))
-
+
-        while True:
+    response = Response(
-            try:
+        sse_stream_fanout(
-                msg = app_module.acars_queue.get(timeout=SSE_QUEUE_TIMEOUT)
+            source_queue=app_module.acars_queue,
-                last_keepalive = time.time()
+            channel_key='acars',
-                try:
+            timeout=SSE_QUEUE_TIMEOUT,
-                    process_event('acars', msg, msg.get('type'))
+            keepalive_interval=SSE_KEEPALIVE_INTERVAL,
-                except Exception:
+            on_message=_on_msg,
-                    pass
+        ),
-                yield format_sse(msg)
+        mimetype='text/event-stream',
-            except queue.Empty:
+    )
-                now = time.time()
+    response.headers['Cache-Control'] = 'no-cache'
-                if now - last_keepalive >= SSE_KEEPALIVE_INTERVAL:
+    response.headers['X-Accel-Buffering'] = 'no'
-                    yield format_sse({'type': 'keepalive'})
+    return response
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    return response
@acars_bp.route('/frequencies')
@@ -417,7 +438,7 @@ def get_frequencies() -> Response:
    return jsonify({
        'default': DEFAULT_ACARS_FREQUENCIES,
        'regions': {
-            'north_america': ['129.125', '130.025', '130.450', '131.550'],
+            'north_america': ['131.725', '131.825'],
            'europe': ['131.525', '131.725', '131.550'],
            'asia_pacific': ['131.550', '131.450'],
        }
@@ -38,6 +38,7 @@ from config import (
    SHARED_OBSERVER_LOCATION_ENABLED,
 )
 from utils.logging import adsb_logger as logger
 from utils.process import write_dump1090_pid, clear_dump1090_pid, cleanup_stale_dump1090
 from utils.validation import (
    validate_device_index, validate_gain,
    validate_rtl_tcp_host, validate_rtl_tcp_port
@@ -76,6 +77,11 @@ _sbs_error_logged = False  # Suppress repeated connection error logs
 # Track ICAOs already looked up in aircraft database (avoid repeated lookups)
 _looked_up_icaos: set[str] = set()
 # Per-client SSE queues for ADS-B stream fanout.
 _adsb_stream_subscribers: set[queue.Queue] = set()
 _adsb_stream_subscribers_lock = threading.Lock()
 _ADSB_STREAM_CLIENT_QUEUE_SIZE = 500
 # Load aircraft database at module init
 aircraft_db.load_database()
@@ -202,6 +208,31 @@ def _parse_int_param(value: str | None, default: int, min_value: int | None = No
    return parsed
 def _broadcast_adsb_update(payload: dict[str, Any]) -> None:
    """Fan out a payload to all active ADS-B SSE subscribers."""
    with _adsb_stream_subscribers_lock:
        subscribers = tuple(_adsb_stream_subscribers)
    for subscriber in subscribers:
        try:
            subscriber.put_nowait(payload)
        except queue.Full:
            # Drop oldest queued event for that client and try once more.
            try:
                subscriber.get_nowait()
                subscriber.put_nowait(payload)
            except (queue.Empty, queue.Full):
                # Client queue remains saturated; skip this payload.
                continue
 def _adsb_stream_queue_depth() -> int:
    """Best-effort aggregate queue depth across connected ADS-B SSE clients."""
    with _adsb_stream_subscribers_lock:
        subscribers = tuple(_adsb_stream_subscribers)
    return sum(subscriber.qsize() for subscriber in subscribers)
 def _get_active_session() -> dict[str, Any] | None:
    if not ADSB_HISTORY_ENABLED or not PSYCOPG2_AVAILABLE:
        return None
@@ -348,10 +379,62 @@ def parse_sbs_stream(service_addr):
            adsb_bytes_received = 0
            adsb_lines_received = 0
            def flush_pending_updates(force: bool = False) -> None:
                nonlocal last_update
                if not pending_updates:
                    return
                now = time.time()
                if not force and now - last_update < ADSB_UPDATE_INTERVAL:
                    return
                captured_at = datetime.now(timezone.utc)
                for update_icao in tuple(pending_updates):
                    if update_icao in app_module.adsb_aircraft:
                        snapshot = app_module.adsb_aircraft[update_icao]
                        _broadcast_adsb_update({
                            'type': 'aircraft',
                            **snapshot
                        })
                        adsb_snapshot_writer.enqueue({
                            'captured_at': captured_at,
                            'icao': update_icao,
                            'callsign': snapshot.get('callsign'),
                            'registration': snapshot.get('registration'),
                            'type_code': snapshot.get('type_code'),
                            'type_desc': snapshot.get('type_desc'),
                            'altitude': snapshot.get('altitude'),
                            'speed': snapshot.get('speed'),
                            'heading': snapshot.get('heading'),
                            'vertical_rate': snapshot.get('vertical_rate'),
                            'lat': snapshot.get('lat'),
                            'lon': snapshot.get('lon'),
                            'squawk': snapshot.get('squawk'),
                            'source_host': service_addr,
                            'snapshot': snapshot,
                        })
                        # Geofence check
                        _gf_lat = snapshot.get('lat')
                        _gf_lon = snapshot.get('lon')
                        if _gf_lat is not None and _gf_lon is not None:
                            try:
                                from utils.geofence import get_geofence_manager
                                for _gf_evt in get_geofence_manager().check_position(
                                    update_icao, 'aircraft', _gf_lat, _gf_lon,
                                    {'callsign': snapshot.get('callsign'), 'altitude': snapshot.get('altitude')}
                                ):
                                    process_event('adsb', _gf_evt, 'geofence')
                            except Exception:
                                pass
                pending_updates.clear()
                last_update = now
            while adsb_using_service:
                try:
                    data = sock.recv(SOCKET_BUFFER_SIZE).decode('utf-8', errors='ignore')
                    if not data:
                        flush_pending_updates(force=True)
                        logger.warning("SBS connection closed (no data)")
                        break
                    adsb_bytes_received += len(data)
@@ -438,6 +521,12 @@ def parse_sbs_stream(service_addr):
                            if parts[16]:
                                try:
                                    aircraft['vertical_rate'] = int(float(parts[16]))
                                    if abs(aircraft['vertical_rate']) > 4000:
                                        process_event('adsb', {
                                            'type': 'vertical_rate_anomaly', 'icao': icao,
                                            'callsign': aircraft.get('callsign', ''),
                                            'vertical_rate': aircraft['vertical_rate'],
                                        }, 'vertical_rate_anomaly')
                                except (ValueError, TypeError):
                                    pass
@@ -455,44 +544,49 @@ def parse_sbs_stream(service_addr):
                        elif msg_type == '6' and len(parts) > 17:
                            if parts[17]:
                                aircraft['squawk'] = parts[17]
                                sq = parts[17].strip()
                                _EMERGENCY_SQUAWKS = {'7700': 'General Emergency', '7600': 'Comms Failure', '7500': 'Hijack'}
                                if sq in _EMERGENCY_SQUAWKS:
                                    process_event('adsb', {
                                        'type': 'squawk_emergency', 'icao': icao,
                                        'callsign': aircraft.get('callsign', ''),
                                        'squawk': sq, 'meaning': _EMERGENCY_SQUAWKS[sq],
                                    }, 'squawk_emergency')
                        elif msg_type == '2' and len(parts) > 15:
                            if parts[11]:
                                try:
                                    aircraft['altitude'] = int(float(parts[11]))
                                except (ValueError, TypeError):
                                    pass
                            if parts[12]:
                                try:
                                    aircraft['speed'] = int(float(parts[12]))
                                except (ValueError, TypeError):
                                    pass
                            if parts[13]:
                                try:
                                    aircraft['heading'] = int(float(parts[13]))
                                except (ValueError, TypeError):
                                    pass
                            if parts[14] and parts[15]:
                                try:
                                    aircraft['lat'] = float(parts[14])
                                    aircraft['lon'] = float(parts[15])
                                except (ValueError, TypeError):
                                    pass
                        app_module.adsb_aircraft.set(icao, aircraft)
                        pending_updates.add(icao)
                        adsb_messages_received += 1
                        adsb_last_message_time = time.time()
-
+                        flush_pending_updates()
                        now = time.time()
                        if now - last_update >= ADSB_UPDATE_INTERVAL:
                            for update_icao in pending_updates:
                                if update_icao in app_module.adsb_aircraft:
                                    snapshot = app_module.adsb_aircraft[update_icao]
                                    app_module.adsb_queue.put({
                                        'type': 'aircraft',
                                        **snapshot
                                    })
                                    adsb_snapshot_writer.enqueue({
                                        'captured_at': datetime.now(timezone.utc),
                                        'icao': update_icao,
                                        'callsign': snapshot.get('callsign'),
                                        'registration': snapshot.get('registration'),
                                        'type_code': snapshot.get('type_code'),
                                        'type_desc': snapshot.get('type_desc'),
                                        'altitude': snapshot.get('altitude'),
                                        'speed': snapshot.get('speed'),
                                        'heading': snapshot.get('heading'),
                                        'vertical_rate': snapshot.get('vertical_rate'),
                                        'lat': snapshot.get('lat'),
                                        'lon': snapshot.get('lon'),
                                        'squawk': snapshot.get('squawk'),
                                        'source_host': service_addr,
                                        'snapshot': snapshot,
                                    })
                            pending_updates.clear()
                            last_update = now
                except socket.timeout:
                    flush_pending_updates()
                    continue
            flush_pending_updates(force=True)
            sock.close()
            adsb_connected = False
        except OSError as e:
@@ -552,7 +646,7 @@ def adsb_status():
        'last_message_time': adsb_last_message_time,
        'aircraft_count': len(app_module.adsb_aircraft),
        'aircraft': dict(app_module.adsb_aircraft),  # Full aircraft data
-        'queue_size': app_module.adsb_queue.qsize(),
+        'queue_size': _adsb_stream_queue_depth(),
        'dump1090_path': find_dump1090(),
        'dump1090_running': dump1090_running,
        'port_30003_open': check_dump1090_service() is not None
@@ -633,6 +727,9 @@ def start_adsb():
            'session': session
        })
    # Kill any stale app-spawned dump1090 from a previous run before checking the port
    cleanup_stale_dump1090()
    # Check if dump1090 is already running externally (e.g., user started it manually)
    existing_service = check_dump1090_service()
    if existing_service:
@@ -685,6 +782,7 @@ def start_adsb():
            except (ProcessLookupError, OSError):
                pass
        app_module.adsb_process = None
        clear_dump1090_pid()
        logger.info("Killed stale ADS-B process")
    # Check if device is available before starting local dump1090
@@ -721,6 +819,7 @@ def start_adsb():
            stderr=subprocess.PIPE,
            start_new_session=True  # Create new process group for clean shutdown
        )
        write_dump1090_pid(app_module.adsb_process.pid)
        time.sleep(DUMP1090_START_WAIT)
@@ -819,6 +918,7 @@ def stop_adsb():
                except (ProcessLookupError, OSError):
                    pass
            app_module.adsb_process = None
            clear_dump1090_pid()
            logger.info("ADS-B process stopped")
        # Release device from registry
@@ -837,23 +937,39 @@ def stop_adsb():
@adsb_bp.route('/stream')
 def stream_adsb():
    """SSE stream for ADS-B aircraft."""
    client_queue: queue.Queue = queue.Queue(maxsize=_ADSB_STREAM_CLIENT_QUEUE_SIZE)
    with _adsb_stream_subscribers_lock:
        _adsb_stream_subscribers.add(client_queue)
    # Prime new clients with current known aircraft so they don't wait for the
    # next positional update before rendering.
    for snapshot in list(app_module.adsb_aircraft.values()):
        try:
            client_queue.put_nowait({'type': 'aircraft', **snapshot})
        except queue.Full:
            break
    def generate():
        last_keepalive = time.time()
-        while True:
+        try:
-            try:
+            while True:
                msg = app_module.adsb_queue.get(timeout=SSE_QUEUE_TIMEOUT)
                last_keepalive = time.time()
                try:
-                    process_event('adsb', msg, msg.get('type'))
+                    msg = client_queue.get(timeout=SSE_QUEUE_TIMEOUT)
-                except Exception:
+                    last_keepalive = time.time()
-                    pass
+                    try:
-                yield format_sse(msg)
+                        process_event('adsb', msg, msg.get('type'))
-            except queue.Empty:
+                    except Exception:
-                now = time.time()
+                        pass
-                if now - last_keepalive >= SSE_KEEPALIVE_INTERVAL:
+                    yield format_sse(msg)
-                    yield format_sse({'type': 'keepalive'})
+                except queue.Empty:
-                    last_keepalive = now
+                    now = time.time()
                    if now - last_keepalive >= SSE_KEEPALIVE_INTERVAL:
                        yield format_sse({'type': 'keepalive'})
                        last_keepalive = now
        finally:
            with _adsb_stream_subscribers_lock:
                _adsb_stream_subscribers.discard(client_queue)
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
@@ -864,10 +980,12 @@ def stream_adsb():
@adsb_bp.route('/dashboard')
 def adsb_dashboard():
    """Popout ADS-B dashboard."""
    embedded = request.args.get('embedded', 'false') == 'true'
    return render_template(
        'adsb_dashboard.html',
        shared_observer_location=SHARED_OBSERVER_LOCATION_ENABLED,
        adsb_auto_start=ADSB_AUTO_START,
        embedded=embedded,
    )
@@ -1096,3 +1214,17 @@ def aircraft_photo(registration: str):
    except Exception as e:
        logger.debug(f"Error fetching aircraft photo: {e}")
        return jsonify({'success': False, 'error': str(e)}), 500
@adsb_bp.route('/aircraft/<icao>/messages')
 def get_aircraft_messages(icao: str):
    """Get correlated ACARS/VDL2 messages for an aircraft."""
    if not icao or not all(c in '0123456789ABCDEFabcdef' for c in icao):
        return jsonify({'status': 'error', 'message': 'Invalid ICAO'}), 400
    aircraft = app_module.adsb_aircraft.get(icao.upper())
    callsign = aircraft.get('callsign') if aircraft else None
    from utils.flight_correlator import get_flight_correlator
    messages = get_flight_correlator().get_messages_for_aircraft(icao=icao.upper(), callsign=callsign)
    return jsonify({'status': 'success', 'icao': icao.upper(), **messages})
@@ -18,7 +18,7 @@ import app as app_module
 from config import SHARED_OBSERVER_LOCATION_ENABLED
 from utils.logging import get_logger
 from utils.validation import validate_device_index, validate_gain
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.sdr import SDRFactory, SDRType
 from utils.constants import (
@@ -124,13 +124,27 @@ def parse_ais_stream(port: int):
                    if now - last_update >= AIS_UPDATE_INTERVAL:
                        for mmsi in pending_updates:
                            if mmsi in app_module.ais_vessels:
                                _vessel_snap = app_module.ais_vessels[mmsi]
                                try:
                                    app_module.ais_queue.put_nowait({
                                        'type': 'vessel',
-                                        **app_module.ais_vessels[mmsi]
+                                        **_vessel_snap
                                    })
                                except queue.Full:
                                    pass
                                # Geofence check
                                _v_lat = _vessel_snap.get('lat')
                                _v_lon = _vessel_snap.get('lon')
                                if _v_lat and _v_lon:
                                    try:
                                        from utils.geofence import get_geofence_manager
                                        for _gf_evt in get_geofence_manager().check_position(
                                            mmsi, 'vessel', _v_lat, _v_lon,
                                            {'name': _vessel_snap.get('name'), 'ship_type': _vessel_snap.get('ship_type_text')}
                                        ):
                                            process_event('ais', _gf_evt, 'geofence')
                                    except Exception:
                                        pass
                        pending_updates.clear()
                        last_update = now
@@ -282,6 +296,16 @@ def process_ais_message(msg: dict) -> dict | None:
    # Timestamp
    vessel['last_seen'] = time.time()
    # Check for DSC DISTRESS matching this MMSI
    try:
        for _dsc_key, _dsc_msg in app_module.dsc_messages.items():
            if (str(_dsc_msg.get('source_mmsi', '')) == mmsi
                    and _dsc_msg.get('category', '').upper() == 'DISTRESS'):
                vessel['dsc_distress'] = True
                break
    except Exception:
        pass
    return vessel
@@ -478,34 +502,47 @@ def stop_ais():
@ais_bp.route('/stream')
 def stream_ais():
    """SSE stream for AIS vessels."""
-    def generate() -> Generator[str, None, None]:
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('ais', msg, msg.get('type'))
-        while True:
+    response = Response(
-            try:
+        sse_stream_fanout(
-                msg = app_module.ais_queue.get(timeout=SSE_QUEUE_TIMEOUT)
+            source_queue=app_module.ais_queue,
-                last_keepalive = time.time()
+            channel_key='ais',
-                try:
+            timeout=SSE_QUEUE_TIMEOUT,
-                    process_event('ais', msg, msg.get('type'))
+            keepalive_interval=SSE_KEEPALIVE_INTERVAL,
-                except Exception:
+            on_message=_on_msg,
-                    pass
+        ),
-                yield format_sse(msg)
+        mimetype='text/event-stream',
-            except queue.Empty:
+    )
                now = time.time()
                if now - last_keepalive >= SSE_KEEPALIVE_INTERVAL:
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    return response
@ais_bp.route('/vessel/<mmsi>/dsc')
 def get_vessel_dsc(mmsi: str):
    """Get DSC messages associated with a vessel MMSI."""
    if not mmsi or not mmsi.isdigit():
        return jsonify({'status': 'error', 'message': 'Invalid MMSI'}), 400
    matches = []
    try:
        for key, msg in app_module.dsc_messages.items():
            if str(msg.get('source_mmsi', '')) == mmsi:
                matches.append(dict(msg))
    except Exception:
        pass
    return jsonify({'status': 'success', 'mmsi': mmsi, 'dsc_messages': matches})
@ais_bp.route('/dashboard')
 def ais_dashboard():
    """Popout AIS dashboard."""
    embedded = request.args.get('embedded', 'false') == 'true'
    return render_template(
        'ais_dashboard.html',
        shared_observer_location=SHARED_OBSERVER_LOCATION_ENABLED,
        embedded=embedded,
    )
@@ -19,16 +19,16 @@ from typing import Generator, Optional
 from flask import Blueprint, jsonify, request, Response
 import app as app_module
-from utils.logging import sensor_logger as logger
+from utils.logging import sensor_logger as logger
-from utils.validation import validate_device_index, validate_gain, validate_ppm
+from utils.validation import validate_device_index, validate_gain, validate_ppm
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
-from utils.event_pipeline import process_event
+from utils.event_pipeline import process_event
-from utils.sdr import SDRFactory, SDRType
+from utils.sdr import SDRFactory, SDRType
-from utils.constants import (
+from utils.constants import (
-    PROCESS_TERMINATE_TIMEOUT,
+    PROCESS_TERMINATE_TIMEOUT,
-    SSE_KEEPALIVE_INTERVAL,
+    SSE_KEEPALIVE_INTERVAL,
-    SSE_QUEUE_TIMEOUT,
+    SSE_QUEUE_TIMEOUT,
-    PROCESS_START_WAIT,
+    PROCESS_START_WAIT,
 )
 aprs_bp = Blueprint('aprs', __name__, url_prefix='/aprs')
@@ -47,6 +47,8 @@ APRS_FREQUENCIES = {
    'brazil': '145.570',
    'japan': '144.640',
    'china': '144.640',
    'iss': '145.825',
    'sonate2': '145.825',
 }
 # Statistics
@@ -73,19 +75,19 @@ def find_multimon_ng() -> Optional[str]:
    return shutil.which('multimon-ng')
-def find_rtl_fm() -> Optional[str]:
+def find_rtl_fm() -> Optional[str]:
-    """Find rtl_fm binary."""
+    """Find rtl_fm binary."""
-    return shutil.which('rtl_fm')
+    return shutil.which('rtl_fm')
-
+
-
+
-def find_rx_fm() -> Optional[str]:
+def find_rx_fm() -> Optional[str]:
-    """Find SoapySDR rx_fm binary."""
+    """Find SoapySDR rx_fm binary."""
-    return shutil.which('rx_fm')
+    return shutil.which('rx_fm')
-
+
-
+
-def find_rtl_power() -> Optional[str]:
+def find_rtl_power() -> Optional[str]:
-    """Find rtl_power binary for spectrum scanning."""
+    """Find rtl_power binary for spectrum scanning."""
-    return shutil.which('rtl_power')
+    return shutil.which('rtl_power')
 # Path to direwolf config file
@@ -1378,6 +1380,19 @@ def stream_aprs_output(rtl_process: subprocess.Popen, decoder_process: subproces
                        'last_seen': packet.get('timestamp'),
                        'packet_type': packet.get('packet_type'),
                    }
                    # Geofence check
                    _aprs_lat = packet.get('lat')
                    _aprs_lon = packet.get('lon')
                    if _aprs_lat and _aprs_lon:
                        try:
                            from utils.geofence import get_geofence_manager
                            for _gf_evt in get_geofence_manager().check_position(
                                callsign, 'aprs_station', _aprs_lat, _aprs_lon,
                                {'callsign': callsign}
                            ):
                                process_event('aprs', _gf_evt, 'geofence')
                        except Exception:
                            pass
                    # Evict oldest stations when limit is exceeded
                    if len(aprs_stations) > APRS_MAX_STATIONS:
                        oldest = min(
@@ -1420,22 +1435,22 @@ def stream_aprs_output(rtl_process: subprocess.Popen, decoder_process: subproces
@aprs_bp.route('/tools')
-def check_aprs_tools() -> Response:
+def check_aprs_tools() -> Response:
-    """Check for APRS decoding tools."""
+    """Check for APRS decoding tools."""
-    has_rtl_fm = find_rtl_fm() is not None
+    has_rtl_fm = find_rtl_fm() is not None
-    has_rx_fm = find_rx_fm() is not None
+    has_rx_fm = find_rx_fm() is not None
-    has_direwolf = find_direwolf() is not None
+    has_direwolf = find_direwolf() is not None
-    has_multimon = find_multimon_ng() is not None
+    has_multimon = find_multimon_ng() is not None
-    has_fm_demod = has_rtl_fm or has_rx_fm
+    has_fm_demod = has_rtl_fm or has_rx_fm
-
+
-    return jsonify({
+    return jsonify({
-        'rtl_fm': has_rtl_fm,
+        'rtl_fm': has_rtl_fm,
-        'rx_fm': has_rx_fm,
+        'rx_fm': has_rx_fm,
-        'direwolf': has_direwolf,
+        'direwolf': has_direwolf,
-        'multimon_ng': has_multimon,
+        'multimon_ng': has_multimon,
-        'ready': has_fm_demod and (has_direwolf or has_multimon),
+        'ready': has_fm_demod and (has_direwolf or has_multimon),
-        'decoder': 'direwolf' if has_direwolf else ('multimon-ng' if has_multimon else None)
+        'decoder': 'direwolf' if has_direwolf else ('multimon-ng' if has_multimon else None)
-    })
+    })
@aprs_bp.route('/status')
@@ -1476,12 +1491,12 @@ def start_aprs() -> Response:
                'message': 'APRS decoder already running'
            }), 409
-    # Check for decoder (prefer direwolf, fallback to multimon-ng)
+    # Check for decoder (prefer direwolf, fallback to multimon-ng)
-    direwolf_path = find_direwolf()
+    direwolf_path = find_direwolf()
-    multimon_path = find_multimon_ng()
+    multimon_path = find_multimon_ng()
-
+
-    if not direwolf_path and not multimon_path:
+    if not direwolf_path and not multimon_path:
-        return jsonify({
+        return jsonify({
            'status': 'error',
            'message': 'No APRS decoder found. Install direwolf or multimon-ng'
        }), 400
@@ -1489,31 +1504,31 @@ def start_aprs() -> Response:
    data = request.json or {}
    # Validate inputs
-    try:
+    try:
-        device = validate_device_index(data.get('device', '0'))
+        device = validate_device_index(data.get('device', '0'))
-        gain = validate_gain(data.get('gain', '40'))
+        gain = validate_gain(data.get('gain', '40'))
-        ppm = validate_ppm(data.get('ppm', '0'))
+        ppm = validate_ppm(data.get('ppm', '0'))
-    except ValueError as e:
+    except ValueError as e:
-        return jsonify({'status': 'error', 'message': str(e)}), 400
+        return jsonify({'status': 'error', 'message': str(e)}), 400
-
+
-    sdr_type_str = str(data.get('sdr_type', 'rtlsdr')).lower()
+    sdr_type_str = str(data.get('sdr_type', 'rtlsdr')).lower()
-    try:
+    try:
-        sdr_type = SDRType(sdr_type_str)
+        sdr_type = SDRType(sdr_type_str)
-    except ValueError:
+    except ValueError:
-        sdr_type = SDRType.RTL_SDR
+        sdr_type = SDRType.RTL_SDR
-
+
-    if sdr_type == SDRType.RTL_SDR:
+    if sdr_type == SDRType.RTL_SDR:
-        if find_rtl_fm() is None:
+        if find_rtl_fm() is None:
-            return jsonify({
+            return jsonify({
-                'status': 'error',
+                'status': 'error',
-                'message': 'rtl_fm not found. Install with: sudo apt install rtl-sdr'
+                'message': 'rtl_fm not found. Install with: sudo apt install rtl-sdr'
-            }), 400
+            }), 400
-    else:
+    else:
-        if find_rx_fm() is None:
+        if find_rx_fm() is None:
-            return jsonify({
+            return jsonify({
-                'status': 'error',
+                'status': 'error',
-                'message': f'rx_fm not found. Install SoapySDR tools for {sdr_type.value}.'
+                'message': f'rx_fm not found. Install SoapySDR tools for {sdr_type.value}.'
-            }), 400
+            }), 400
    # Reserve SDR device to prevent conflicts with other modes
    error = app_module.claim_sdr_device(device, 'aprs')
@@ -1545,29 +1560,29 @@ def start_aprs() -> Response:
    aprs_last_packet_time = None
    aprs_stations = {}
-    # Build FM demod command for APRS (AFSK1200 @ 22050 Hz) via SDR abstraction.
+    # Build FM demod command for APRS (AFSK1200 @ 22050 Hz) via SDR abstraction.
-    try:
+    try:
-        sdr_device = SDRFactory.create_default_device(sdr_type, index=device)
+        sdr_device = SDRFactory.create_default_device(sdr_type, index=device)
-        builder = SDRFactory.get_builder(sdr_type)
+        builder = SDRFactory.get_builder(sdr_type)
-        rtl_cmd = builder.build_fm_demod_command(
+        rtl_cmd = builder.build_fm_demod_command(
-            device=sdr_device,
+            device=sdr_device,
-            frequency_mhz=float(frequency),
+            frequency_mhz=float(frequency),
-            sample_rate=22050,
+            sample_rate=22050,
-            gain=float(gain) if gain and str(gain) != '0' else None,
+            gain=float(gain) if gain and str(gain) != '0' else None,
-            ppm=int(ppm) if ppm and str(ppm) != '0' else None,
+            ppm=int(ppm) if ppm and str(ppm) != '0' else None,
-            modulation='nfm' if sdr_type == SDRType.RTL_SDR else 'fm',
+            modulation='nfm' if sdr_type == SDRType.RTL_SDR else 'fm',
-            squelch=None,
+            squelch=None,
-            bias_t=bool(data.get('bias_t', False)),
+            bias_t=bool(data.get('bias_t', False)),
-        )
+        )
-
+
-        if sdr_type == SDRType.RTL_SDR and rtl_cmd and rtl_cmd[-1] == '-':
+        if sdr_type == SDRType.RTL_SDR and rtl_cmd and rtl_cmd[-1] == '-':
-            # APRS benefits from DC blocking + fast AGC on rtl_fm.
+            # APRS benefits from DC blocking + fast AGC on rtl_fm.
-            rtl_cmd = rtl_cmd[:-1] + ['-E', 'dc', '-A', 'fast', '-']
+            rtl_cmd = rtl_cmd[:-1] + ['-E', 'dc', '-A', 'fast', '-']
-    except Exception as e:
+    except Exception as e:
-        if aprs_active_device is not None:
+        if aprs_active_device is not None:
-            app_module.release_sdr_device(aprs_active_device)
+            app_module.release_sdr_device(aprs_active_device)
-            aprs_active_device = None
+            aprs_active_device = None
-        return jsonify({'status': 'error', 'message': f'Failed to build SDR command: {e}'}), 500
+        return jsonify({'status': 'error', 'message': f'Failed to build SDR command: {e}'}), 500
    # Build decoder command
    if direwolf_path:
@@ -1690,14 +1705,14 @@ def start_aprs() -> Response:
        )
        thread.start()
-        return jsonify({
+        return jsonify({
-            'status': 'started',
+            'status': 'started',
-            'frequency': frequency,
+            'frequency': frequency,
-            'region': region,
+            'region': region,
-            'device': device,
+            'device': device,
-            'sdr_type': sdr_type.value,
+            'sdr_type': sdr_type.value,
-            'decoder': decoder_name
+            'decoder': decoder_name
-        })
+        })
    except Exception as e:
        logger.error(f"Failed to start APRS decoder: {e}")
@@ -1748,31 +1763,25 @@ def stop_aprs() -> Response:
    return jsonify({'status': 'stopped'})
-@aprs_bp.route('/stream')
+@aprs_bp.route('/stream')
-def stream_aprs() -> Response:
+def stream_aprs() -> Response:
-    """SSE stream for APRS packets."""
+    """SSE stream for APRS packets."""
-    def generate() -> Generator[str, None, None]:
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('aprs', msg, msg.get('type'))
-
+
-        while True:
+    response = Response(
-            try:
+        sse_stream_fanout(
-                msg = app_module.aprs_queue.get(timeout=SSE_QUEUE_TIMEOUT)
+            source_queue=app_module.aprs_queue,
-                last_keepalive = time.time()
+            channel_key='aprs',
-                try:
+            timeout=SSE_QUEUE_TIMEOUT,
-                    process_event('aprs', msg, msg.get('type'))
+            keepalive_interval=SSE_KEEPALIVE_INTERVAL,
-                except Exception:
+            on_message=_on_msg,
-                    pass
+        ),
-                yield format_sse(msg)
+        mimetype='text/event-stream',
-            except queue.Empty:
+    )
-                now = time.time()
+    response.headers['Cache-Control'] = 'no-cache'
-                if now - last_keepalive >= SSE_KEEPALIVE_INTERVAL:
+    response.headers['X-Accel-Buffering'] = 'no'
-                    yield format_sse({'type': 'keepalive'})
+    return response
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    return response
@aprs_bp.route('/frequencies')
@@ -20,7 +20,7 @@ from flask import Blueprint, jsonify, request, Response
 import app as app_module
 from utils.dependencies import check_tool
 from utils.logging import bluetooth_logger as logger
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.validation import validate_bluetooth_interface
 from data.oui import OUI_DATABASE, load_oui_database, get_manufacturer
@@ -553,30 +553,23 @@ def get_bt_devices():
    })
-@bluetooth_bp.route('/stream')
+@bluetooth_bp.route('/stream')
-def stream_bt():
+def stream_bt():
-    """SSE stream for Bluetooth events."""
+    """SSE stream for Bluetooth events."""
-    def generate():
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('bluetooth', msg, msg.get('type'))
-        keepalive_interval = 30.0
+
-
+    response = Response(
-        while True:
+        sse_stream_fanout(
-            try:
+            source_queue=app_module.bt_queue,
-                msg = app_module.bt_queue.get(timeout=1)
+            channel_key='bluetooth',
-                last_keepalive = time.time()
+            timeout=1.0,
-                try:
+            keepalive_interval=30.0,
-                    process_event('bluetooth', msg, msg.get('type'))
+            on_message=_on_msg,
-                except Exception:
+        ),
-                    pass
+        mimetype='text/event-stream',
-                yield format_sse(msg)
+    )
-            except queue.Empty:
+    response.headers['Cache-Control'] = 'no-cache'
-                now = time.time()
+    response.headers['X-Accel-Buffering'] = 'no'
-                if now - last_keepalive >= keepalive_interval:
+    response.headers['Connection'] = 'keep-alive'
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
    return response
@@ -7,40 +7,40 @@ aggregation, and heuristics.
 from __future__ import annotations
-import csv
+import csv
-import io
+import io
-import json
+import json
-import logging
+import logging
-import threading
+import threading
-import time
+import time
 from datetime import datetime
 from typing import Generator
 from flask import Blueprint, Response, jsonify, request, session
-from utils.bluetooth import (
+from utils.bluetooth import (
-    BluetoothScanner,
+    BluetoothScanner,
-    BTDeviceAggregate,
+    BTDeviceAggregate,
-    get_bluetooth_scanner,
+    get_bluetooth_scanner,
-    check_capabilities,
+    check_capabilities,
-    RANGE_UNKNOWN,
+    RANGE_UNKNOWN,
    TrackerType,
    TrackerConfidence,
    get_tracker_engine,
-)
+)
-from utils.database import get_db
+from utils.database import get_db
-from utils.sse import format_sse
+from utils.sse import format_sse
-from utils.event_pipeline import process_event
+from utils.event_pipeline import process_event
 logger = logging.getLogger('intercept.bluetooth_v2')
 # Blueprint
-bluetooth_v2_bp = Blueprint('bluetooth_v2', __name__, url_prefix='/api/bluetooth')
+bluetooth_v2_bp = Blueprint('bluetooth_v2', __name__, url_prefix='/api/bluetooth')
-
+
-# Seen-before tracking
+# Seen-before tracking
-_bt_seen_cache: set[str] = set()
+_bt_seen_cache: set[str] = set()
-_bt_session_seen: set[str] = set()
+_bt_session_seen: set[str] = set()
-_bt_seen_lock = threading.Lock()
+_bt_seen_lock = threading.Lock()
 # =============================================================================
 # DATABASE FUNCTIONS
@@ -172,20 +172,20 @@ def get_all_baselines() -> list[dict]:
        return [dict(row) for row in cursor]
-def save_observation_history(device: BTDeviceAggregate) -> None:
+def save_observation_history(device: BTDeviceAggregate) -> None:
-    """Save device observation to history."""
+    """Save device observation to history."""
-    with get_db() as conn:
+    with get_db() as conn:
-        conn.execute('''
+        conn.execute('''
-            INSERT INTO bt_observation_history (device_id, rssi, seen_count)
+            INSERT INTO bt_observation_history (device_id, rssi, seen_count)
-            VALUES (?, ?, ?)
+            VALUES (?, ?, ?)
-        ''', (device.device_id, device.rssi_current, device.seen_count))
+        ''', (device.device_id, device.rssi_current, device.seen_count))
-
+
-
+
-def load_seen_device_ids() -> set[str]:
+def load_seen_device_ids() -> set[str]:
-    """Load distinct device IDs from history for seen-before tracking."""
+    """Load distinct device IDs from history for seen-before tracking."""
-    with get_db() as conn:
+    with get_db() as conn:
-        cursor = conn.execute('SELECT DISTINCT device_id FROM bt_observation_history')
+        cursor = conn.execute('SELECT DISTINCT device_id FROM bt_observation_history')
-        return {row['device_id'] for row in cursor}
+        return {row['device_id'] for row in cursor}
 # =============================================================================
@@ -206,7 +206,7 @@ def get_capabilities():
@bluetooth_v2_bp.route('/scan/start', methods=['POST'])
-def start_scan():
+def start_scan():
    """
    Start Bluetooth scanning.
@@ -229,49 +229,49 @@ def start_scan():
    rssi_threshold = data.get('rssi_threshold', -100)
    # Validate mode
-    valid_modes = ('auto', 'dbus', 'bleak', 'hcitool', 'bluetoothctl')
+    valid_modes = ('auto', 'dbus', 'bleak', 'hcitool', 'bluetoothctl', 'ubertooth')
    if mode not in valid_modes:
        return jsonify({'error': f'Invalid mode. Must be one of: {valid_modes}'}), 400
    # Get scanner instance
    scanner = get_bluetooth_scanner(adapter_id)
-    # Initialize database tables if needed
+    # Initialize database tables if needed
-    init_bt_tables()
+    init_bt_tables()
-
+
-    def _handle_seen_before(device: BTDeviceAggregate) -> None:
+    def _handle_seen_before(device: BTDeviceAggregate) -> None:
-        try:
+        try:
-            with _bt_seen_lock:
+            with _bt_seen_lock:
-                device.seen_before = device.device_id in _bt_seen_cache
+                device.seen_before = device.device_id in _bt_seen_cache
-                if device.device_id not in _bt_session_seen:
+                if device.device_id not in _bt_session_seen:
-                    save_observation_history(device)
+                    save_observation_history(device)
-                    _bt_session_seen.add(device.device_id)
+                    _bt_session_seen.add(device.device_id)
-        except Exception as e:
+        except Exception as e:
-            logger.debug(f"BT seen-before update failed: {e}")
+            logger.debug(f"BT seen-before update failed: {e}")
-
+
-    # Setup seen-before callback
+    # Setup seen-before callback
-    if scanner._on_device_updated is None:
+    if _handle_seen_before not in scanner._on_device_updated_callbacks:
-        scanner._on_device_updated = _handle_seen_before
+        scanner.add_device_callback(_handle_seen_before)
-
+
-    # Ensure cache is initialized
+    # Ensure cache is initialized
-    with _bt_seen_lock:
+    with _bt_seen_lock:
-        if not _bt_seen_cache:
+        if not _bt_seen_cache:
-            _bt_seen_cache.update(load_seen_device_ids())
+            _bt_seen_cache.update(load_seen_device_ids())
-
+
-    # Check if already scanning
+    # Check if already scanning
-    if scanner.is_scanning:
+    if scanner.is_scanning:
-        return jsonify({
+        return jsonify({
-            'status': 'already_running',
+            'status': 'already_running',
-            'scan_status': scanner.get_status().to_dict()
+            'scan_status': scanner.get_status().to_dict()
-        })
+        })
-
+
-    # Refresh seen-before cache and reset session set for a new scan
+    # Refresh seen-before cache and reset session set for a new scan
-    with _bt_seen_lock:
+    with _bt_seen_lock:
-        _bt_seen_cache.clear()
+        _bt_seen_cache.clear()
-        _bt_seen_cache.update(load_seen_device_ids())
+        _bt_seen_cache.update(load_seen_device_ids())
-        _bt_session_seen.clear()
+        _bt_session_seen.clear()
-
+
-    # Load active baseline if exists
+    # Load active baseline if exists
    baseline_id = get_active_baseline_id()
    if baseline_id:
        device_ids = get_baseline_device_ids(baseline_id)
@@ -896,15 +896,15 @@ def stream_events():
        else:
            return event_type, event
-    def event_generator() -> Generator[str, None, None]:
+    def event_generator() -> Generator[str, None, None]:
-        """Generate SSE events from scanner."""
+        """Generate SSE events from scanner."""
-        for event in scanner.stream_events(timeout=1.0):
+        for event in scanner.stream_events(timeout=1.0):
-            event_name, event_data = map_event_type(event)
+            event_name, event_data = map_event_type(event)
-            try:
+            try:
-                process_event('bluetooth', event_data, event_name)
+                process_event('bluetooth', event_data, event_name)
-            except Exception:
+            except Exception:
-                pass
+                pass
-            yield format_sse(event_data, event=event_name)
+            yield format_sse(event_data, event=event_name)
    return Response(
        event_generator(),
@@ -988,34 +988,34 @@ def get_tscm_bluetooth_snapshot(duration: int = 8) -> list[dict]:
    devices = scanner.get_devices()
    logger.info(f"TSCM snapshot: get_devices() returned {len(devices)} devices")
-    # Convert to TSCM format with tracker detection data
+    # Convert to TSCM format with tracker detection data
-    tscm_devices = []
+    tscm_devices = []
-    for device in devices:
+    for device in devices:
-        manufacturer_name = device.manufacturer_name
+        manufacturer_name = device.manufacturer_name
-        if (not manufacturer_name) or str(manufacturer_name).lower().startswith('unknown'):
+        if (not manufacturer_name) or str(manufacturer_name).lower().startswith('unknown'):
-            if device.address and not device.is_randomized_mac:
+            if device.address and not device.is_randomized_mac:
-                try:
+                try:
-                    from data.oui import get_manufacturer
+                    from data.oui import get_manufacturer
-                    oui_vendor = get_manufacturer(device.address)
+                    oui_vendor = get_manufacturer(device.address)
-                    if oui_vendor and oui_vendor != 'Unknown':
+                    if oui_vendor and oui_vendor != 'Unknown':
-                        manufacturer_name = oui_vendor
+                        manufacturer_name = oui_vendor
-                except Exception:
+                except Exception:
-                    pass
+                    pass
-
+
-        device_data = {
+        device_data = {
-            'mac': device.address,
+            'mac': device.address,
-            'address_type': device.address_type,
+            'address_type': device.address_type,
-            'device_key': device.device_key,
+            'device_key': device.device_key,
-            'name': device.name or 'Unknown',
+            'name': device.name or 'Unknown',
-            'rssi': device.rssi_current or -100,
+            'rssi': device.rssi_current or -100,
-            'rssi_median': device.rssi_median,
+            'rssi_median': device.rssi_median,
-            'rssi_ema': round(device.rssi_ema, 1) if device.rssi_ema else None,
+            'rssi_ema': round(device.rssi_ema, 1) if device.rssi_ema else None,
-            'type': _classify_device_type(device),
+            'type': _classify_device_type(device),
-            'manufacturer': manufacturer_name,
+            'manufacturer': manufacturer_name,
-            'manufacturer_id': device.manufacturer_id,
+            'manufacturer_id': device.manufacturer_id,
-            'manufacturer_data': device.manufacturer_bytes.hex() if device.manufacturer_bytes else None,
+            'manufacturer_data': device.manufacturer_bytes.hex() if device.manufacturer_bytes else None,
-            'protocol': device.protocol,
+            'protocol': device.protocol,
-            'first_seen': device.first_seen.isoformat(),
+            'first_seen': device.first_seen.isoformat(),
            'last_seen': device.last_seen.isoformat(),
            'seen_count': device.seen_count,
            'range_band': device.range_band,
@@ -1229,38 +1229,38 @@ def get_device_timeseries(device_key: str):
    return jsonify(result)
-def _classify_device_type(device: BTDeviceAggregate) -> str:
+def _classify_device_type(device: BTDeviceAggregate) -> str:
-    """Classify device type from available data."""
+    """Classify device type from available data."""
-    name_lower = (device.name or '').lower()
+    name_lower = (device.name or '').lower()
-    manufacturer_lower = (device.manufacturer_name or '').lower()
+    manufacturer_lower = (device.manufacturer_name or '').lower()
-    service_uuids = device.service_uuids or []
+    service_uuids = device.service_uuids or []
-
+
-    if (not manufacturer_lower) or manufacturer_lower.startswith('unknown'):
+    if (not manufacturer_lower) or manufacturer_lower.startswith('unknown'):
-        if device.address and not device.is_randomized_mac:
+        if device.address and not device.is_randomized_mac:
-            try:
+            try:
-                from data.oui import get_manufacturer
+                from data.oui import get_manufacturer
-                oui_vendor = get_manufacturer(device.address)
+                oui_vendor = get_manufacturer(device.address)
-                if oui_vendor and oui_vendor != 'Unknown':
+                if oui_vendor and oui_vendor != 'Unknown':
-                    manufacturer_lower = oui_vendor.lower()
+                    manufacturer_lower = oui_vendor.lower()
-            except Exception:
+            except Exception:
-                pass
+                pass
-
+
-    def normalize_uuid(uuid: str) -> str:
+    def normalize_uuid(uuid: str) -> str:
-        if not uuid:
+        if not uuid:
-            return ''
+            return ''
-        value = str(uuid).lower().strip()
+        value = str(uuid).lower().strip()
-        if value.startswith('0x'):
+        if value.startswith('0x'):
-            value = value[2:]
+            value = value[2:]
-        # Bluetooth Base UUID normalization (16-bit UUIDs)
+        # Bluetooth Base UUID normalization (16-bit UUIDs)
-        if value.endswith('-0000-1000-8000-00805f9b34fb') and len(value) >= 8:
+        if value.endswith('-0000-1000-8000-00805f9b34fb') and len(value) >= 8:
-            return value[4:8]
+            return value[4:8]
-        if len(value) == 4:
+        if len(value) == 4:
-            return value
+            return value
-        return value
+        return value
-
+
-    # Check by name patterns
+    # Check by name patterns
-    if any(x in name_lower for x in ['airpods', 'headphone', 'earbuds', 'buds', 'beats']):
+    if any(x in name_lower for x in ['airpods', 'headphone', 'earbuds', 'buds', 'beats']):
-        return 'audio'
+        return 'audio'
    if any(x in name_lower for x in ['watch', 'band', 'fitbit', 'garmin']):
        return 'wearable'
    if any(x in name_lower for x in ['iphone', 'pixel', 'galaxy', 'phone']):
@@ -1269,41 +1269,41 @@ def _classify_device_type(device: BTDeviceAggregate) -> str:
        return 'computer'
    if any(x in name_lower for x in ['mouse', 'keyboard', 'trackpad']):
        return 'peripheral'
-    if any(x in name_lower for x in ['tile', 'airtag', 'smarttag', 'chipolo']):
+    if any(x in name_lower for x in ['tile', 'airtag', 'smarttag', 'chipolo']):
-        return 'tracker'
+        return 'tracker'
-    if any(x in name_lower for x in ['speaker', 'sonos', 'echo', 'home']):
+    if any(x in name_lower for x in ['speaker', 'sonos', 'echo', 'home']):
-        return 'speaker'
+        return 'speaker'
-    if any(x in name_lower for x in ['tv', 'chromecast', 'roku', 'firestick']):
+    if any(x in name_lower for x in ['tv', 'chromecast', 'roku', 'firestick']):
-        return 'media'
+        return 'media'
-
+
-    # Tracker signals (metadata or Find My service)
+    # Tracker signals (metadata or Find My service)
-    if getattr(device, 'is_tracker', False) or getattr(device, 'tracker_type', None):
+    if getattr(device, 'is_tracker', False) or getattr(device, 'tracker_type', None):
-        return 'tracker'
+        return 'tracker'
-
+
-    normalized_uuids = {normalize_uuid(u) for u in service_uuids if u}
+    normalized_uuids = {normalize_uuid(u) for u in service_uuids if u}
-    if 'fd6f' in normalized_uuids:
+    if 'fd6f' in normalized_uuids:
-        return 'tracker'
+        return 'tracker'
-
+
-    # Service UUIDs (GATT / classic)
+    # Service UUIDs (GATT / classic)
-    audio_uuids = {'110b', '110a', '111e', '111f', '1108', '1203'}
+    audio_uuids = {'110b', '110a', '111e', '111f', '1108', '1203'}
-    wearable_uuids = {'180d', '1814', '1816'}
+    wearable_uuids = {'180d', '1814', '1816'}
-    hid_uuids = {'1812'}
+    hid_uuids = {'1812'}
-    beacon_uuids = {'feaa', 'feab', 'feb1', 'febe'}
+    beacon_uuids = {'feaa', 'feab', 'feb1', 'febe'}
-
+
-    if normalized_uuids & audio_uuids:
+    if normalized_uuids & audio_uuids:
-        return 'audio'
+        return 'audio'
-    if normalized_uuids & hid_uuids:
+    if normalized_uuids & hid_uuids:
-        return 'peripheral'
+        return 'peripheral'
-    if normalized_uuids & wearable_uuids:
+    if normalized_uuids & wearable_uuids:
-        return 'wearable'
+        return 'wearable'
-    if normalized_uuids & beacon_uuids:
+    if normalized_uuids & beacon_uuids:
-        return 'beacon'
+        return 'beacon'
-
+
-    # Check by manufacturer
+    # Check by manufacturer
-    if 'apple' in manufacturer_lower:
+    if 'apple' in manufacturer_lower:
-        return 'apple_device'
+        return 'apple_device'
-    if 'samsung' in manufacturer_lower:
+    if 'samsung' in manufacturer_lower:
-        return 'samsung_device'
+        return 'samsung_device'
    # Check by class of device
    if device.major_class:
@@ -0,0 +1,314 @@
 """
 BT Locate — Bluetooth SAR Device Location Flask Blueprint.
 Provides endpoints for managing locate sessions, streaming detection events,
 and retrieving GPS-tagged signal trails.
 """
 from __future__ import annotations
 import logging
 from collections.abc import Generator
 from flask import Blueprint, Response, jsonify, request
 from utils.bluetooth.irk_extractor import get_paired_irks
 from utils.bt_locate import (
    Environment,
    LocateTarget,
    get_locate_session,
    resolve_rpa,
    start_locate_session,
    stop_locate_session,
 )
 from utils.sse import format_sse
 logger = logging.getLogger('intercept.bt_locate')
 bt_locate_bp = Blueprint('bt_locate', __name__, url_prefix='/bt_locate')
@bt_locate_bp.route('/start', methods=['POST'])
 def start_session():
    """
    Start a locate session.
    Request JSON:
        - mac_address: Target MAC address (optional)
        - name_pattern: Target name substring (optional)
        - irk_hex: Identity Resolving Key hex string (optional)
        - device_id: Device ID from Bluetooth scanner (optional)
        - device_key: Stable device key from Bluetooth scanner (optional)
        - fingerprint_id: Payload fingerprint ID from Bluetooth scanner (optional)
        - known_name: Hand-off device name (optional)
        - known_manufacturer: Hand-off manufacturer (optional)
        - last_known_rssi: Hand-off last RSSI (optional)
        - environment: 'FREE_SPACE', 'OUTDOOR', 'INDOOR', 'CUSTOM' (default: OUTDOOR)
        - custom_exponent: Path loss exponent for CUSTOM environment (optional)
    Returns:
        JSON with session status.
    """
    data = request.get_json() or {}
    # Build target
    target = LocateTarget(
        mac_address=data.get('mac_address'),
        name_pattern=data.get('name_pattern'),
        irk_hex=data.get('irk_hex'),
        device_id=data.get('device_id'),
        device_key=data.get('device_key'),
        fingerprint_id=data.get('fingerprint_id'),
        known_name=data.get('known_name'),
        known_manufacturer=data.get('known_manufacturer'),
        last_known_rssi=data.get('last_known_rssi'),
    )
    # At least one identifier required
    if not any([
        target.mac_address,
        target.name_pattern,
        target.irk_hex,
        target.device_id,
        target.device_key,
        target.fingerprint_id,
    ]):
        return jsonify({
            'error': (
                'At least one target identifier required '
                '(mac_address, name_pattern, irk_hex, device_id, device_key, or fingerprint_id)'
            )
        }), 400
    # Parse environment
    env_str = data.get('environment', 'OUTDOOR').upper()
    try:
        environment = Environment[env_str]
    except KeyError:
        return jsonify({'error': f'Invalid environment: {env_str}'}), 400
    custom_exponent = data.get('custom_exponent')
    if custom_exponent is not None:
        try:
            custom_exponent = float(custom_exponent)
        except (ValueError, TypeError):
            return jsonify({'error': 'custom_exponent must be a number'}), 400
    # Fallback coordinates when GPS is unavailable (from user settings)
    fallback_lat = None
    fallback_lon = None
    if data.get('fallback_lat') is not None and data.get('fallback_lon') is not None:
        try:
            fallback_lat = float(data['fallback_lat'])
            fallback_lon = float(data['fallback_lon'])
        except (ValueError, TypeError):
            pass
    logger.info(
        f"Starting locate session: target={target.to_dict()}, "
        f"env={environment.name}, fallback=({fallback_lat}, {fallback_lon})"
    )
    try:
        session = start_locate_session(
            target, environment, custom_exponent, fallback_lat, fallback_lon
        )
    except RuntimeError as exc:
        logger.warning(f"Unable to start BT Locate session: {exc}")
        return jsonify({
            'status': 'error',
            'error': 'Bluetooth scanner could not be started. Check adapter permissions/capabilities.',
        }), 503
    except Exception as exc:
        logger.exception(f"Unexpected error starting BT Locate session: {exc}")
        return jsonify({
            'status': 'error',
            'error': 'Failed to start locate session',
        }), 500
    return jsonify({
        'status': 'started',
        'session': session.get_status(),
    })
@bt_locate_bp.route('/stop', methods=['POST'])
 def stop_session():
    """Stop the active locate session."""
    session = get_locate_session()
    if not session:
        return jsonify({'status': 'no_session'})
    stop_locate_session()
    return jsonify({'status': 'stopped'})
@bt_locate_bp.route('/status', methods=['GET'])
 def get_status():
    """Get locate session status."""
    session = get_locate_session()
    if not session:
        return jsonify({
            'active': False,
            'target': None,
        })
    include_debug = str(request.args.get('debug', '')).lower() in ('1', 'true', 'yes')
    return jsonify(session.get_status(include_debug=include_debug))
@bt_locate_bp.route('/trail', methods=['GET'])
 def get_trail():
    """Get detection trail data."""
    session = get_locate_session()
    if not session:
        return jsonify({'trail': [], 'gps_trail': []})
    return jsonify({
        'trail': session.get_trail(),
        'gps_trail': session.get_gps_trail(),
    })
@bt_locate_bp.route('/stream', methods=['GET'])
 def stream_detections():
    """SSE stream of detection events."""
    def event_generator() -> Generator[str, None, None]:
        while True:
            # Re-fetch session each iteration in case it changes
            s = get_locate_session()
            if not s:
                yield format_sse({'type': 'session_ended'}, event='session_ended')
                return
            try:
                event = s.event_queue.get(timeout=2.0)
                yield format_sse(event, event='detection')
            except Exception:
                yield format_sse({}, event='ping')
    return Response(
        event_generator(),
        mimetype='text/event-stream',
        headers={
            'Cache-Control': 'no-cache',
            'Connection': 'keep-alive',
            'X-Accel-Buffering': 'no',
        }
    )
@bt_locate_bp.route('/resolve_rpa', methods=['POST'])
 def test_resolve_rpa():
    """
    Test if an IRK resolves to a given address.
    Request JSON:
        - irk_hex: 16-byte IRK as hex string
        - address: BLE address string
    Returns:
        JSON with resolution result.
    """
    data = request.get_json() or {}
    irk_hex = data.get('irk_hex', '')
    address = data.get('address', '')
    if not irk_hex or not address:
        return jsonify({'error': 'irk_hex and address are required'}), 400
    try:
        irk = bytes.fromhex(irk_hex)
    except ValueError:
        return jsonify({'error': 'Invalid IRK hex string'}), 400
    if len(irk) != 16:
        return jsonify({'error': 'IRK must be exactly 16 bytes (32 hex characters)'}), 400
    result = resolve_rpa(irk, address)
    return jsonify({
        'resolved': result,
        'irk_hex': irk_hex,
        'address': address,
    })
@bt_locate_bp.route('/environment', methods=['POST'])
 def set_environment():
    """Update the environment on the active session."""
    session = get_locate_session()
    if not session:
        return jsonify({'error': 'no active session'}), 400
    data = request.get_json() or {}
    env_str = data.get('environment', '').upper()
    try:
        environment = Environment[env_str]
    except KeyError:
        return jsonify({'error': f'Invalid environment: {env_str}'}), 400
    custom_exponent = data.get('custom_exponent')
    if custom_exponent is not None:
        try:
            custom_exponent = float(custom_exponent)
        except (ValueError, TypeError):
            custom_exponent = None
    session.set_environment(environment, custom_exponent)
    return jsonify({
        'status': 'updated',
        'environment': environment.name,
        'path_loss_exponent': session.estimator.n,
    })
@bt_locate_bp.route('/debug', methods=['GET'])
 def debug_matching():
    """Debug endpoint showing scanner devices and match results."""
    session = get_locate_session()
    if not session:
        return jsonify({'error': 'no session'})
    scanner = session._scanner
    if not scanner:
        return jsonify({'error': 'no scanner'})
    devices = scanner.get_devices(max_age_seconds=30)
    return jsonify({
        'target': session.target.to_dict(),
        'device_count': len(devices),
        'devices': [
            {
                'device_id': d.device_id,
                'address': d.address,
                'name': d.name,
                'rssi': d.rssi_current,
                'matches': session.target.matches(d),
            }
            for d in devices
        ],
    })
@bt_locate_bp.route('/paired_irks', methods=['GET'])
 def paired_irks():
    """Return paired Bluetooth devices that have IRKs."""
    try:
        devices = get_paired_irks()
    except Exception as e:
        logger.exception("Failed to read paired IRKs")
        return jsonify({'devices': [], 'error': str(e)})
    return jsonify({'devices': devices})
@bt_locate_bp.route('/clear_trail', methods=['POST'])
 def clear_trail():
    """Clear the detection trail."""
    session = get_locate_session()
    if not session:
        return jsonify({'status': 'no_session'})
    session.clear_trail()
    return jsonify({'status': 'cleared'})
@@ -13,6 +13,7 @@ from __future__ import annotations
 import json
 import logging
 import queue
 import threading
 import time
 from datetime import datetime, timezone
 from typing import Generator
@@ -36,10 +37,28 @@ from utils.trilateration import (
 logger = logging.getLogger('intercept.controller')
-controller_bp = Blueprint('controller', __name__, url_prefix='/controller')
+controller_bp = Blueprint('controller', __name__, url_prefix='/controller')
-
+
-# Multi-agent data queue for combined SSE stream
+# Multi-agent SSE fanout state (per-client queues).
-agent_data_queue: queue.Queue = queue.Queue(maxsize=1000)
+_agent_stream_subscribers: set[queue.Queue] = set()
 _agent_stream_subscribers_lock = threading.Lock()
 _AGENT_STREAM_CLIENT_QUEUE_SIZE = 500
 def _broadcast_agent_data(payload: dict) -> None:
    """Fan out an ingested payload to all active /controller/stream/all clients."""
    with _agent_stream_subscribers_lock:
        subscribers = tuple(_agent_stream_subscribers)
    for subscriber in subscribers:
        try:
            subscriber.put_nowait(payload)
        except queue.Full:
            try:
                subscriber.get_nowait()
                subscriber.put_nowait(payload)
            except (queue.Empty, queue.Full):
                continue
 # =============================================================================
@@ -625,19 +644,16 @@ def ingest_push_data():
            received_at=data.get('received_at')
        )
-        # Emit to SSE stream
+        # Emit to SSE stream (fanout to all connected clients)
-        try:
+        _broadcast_agent_data({
-            agent_data_queue.put_nowait({
+            'type': 'agent_data',
-                'type': 'agent_data',
+            'agent_id': agent['id'],
-                'agent_id': agent['id'],
+            'agent_name': agent_name,
-                'agent_name': agent_name,
+            'scan_type': data.get('scan_type'),
-                'scan_type': data.get('scan_type'),
+            'interface': data.get('interface'),
-                'interface': data.get('interface'),
+            'payload': data.get('payload'),
-                'payload': data.get('payload'),
+            'received_at': data.get('received_at') or datetime.now(timezone.utc).isoformat()
-                'received_at': data.get('received_at') or datetime.now(timezone.utc).isoformat()
+        })
            })
        except queue.Full:
            logger.warning("Agent data queue full, data may be lost")
        return jsonify({
            'status': 'accepted',
@@ -674,27 +690,35 @@ def get_payloads():
 # =============================================================================
@controller_bp.route('/stream/all')
-def stream_all_agents():
+def stream_all_agents():
    """
    Combined SSE stream for data from all agents.
    This endpoint streams push data as it arrives from agents.
    Each message is tagged with agent_id and agent_name.
    """
-    def generate() -> Generator[str, None, None]:
+    client_queue: queue.Queue = queue.Queue(maxsize=_AGENT_STREAM_CLIENT_QUEUE_SIZE)
-        last_keepalive = time.time()
+    with _agent_stream_subscribers_lock:
-        keepalive_interval = 30.0
+        _agent_stream_subscribers.add(client_queue)
-
+
-        while True:
+    def generate() -> Generator[str, None, None]:
-            try:
+        last_keepalive = time.time()
-                msg = agent_data_queue.get(timeout=1.0)
+        keepalive_interval = 30.0
-                last_keepalive = time.time()
+
-                yield format_sse(msg)
+        try:
-            except queue.Empty:
+            while True:
-                now = time.time()
+                try:
-                if now - last_keepalive >= keepalive_interval:
+                    msg = client_queue.get(timeout=1.0)
-                    yield format_sse({'type': 'keepalive'})
+                    last_keepalive = time.time()
-                    last_keepalive = now
+                    yield format_sse(msg)
                except queue.Empty:
                    now = time.time()
                    if now - last_keepalive >= keepalive_interval:
                        yield format_sse({'type': 'keepalive'})
                        last_keepalive = now
        finally:
            with _agent_stream_subscribers_lock:
                _agent_stream_subscribers.discard(client_queue)
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
@@ -1,758 +0,0 @@
 """DMR / P25 / Digital Voice decoding routes."""
 from __future__ import annotations
 import os
 import queue
 import re
 import select
 import shutil
 import subprocess
 import threading
 import time
 from datetime import datetime
 from typing import Generator, Optional
 from flask import Blueprint, jsonify, request, Response
 import app as app_module
 from utils.logging import get_logger
 from utils.sse import format_sse
 from utils.event_pipeline import process_event
 from utils.process import register_process, unregister_process
 from utils.validation import validate_frequency, validate_gain, validate_device_index, validate_ppm
 from utils.sdr import SDRFactory, SDRType
 from utils.constants import (
    SSE_QUEUE_TIMEOUT,
    SSE_KEEPALIVE_INTERVAL,
    QUEUE_MAX_SIZE,
 )
 logger = get_logger('intercept.dmr')
 dmr_bp = Blueprint('dmr', __name__, url_prefix='/dmr')
 # ============================================
 # GLOBAL STATE
 # ============================================
 dmr_rtl_process: Optional[subprocess.Popen] = None
 dmr_dsd_process: Optional[subprocess.Popen] = None
 dmr_thread: Optional[threading.Thread] = None
 dmr_running = False
 dmr_has_audio = False  # True when ffmpeg available and dsd outputs audio
 dmr_lock = threading.Lock()
 dmr_queue: queue.Queue = queue.Queue(maxsize=QUEUE_MAX_SIZE)
 dmr_active_device: Optional[int] = None
 # Audio mux: the sole reader of dsd-fme stdout.  Fans out bytes to all
 # active ffmpeg stdin sinks when streaming clients are connected.
 # This prevents dsd-fme from blocking on stdout (which would also
 # freeze stderr / text data output).
 _ffmpeg_sinks: set[object] = set()
 _ffmpeg_sinks_lock = threading.Lock()
 VALID_PROTOCOLS = ['auto', 'dmr', 'p25', 'nxdn', 'dstar', 'provoice']
 # Classic dsd flags
 _DSD_PROTOCOL_FLAGS = {
    'auto': [],
    'dmr': ['-fd'],
    'p25': ['-fp'],
    'nxdn': ['-fn'],
    'dstar': ['-fi'],
    'provoice': ['-fv'],
 }
 # dsd-fme remapped several flags from classic DSD:
 #   -fs = DMR Simplex (NOT -fd which is D-STAR!),
 #   -fd = D-STAR (NOT DMR!), -fp = ProVoice (NOT P25),
 #   -fi = NXDN48 (NOT D-Star), -f1 = P25 Phase 1,
 #   -ft = XDMA multi-protocol decoder
 _DSD_FME_PROTOCOL_FLAGS = {
    'auto': ['-fa'],       # Broad auto: P25 (P1/P2), DMR, D-STAR, YSF, X2-TDMA
    'dmr': ['-fs'],        # DMR Simplex (-fd is D-STAR in dsd-fme!)
    'p25': ['-ft'],        # P25 P1/P2 coverage (also includes DMR in dsd-fme)
    'nxdn': ['-fn'],       # NXDN96
    'dstar': ['-fd'],      # D-STAR (-fd in dsd-fme, NOT DMR!)
    'provoice': ['-fp'],   # ProVoice (-fp in dsd-fme, not -fv)
 }
 # Modulation hints: force C4FM for protocols that use it, improving
 # sync reliability vs letting dsd-fme auto-detect modulation type.
 _DSD_FME_MODULATION = {
    'dmr': ['-mc'],        # C4FM
    'nxdn': ['-mc'],       # C4FM
 }
 # ============================================
 # HELPERS
 # ============================================
 def find_dsd() -> tuple[str | None, bool]:
    """Find DSD (Digital Speech Decoder) binary.
    Checks for dsd-fme first (common fork), then falls back to dsd.
    Returns (path, is_fme) tuple.
    """
    path = shutil.which('dsd-fme')
    if path:
        return path, True
    path = shutil.which('dsd')
    if path:
        return path, False
    return None, False
 def find_rtl_fm() -> str | None:
    """Find rtl_fm binary."""
    return shutil.which('rtl_fm')
 def find_rx_fm() -> str | None:
    """Find SoapySDR rx_fm binary."""
    return shutil.which('rx_fm')
 def find_ffmpeg() -> str | None:
    """Find ffmpeg for audio encoding."""
    return shutil.which('ffmpeg')
 def parse_dsd_output(line: str) -> dict | None:
    """Parse a line of DSD stderr output into a structured event.
    Handles output from both classic ``dsd`` and ``dsd-fme`` which use
    different formatting for talkgroup / source / voice frame lines.
    """
    line = line.strip()
    if not line:
        return None
    # Skip DSD/dsd-fme startup banner lines (ASCII art, version info, etc.)
    # Only filter lines that are purely decorative — dsd-fme uses box-drawing
    # characters (│, ─) as column separators in DATA lines, so we must not
    # discard lines that also contain alphanumeric content.
    stripped_of_box = re.sub(r'[╔╗╚╝║═██▀▄╗╝╩╦╠╣╬│┤├┘└┐┌─┼█▓▒░\s]', '', line)
    if not stripped_of_box:
        return None
    if re.match(r'^\s*(Build Version|MBElib|CODEC2|Audio (Out|In)|Decoding )', line):
        return None
    ts = datetime.now().strftime('%H:%M:%S')
    # Sync detection: "Sync: +DMR (data)" or "Sync: +P25 Phase 1"
    sync_match = re.match(r'Sync:\s*\+?(\S+.*)', line)
    if sync_match:
        return {
            'type': 'sync',
            'protocol': sync_match.group(1).strip(),
            'timestamp': ts,
        }
    # Talkgroup and Source — check BEFORE slot so "Slot 1 Voice LC, TG: …"
    # is captured as a call event rather than a bare slot event.
    # Classic dsd:   "TG: 12345  Src: 67890"
    # dsd-fme:       "TG: 12345, Src: 67890"  or  "Talkgroup: 12345, Source: 67890"
    #                "TGT: 12345 | SRC: 67890" (pipe-delimited variant)
    tg_match = re.search(
        r'(?:TGT?|Talkgroup)[:\s]+(\d+)[,|│\s]+(?:Src|Source|SRC)[:\s]+(\d+)', line, re.IGNORECASE
    )
    if tg_match:
        result = {
            'type': 'call',
            'talkgroup': int(tg_match.group(1)),
            'source_id': int(tg_match.group(2)),
            'timestamp': ts,
        }
        # Extract slot if present on the same line
        slot_inline = re.search(r'Slot\s*(\d+)', line)
        if slot_inline:
            result['slot'] = int(slot_inline.group(1))
        return result
    # P25 NAC (Network Access Code) — check before voice/slot
    nac_match = re.search(r'NAC[:\s]+([0-9A-Fa-f]+)', line)
    if nac_match:
        return {
            'type': 'nac',
            'nac': nac_match.group(1),
            'timestamp': ts,
        }
    # Voice frame detection — check BEFORE bare slot match
    # Classic dsd: "Voice" keyword in frame lines
    # dsd-fme: "voice" or "Voice LC" or "VOICE" in output
    if re.search(r'\bvoice\b', line, re.IGNORECASE):
        result = {
            'type': 'voice',
            'detail': line,
            'timestamp': ts,
        }
        slot_inline = re.search(r'Slot\s*(\d+)', line)
        if slot_inline:
            result['slot'] = int(slot_inline.group(1))
        return result
    # Bare slot info (only when line is *just* slot info, not voice/call)
    slot_match = re.match(r'\s*Slot\s*(\d+)\s*$', line)
    if slot_match:
        return {
            'type': 'slot',
            'slot': int(slot_match.group(1)),
            'timestamp': ts,
        }
    # dsd-fme status lines we can surface: "TDMA", "CACH", "PI", "BS", etc.
    # Also catches "Closing", "Input", and other lifecycle lines.
    # Forward as raw so the frontend can show decoder is alive.
    return {
        'type': 'raw',
        'text': line[:200],
        'timestamp': ts,
    }
 _HEARTBEAT_INTERVAL = 3.0  # seconds between heartbeats when decoder is idle
 # 100ms of silence at 8kHz 16-bit mono = 1600 bytes
 _SILENCE_CHUNK = b'\x00' * 1600
 def _register_audio_sink(sink: object) -> None:
    """Register an ffmpeg stdin sink for mux fanout."""
    with _ffmpeg_sinks_lock:
        _ffmpeg_sinks.add(sink)
 def _unregister_audio_sink(sink: object) -> None:
    """Remove an ffmpeg stdin sink from mux fanout."""
    with _ffmpeg_sinks_lock:
        _ffmpeg_sinks.discard(sink)
 def _get_audio_sinks() -> tuple[object, ...]:
    """Snapshot current audio sinks for lock-free iteration."""
    with _ffmpeg_sinks_lock:
        return tuple(_ffmpeg_sinks)
 def _stop_process(proc: Optional[subprocess.Popen]) -> None:
    """Terminate and unregister a subprocess if present."""
    if not proc:
        return
    if proc.poll() is None:
        try:
            proc.terminate()
            proc.wait(timeout=2)
        except Exception:
            try:
                proc.kill()
            except Exception:
                pass
    unregister_process(proc)
 def _reset_runtime_state(*, release_device: bool) -> None:
    """Reset process + runtime state and optionally release SDR ownership."""
    global dmr_rtl_process, dmr_dsd_process
    global dmr_running, dmr_has_audio, dmr_active_device
    _stop_process(dmr_dsd_process)
    _stop_process(dmr_rtl_process)
    dmr_rtl_process = None
    dmr_dsd_process = None
    dmr_running = False
    dmr_has_audio = False
    with _ffmpeg_sinks_lock:
        _ffmpeg_sinks.clear()
    if release_device and dmr_active_device is not None:
        app_module.release_sdr_device(dmr_active_device)
        dmr_active_device = None
 def _dsd_audio_mux(dsd_stdout):
    """Mux thread: sole reader of dsd-fme stdout.
    Always drains dsd-fme's audio output to prevent the process from
    blocking on stdout writes (which would also freeze stderr / text
    data). When streaming clients are connected, forwards data to all
    active ffmpeg stdin sinks with silence fill during voice gaps.
    """
    try:
        while dmr_running:
            ready, _, _ = select.select([dsd_stdout], [], [], 0.1)
            if ready:
                data = os.read(dsd_stdout.fileno(), 4096)
                if not data:
                    break
                sinks = _get_audio_sinks()
                for sink in sinks:
                    try:
                        sink.write(data)
                        sink.flush()
                    except (BrokenPipeError, OSError, ValueError):
                        _unregister_audio_sink(sink)
            else:
                # No audio from decoder — feed silence if client connected
                sinks = _get_audio_sinks()
                for sink in sinks:
                    try:
                        sink.write(_SILENCE_CHUNK)
                        sink.flush()
                    except (BrokenPipeError, OSError, ValueError):
                        _unregister_audio_sink(sink)
    except (OSError, ValueError):
        pass
 def _queue_put(event: dict):
    """Put an event on the DMR queue, dropping oldest if full."""
    try:
        dmr_queue.put_nowait(event)
    except queue.Full:
        try:
            dmr_queue.get_nowait()
        except queue.Empty:
            pass
        try:
            dmr_queue.put_nowait(event)
        except queue.Full:
            pass
 def stream_dsd_output(rtl_process: subprocess.Popen, dsd_process: subprocess.Popen):
    """Read DSD stderr output and push parsed events to the queue.
    Uses select() with a timeout so we can send periodic heartbeat
    events while readline() would otherwise block indefinitely during
    silence (no signal being decoded).
    """
    global dmr_running
    try:
        _queue_put({'type': 'status', 'text': 'started'})
        last_heartbeat = time.time()
        while dmr_running:
            if dsd_process.poll() is not None:
                break
            # Wait up to 1s for data on stderr instead of blocking forever
            ready, _, _ = select.select([dsd_process.stderr], [], [], 1.0)
            if ready:
                line = dsd_process.stderr.readline()
                if not line:
                    if dsd_process.poll() is not None:
                        break
                    continue
                text = line.decode('utf-8', errors='replace').strip()
                if not text:
                    continue
                logger.debug("DSD raw: %s", text)
                parsed = parse_dsd_output(text)
                if parsed:
                    _queue_put(parsed)
                last_heartbeat = time.time()
            else:
                # No stderr output — send heartbeat so frontend knows
                # decoder is still alive and listening
                now = time.time()
                if now - last_heartbeat >= _HEARTBEAT_INTERVAL:
                    _queue_put({
                        'type': 'heartbeat',
                        'timestamp': datetime.now().strftime('%H:%M:%S'),
                    })
                    last_heartbeat = now
    except Exception as e:
        logger.error(f"DSD stream error: {e}")
    finally:
        global dmr_active_device, dmr_rtl_process, dmr_dsd_process
        global dmr_has_audio
        dmr_running = False
        dmr_has_audio = False
        with _ffmpeg_sinks_lock:
            _ffmpeg_sinks.clear()
        # Capture exit info for diagnostics
        rc = dsd_process.poll()
        reason = 'stopped'
        detail = ''
        if rc is not None and rc != 0:
            reason = 'crashed'
            try:
                remaining = dsd_process.stderr.read(1024)
                if remaining:
                    detail = remaining.decode('utf-8', errors='replace').strip()[:200]
            except Exception:
                pass
            logger.warning(f"DSD process exited with code {rc}: {detail}")
        # Cleanup decoder + demod processes
        _stop_process(dsd_process)
        _stop_process(rtl_process)
        dmr_rtl_process = None
        dmr_dsd_process = None
        _queue_put({'type': 'status', 'text': reason, 'exit_code': rc, 'detail': detail})
        # Release SDR device
        if dmr_active_device is not None:
            app_module.release_sdr_device(dmr_active_device)
            dmr_active_device = None
        logger.info("DSD stream thread stopped")
 # ============================================
 # API ENDPOINTS
 # ============================================
@dmr_bp.route('/tools')
 def check_tools() -> Response:
    """Check for required tools."""
    dsd_path, _ = find_dsd()
    rtl_fm = find_rtl_fm()
    rx_fm = find_rx_fm()
    ffmpeg = find_ffmpeg()
    return jsonify({
        'dsd': dsd_path is not None,
        'rtl_fm': rtl_fm is not None,
        'rx_fm': rx_fm is not None,
        'ffmpeg': ffmpeg is not None,
        'available': dsd_path is not None and (rtl_fm is not None or rx_fm is not None),
        'protocols': VALID_PROTOCOLS,
    })
@dmr_bp.route('/start', methods=['POST'])
 def start_dmr() -> Response:
    """Start digital voice decoding."""
    global dmr_rtl_process, dmr_dsd_process, dmr_thread
    global dmr_running, dmr_has_audio, dmr_active_device
    dsd_path, is_fme = find_dsd()
    if not dsd_path:
        return jsonify({'status': 'error', 'message': 'dsd not found. Install dsd-fme or dsd.'}), 503
    data = request.json or {}
    try:
        frequency = validate_frequency(data.get('frequency', 462.5625))
        gain = int(validate_gain(data.get('gain', 40)))
        device = validate_device_index(data.get('device', 0))
        protocol = str(data.get('protocol', 'auto')).lower()
        ppm = validate_ppm(data.get('ppm', 0))
    except (ValueError, TypeError) as e:
        return jsonify({'status': 'error', 'message': f'Invalid parameter: {e}'}), 400
    sdr_type_str = str(data.get('sdr_type', 'rtlsdr')).lower()
    try:
        sdr_type = SDRType(sdr_type_str)
    except ValueError:
        sdr_type = SDRType.RTL_SDR
    if protocol not in VALID_PROTOCOLS:
        return jsonify({'status': 'error', 'message': f'Invalid protocol. Use: {", ".join(VALID_PROTOCOLS)}'}), 400
    if sdr_type == SDRType.RTL_SDR:
        if not find_rtl_fm():
            return jsonify({'status': 'error', 'message': 'rtl_fm not found. Install rtl-sdr tools.'}), 503
    else:
        if not find_rx_fm():
            return jsonify({
                'status': 'error',
                'message': f'rx_fm not found. Install SoapySDR tools for {sdr_type.value}.'
            }), 503
    # Clear stale queue
    try:
        while True:
            dmr_queue.get_nowait()
    except queue.Empty:
        pass
    # Reserve running state before we start claiming resources/processes
    # so concurrent /start requests cannot race each other.
    with dmr_lock:
        if dmr_running:
            return jsonify({'status': 'error', 'message': 'Already running'}), 409
        dmr_running = True
        dmr_has_audio = False
    # Claim SDR device — use protocol name so the device panel shows
    # "D-STAR", "P25", etc. instead of always "DMR"
    mode_label = protocol.upper() if protocol != 'auto' else 'DMR'
    error = app_module.claim_sdr_device(device, mode_label)
    if error:
        with dmr_lock:
            dmr_running = False
        return jsonify({'status': 'error', 'error_type': 'DEVICE_BUSY', 'message': error}), 409
    dmr_active_device = device
    # Build FM demodulation command via SDR abstraction.
    try:
        sdr_device = SDRFactory.create_default_device(sdr_type, index=device)
        builder = SDRFactory.get_builder(sdr_type)
        rtl_cmd = builder.build_fm_demod_command(
            device=sdr_device,
            frequency_mhz=frequency,
            sample_rate=48000,
            gain=float(gain) if gain > 0 else None,
            ppm=int(ppm) if ppm != 0 else None,
            modulation='fm',
            squelch=None,
            bias_t=bool(data.get('bias_t', False)),
        )
        if sdr_type == SDRType.RTL_SDR:
            # Keep squelch fully open for digital bitstreams.
            rtl_cmd.extend(['-l', '0'])
    except Exception as e:
        _reset_runtime_state(release_device=True)
        return jsonify({'status': 'error', 'message': f'Failed to build SDR command: {e}'}), 500
    # Build DSD command
    # Audio output: pipe decoded audio (8kHz s16le PCM) to stdout for
    # ffmpeg transcoding.  Both dsd-fme and classic dsd support '-o -'.
    # If ffmpeg is unavailable, fall back to discarding audio.
    ffmpeg_path = find_ffmpeg()
    if ffmpeg_path:
        audio_out = '-'
    else:
        audio_out = 'null' if is_fme else '-'
        logger.warning("ffmpeg not found — audio streaming disabled, data-only mode")
    dsd_cmd = [dsd_path, '-i', '-', '-o', audio_out]
    if is_fme:
        dsd_cmd.extend(_DSD_FME_PROTOCOL_FLAGS.get(protocol, []))
        dsd_cmd.extend(_DSD_FME_MODULATION.get(protocol, []))
        # Event log to stderr so we capture TG/Source/Voice data that
        # dsd-fme may not output on stderr by default.
        dsd_cmd.extend(['-J', '/dev/stderr'])
        # Relax CRC checks for marginal signals — lets more frames
        # through at the cost of occasional decode errors.
        if data.get('relaxCrc', False):
            dsd_cmd.append('-F')
    else:
        dsd_cmd.extend(_DSD_PROTOCOL_FLAGS.get(protocol, []))
    try:
        dmr_rtl_process = subprocess.Popen(
            rtl_cmd,
            stdout=subprocess.PIPE,
            stderr=subprocess.PIPE,
        )
        register_process(dmr_rtl_process)
        # DSD stdout → PIPE when ffmpeg available (audio pipeline),
        # otherwise DEVNULL (data-only mode)
        dsd_stdout = subprocess.PIPE if ffmpeg_path else subprocess.DEVNULL
        dmr_dsd_process = subprocess.Popen(
            dsd_cmd,
            stdin=dmr_rtl_process.stdout,
            stdout=dsd_stdout,
            stderr=subprocess.PIPE,
        )
        register_process(dmr_dsd_process)
        # Allow rtl_fm to send directly to dsd
        dmr_rtl_process.stdout.close()
        # Start mux thread: always drains dsd-fme stdout to prevent the
        # process from blocking (which would freeze stderr / text data).
        # ffmpeg is started lazily per-client in /dmr/audio/stream.
        if ffmpeg_path and dmr_dsd_process.stdout:
            dmr_has_audio = True
            threading.Thread(
                target=_dsd_audio_mux,
                args=(dmr_dsd_process.stdout,),
                daemon=True,
            ).start()
        time.sleep(0.3)
        rtl_rc = dmr_rtl_process.poll()
        dsd_rc = dmr_dsd_process.poll()
        if rtl_rc is not None or dsd_rc is not None:
            # Process died — capture stderr for diagnostics
            rtl_err = ''
            if dmr_rtl_process.stderr:
                rtl_err = dmr_rtl_process.stderr.read().decode('utf-8', errors='replace')[:500]
            dsd_err = ''
            if dmr_dsd_process.stderr:
                dsd_err = dmr_dsd_process.stderr.read().decode('utf-8', errors='replace')[:500]
            logger.error(f"DSD pipeline died: rtl_fm rc={rtl_rc} err={rtl_err!r}, dsd rc={dsd_rc} err={dsd_err!r}")
            # Terminate surviving processes and release resources.
            _reset_runtime_state(release_device=True)
            # Surface a clear error to the user
            detail = rtl_err.strip() or dsd_err.strip()
            if 'usb_claim_interface' in rtl_err or 'Failed to open' in rtl_err:
                msg = f'SDR device {device} is busy — it may be in use by another mode or process. Try a different device.'
            elif detail:
                msg = f'Failed to start DSD pipeline: {detail}'
            else:
                msg = 'Failed to start DSD pipeline'
            return jsonify({'status': 'error', 'message': msg}), 500
        # Drain rtl_fm stderr in background to prevent pipe blocking
        def _drain_rtl_stderr(proc):
            try:
                for line in proc.stderr:
                    pass
            except Exception:
                pass
        threading.Thread(target=_drain_rtl_stderr, args=(dmr_rtl_process,), daemon=True).start()
        dmr_thread = threading.Thread(
            target=stream_dsd_output,
            args=(dmr_rtl_process, dmr_dsd_process),
            daemon=True,
        )
        dmr_thread.start()
        return jsonify({
            'status': 'started',
            'frequency': frequency,
            'protocol': protocol,
            'sdr_type': sdr_type.value,
            'has_audio': dmr_has_audio,
        })
    except Exception as e:
        logger.error(f"Failed to start DMR: {e}")
        _reset_runtime_state(release_device=True)
        return jsonify({'status': 'error', 'message': str(e)}), 500
@dmr_bp.route('/stop', methods=['POST'])
 def stop_dmr() -> Response:
    """Stop digital voice decoding."""
    with dmr_lock:
        _reset_runtime_state(release_device=True)
    return jsonify({'status': 'stopped'})
@dmr_bp.route('/status')
 def dmr_status() -> Response:
    """Get DMR decoder status."""
    return jsonify({
        'running': dmr_running,
        'device': dmr_active_device,
        'has_audio': dmr_has_audio,
    })
@dmr_bp.route('/audio/stream')
 def stream_dmr_audio() -> Response:
    """Stream decoded digital voice audio as WAV.
    Starts a per-client ffmpeg encoder.  The global mux thread
    (_dsd_audio_mux) forwards DSD audio to this ffmpeg's stdin while
    the client is connected, and discards audio otherwise.  This avoids
    the pipe-buffer deadlock that occurs when ffmpeg is started at
    decoder launch (its stdout fills up before any HTTP client reads
    it, back-pressuring the entire pipeline and freezing stderr/text
    data output).
    """
    if not dmr_running or not dmr_has_audio:
        return Response(b'', mimetype='audio/wav', status=204)
    ffmpeg_path = find_ffmpeg()
    if not ffmpeg_path:
        return Response(b'', mimetype='audio/wav', status=503)
    encoder_cmd = [
        ffmpeg_path, '-hide_banner', '-loglevel', 'error',
        '-fflags', 'nobuffer', '-flags', 'low_delay',
        '-probesize', '32', '-analyzeduration', '0',
        '-f', 's16le', '-ar', '8000', '-ac', '1', '-i', 'pipe:0',
        '-acodec', 'pcm_s16le', '-ar', '44100', '-f', 'wav', 'pipe:1',
    ]
    audio_proc = subprocess.Popen(
        encoder_cmd,
        stdin=subprocess.PIPE,
        stdout=subprocess.PIPE,
        stderr=subprocess.PIPE,
    )
    # Drain ffmpeg stderr to prevent blocking
    threading.Thread(
        target=lambda p: [None for _ in p.stderr],
        args=(audio_proc,), daemon=True,
    ).start()
    if audio_proc.stdin:
        _register_audio_sink(audio_proc.stdin)
    def generate():
        try:
            while dmr_running and audio_proc.poll() is None:
                ready, _, _ = select.select([audio_proc.stdout], [], [], 2.0)
                if ready:
                    chunk = audio_proc.stdout.read(4096)
                    if chunk:
                        yield chunk
                    else:
                        break
                else:
                    if audio_proc.poll() is not None:
                        break
        except GeneratorExit:
            pass
        except Exception as e:
            logger.error(f"DMR audio stream error: {e}")
        finally:
            # Disconnect mux → ffmpeg, then clean up
            if audio_proc.stdin:
                _unregister_audio_sink(audio_proc.stdin)
            try:
                audio_proc.stdin.close()
            except Exception:
                pass
            try:
                audio_proc.terminate()
                audio_proc.wait(timeout=2)
            except Exception:
                try:
                    audio_proc.kill()
                except Exception:
                    pass
    return Response(
        generate(),
        mimetype='audio/wav',
        headers={
            'Content-Type': 'audio/wav',
            'Cache-Control': 'no-cache, no-store',
            'X-Accel-Buffering': 'no',
            'Transfer-Encoding': 'chunked',
        },
    )
@dmr_bp.route('/stream')
 def stream_dmr() -> Response:
    """SSE stream for DMR decoder events."""
    def generate() -> Generator[str, None, None]:
        last_keepalive = time.time()
        while True:
            try:
                msg = dmr_queue.get(timeout=SSE_QUEUE_TIMEOUT)
                last_keepalive = time.time()
                try:
                    process_event('dmr', msg, msg.get('type'))
                except Exception:
                    pass
                yield format_sse(msg)
            except queue.Empty:
                now = time.time()
                if now - last_keepalive >= SSE_KEEPALIVE_INTERVAL:
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    return response
@@ -35,7 +35,7 @@ from utils.database import (
    get_dsc_alert_summary,
 )
 from utils.dsc.parser import parse_dsc_message
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.validation import validate_device_index, validate_gain
 from utils.sdr import SDRFactory, SDRType
@@ -518,26 +518,19 @@ def stop_decoding() -> Response:
@dsc_bp.route('/stream')
 def stream() -> Response:
    """SSE stream for real-time DSC messages."""
-    def generate() -> Generator[str, None, None]:
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('dsc', msg, msg.get('type'))
        keepalive_interval = 30.0
-        while True:
+    response = Response(
-            try:
+        sse_stream_fanout(
-                msg = app_module.dsc_queue.get(timeout=1)
+            source_queue=app_module.dsc_queue,
-                last_keepalive = time.time()
+            channel_key='dsc',
-                try:
+            timeout=1.0,
-                    process_event('dsc', msg, msg.get('type'))
+            keepalive_interval=30.0,
-                except Exception:
+            on_message=_on_msg,
-                    pass
+        ),
-                yield format_sse(msg)
+        mimetype='text/event-stream',
-            except queue.Empty:
+    )
                now = time.time()
                if now - last_keepalive >= keepalive_interval:
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
@@ -4,19 +4,24 @@ from __future__ import annotations
 import queue
 import time
-from typing import Generator
+from collections.abc import Generator
-from flask import Blueprint, jsonify, request, Response
+from flask import Blueprint, Response, jsonify
 from utils.logging import get_logger
 from utils.sse import format_sse
 from utils.gps import (
    get_gps_reader,
    start_gpsd,
    stop_gps,
    get_current_position,
    GPSPosition,
    GPSSkyData,
    detect_gps_devices,
    get_current_position,
    get_gps_reader,
    is_gpsd_running,
    start_gpsd,
    start_gpsd_daemon,
    stop_gps,
    stop_gpsd_daemon,
 )
 from utils.logging import get_logger
 from utils.sse import sse_stream_fanout
 logger = get_logger('intercept.gps')
@@ -29,12 +34,24 @@ _gps_queue: queue.Queue = queue.Queue(maxsize=100)
 def _position_callback(position: GPSPosition) -> None:
    """Callback to queue position updates for SSE stream."""
    try:
-        _gps_queue.put_nowait(position.to_dict())
+        _gps_queue.put_nowait({'type': 'position', **position.to_dict()})
    except queue.Full:
        # Discard oldest if queue is full
        try:
            _gps_queue.get_nowait()
-            _gps_queue.put_nowait(position.to_dict())
+            _gps_queue.put_nowait({'type': 'position', **position.to_dict()})
        except queue.Empty:
            pass
 def _sky_callback(sky: GPSSkyData) -> None:
    """Callback to queue sky data updates for SSE stream."""
    try:
        _gps_queue.put_nowait({'type': 'sky', **sky.to_dict()})
    except queue.Full:
        try:
            _gps_queue.get_nowait()
            _gps_queue.put_nowait({'type': 'sky', **sky.to_dict()})
        except queue.Empty:
            pass
@@ -45,36 +62,44 @@ def auto_connect_gps():
    Automatically connect to gpsd if available.
    Called on page load to seamlessly enable GPS if gpsd is running.
    If gpsd is not running, attempts to detect GPS devices and start gpsd.
    Returns current status if already connected.
    """
    import socket
    # Check if already running
    reader = get_gps_reader()
    if reader and reader.is_running:
        position = reader.position
        sky = reader.sky
        return jsonify({
            'status': 'connected',
            'source': 'gpsd',
            'has_fix': position is not None,
-            'position': position.to_dict() if position else None
+            'position': position.to_dict() if position else None,
            'sky': sky.to_dict() if sky else None,
        })
    # Try to connect to gpsd on localhost:2947
    host = 'localhost'
    port = 2947
-    # First check if gpsd is reachable
+    # If gpsd isn't running, try to detect a device and start it
-    try:
+    if not is_gpsd_running(host, port):
-        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        devices = detect_gps_devices()
-        sock.settimeout(1.0)
+        if not devices:
-        sock.connect((host, port))
+            return jsonify({
-        sock.close()
+                'status': 'unavailable',
-    except Exception:
+                'message': 'No GPS device detected'
-        return jsonify({
+            })
-            'status': 'unavailable',
+
-            'message': 'gpsd not running'
+        # Try to start gpsd with the first detected device
-        })
+        device_path = devices[0]['path']
        success, msg = start_gpsd_daemon(device_path, host, port)
        if not success:
            return jsonify({
                'status': 'unavailable',
                'message': msg,
                'devices': devices,
            })
        logger.info(f"Auto-started gpsd on {device_path}")
    # Clear the queue
    while not _gps_queue.empty():
@@ -84,14 +109,17 @@ def auto_connect_gps():
            break
    # Start the gpsd client
-    success = start_gpsd(host, port, callback=_position_callback)
+    success = start_gpsd(host, port,
                         callback=_position_callback,
                         sky_callback=_sky_callback)
    if success:
        return jsonify({
            'status': 'connected',
            'source': 'gpsd',
            'has_fix': False,
-            'position': None
+            'position': None,
            'sky': None,
        })
    else:
        return jsonify({
@@ -100,14 +128,26 @@ def auto_connect_gps():
        })
@gps_bp.route('/devices')
 def list_gps_devices():
    """List detected GPS serial devices."""
    devices = detect_gps_devices()
    return jsonify({
        'devices': devices,
        'gpsd_running': is_gpsd_running(),
    })
@gps_bp.route('/stop', methods=['POST'])
 def stop_gps_reader():
-    """Stop GPS client."""
+    """Stop GPS client and gpsd daemon if we started it."""
    reader = get_gps_reader()
    if reader:
        reader.remove_callback(_position_callback)
        reader.remove_sky_callback(_sky_callback)
    stop_gps()
    stop_gpsd_daemon()
    return jsonify({'status': 'stopped'})
@@ -122,15 +162,18 @@ def get_gps_status():
            'running': False,
            'device': None,
            'position': None,
            'sky': None,
            'error': None,
            'message': 'GPS client not started'
        })
    position = reader.position
    sky = reader.sky
    return jsonify({
        'running': reader.is_running,
        'device': reader.device_path,
        'position': position.to_dict() if position else None,
        'sky': sky.to_dict() if sky else None,
        'last_update': reader.last_update.isoformat() if reader.last_update else None,
        'error': reader.error,
        'message': 'Waiting for GPS fix - ensure GPS has clear view of sky' if reader.is_running and not position else None
@@ -161,26 +204,43 @@ def get_position():
            })
-@gps_bp.route('/stream')
+@gps_bp.route('/satellites')
-def stream_gps():
+def get_satellites():
-    """SSE stream of GPS position updates."""
+    """Get current satellite sky view data."""
-    def generate() -> Generator[str, None, None]:
+    reader = get_gps_reader()
        last_keepalive = time.time()
        keepalive_interval = 30.0
-        while True:
+    if not reader or not reader.is_running:
-            try:
+        return jsonify({
-                position = _gps_queue.get(timeout=1)
+            'status': 'error',
-                last_keepalive = time.time()
+            'message': 'GPS client not running'
-                yield format_sse({'type': 'position', **position})
+        }), 400
            except queue.Empty:
                now = time.time()
                if now - last_keepalive >= keepalive_interval:
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
-    response = Response(generate(), mimetype='text/event-stream')
+    sky = reader.sky
-    response.headers['Cache-Control'] = 'no-cache'
+    if sky:
-    response.headers['X-Accel-Buffering'] = 'no'
+        return jsonify({
-    response.headers['Connection'] = 'keep-alive'
+            'status': 'ok',
            'sky': sky.to_dict()
        })
    else:
        return jsonify({
            'status': 'waiting',
            'message': 'Waiting for satellite data'
        })
@gps_bp.route('/stream')
 def stream_gps():
    """SSE stream of GPS position and sky updates."""
    response = Response(
        sse_stream_fanout(
            source_queue=_gps_queue,
            channel_key='gps',
            timeout=1.0,
            keepalive_interval=30.0,
        ),
        mimetype='text/event-stream',
    )
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
    return response
@@ -17,7 +17,7 @@ from typing import Generator
 from flask import Blueprint, jsonify, request, Response
 from utils.logging import get_logger
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
 from utils.meshtastic import (
    get_meshtastic_client,
    start_meshtastic,
@@ -453,8 +453,8 @@ def get_messages():
    })
-@meshtastic_bp.route('/stream')
+@meshtastic_bp.route('/stream')
-def stream_messages():
+def stream_messages():
    """
    SSE stream of Meshtastic messages.
@@ -469,25 +469,18 @@ def stream_messages():
    Returns:
        SSE stream (text/event-stream)
    """
-    def generate() -> Generator[str, None, None]:
+    response = Response(
-        last_keepalive = time.time()
+        sse_stream_fanout(
-        keepalive_interval = 30.0
+            source_queue=_mesh_queue,
-
+            channel_key='meshtastic',
-        while True:
+            timeout=1.0,
-            try:
+            keepalive_interval=30.0,
-                msg = _mesh_queue.get(timeout=1)
+        ),
-                last_keepalive = time.time()
+        mimetype='text/event-stream',
-                yield format_sse(msg)
+    )
-            except queue.Empty:
+    response.headers['Cache-Control'] = 'no-cache'
-                now = time.time()
+    response.headers['X-Accel-Buffering'] = 'no'
-                if now - last_keepalive >= keepalive_interval:
+    response.headers['Connection'] = 'keep-alive'
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
    return response
@@ -1051,3 +1044,19 @@ def request_store_forward():
            'status': 'error',
            'message': error or 'Failed to request S&F history'
        }), 500
@meshtastic_bp.route('/topology')
 def mesh_topology():
    """Return mesh network topology graph."""
    if not is_meshtastic_available():
        return jsonify({'status': 'error', 'message': 'Meshtastic SDK not installed'}), 400
    client = get_meshtastic_client()
    if not client or not client.is_running:
        return jsonify({'status': 'error', 'message': 'Not connected'}), 400
    return jsonify({
        'status': 'success',
        'topology': client.get_topology(),
    })
@@ -9,13 +9,14 @@ import os
 offline_bp = Blueprint('offline', __name__, url_prefix='/offline')
 # Default offline settings
-OFFLINE_DEFAULTS = {
+OFFLINE_DEFAULTS = {
-    'offline.enabled': False,
+    'offline.enabled': False,
-    'offline.assets_source': 'cdn',
+    # Default to bundled assets/fonts to avoid third-party CDN privacy blocks.
-    'offline.fonts_source': 'cdn',
+    'offline.assets_source': 'local',
-    'offline.tile_provider': 'cartodb_dark_cyan',
+    'offline.fonts_source': 'local',
-    'offline.tile_server_url': ''
+    'offline.tile_provider': 'cartodb_dark_cyan',
-}
+    'offline.tile_server_url': ''
 }
 # Asset paths to check
 ASSET_PATHS = {
@@ -24,7 +24,7 @@ from utils.validation import (
    validate_frequency, validate_device_index, validate_gain, validate_ppm,
    validate_rtl_tcp_host, validate_rtl_tcp_port
 )
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.process import safe_terminate, register_process, unregister_process
 from utils.sdr import SDRFactory, SDRType, SDRValidationError
@@ -96,7 +96,7 @@ def parse_multimon_output(line: str) -> dict[str, str] | None:
    return None
-def log_message(msg: dict[str, Any]) -> None:
+def log_message(msg: dict[str, Any]) -> None:
    """Log a message to file if logging is enabled."""
    if not app_module.logging_enabled:
        return
@@ -104,25 +104,39 @@ def log_message(msg: dict[str, Any]) -> None:
        with open(app_module.log_file_path, 'a') as f:
            timestamp = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
            f.write(f"{timestamp} | {msg.get('protocol', 'UNKNOWN')} | {msg.get('address', '')} | {msg.get('message', '')}\n")
-    except Exception as e:
+    except Exception as e:
-        logger.error(f"Failed to log message: {e}")
+        logger.error(f"Failed to log message: {e}")
-
+
-
+
-def audio_relay_thread(
+def _encode_scope_waveform(samples: tuple[int, ...], window_size: int = 256) -> list[int]:
-    rtl_stdout,
+    """Compress recent PCM samples into a signed 8-bit waveform for SSE."""
-    multimon_stdin,
+    if not samples:
-    output_queue: queue.Queue,
+        return []
-    stop_event: threading.Event,
+
-) -> None:
+    window = samples[-window_size:] if len(samples) > window_size else samples
-    """Relay audio from rtl_fm to multimon-ng while computing signal levels.
+    waveform: list[int] = []
-
+    for sample in window:
-    Reads raw 16-bit LE PCM from *rtl_stdout*, writes every chunk straight
+        # Convert int16 PCM to int8 range for lightweight transport.
-    through to *multimon_stdin*, and every ~100 ms pushes an RMS / peak scope
+        packed = int(round(sample / 256))
-    event onto *output_queue*.
+        waveform.append(max(-127, min(127, packed)))
-    """
+    return waveform
-    CHUNK = 4096  # bytes – 2048 samples at 16-bit mono
+
-    INTERVAL = 0.1  # seconds between scope updates
+
-    last_scope = time.monotonic()
+def audio_relay_thread(
    rtl_stdout,
    multimon_stdin,
    output_queue: queue.Queue,
    stop_event: threading.Event,
 ) -> None:
    """Relay audio from rtl_fm to multimon-ng while computing signal levels.
    Reads raw 16-bit LE PCM from *rtl_stdout*, writes every chunk straight
    through to *multimon_stdin*, and every ~100 ms pushes an RMS / peak scope
    event plus a compact waveform sample onto *output_queue*.
    """
    CHUNK = 4096  # bytes – 2048 samples at 16-bit mono
    INTERVAL = 0.1  # seconds between scope updates
    last_scope = time.monotonic()
    try:
        while not stop_event.is_set():
@@ -146,15 +160,16 @@ def audio_relay_thread(
                    if n_samples == 0:
                        continue
                    samples = struct.unpack(f'<{n_samples}h', data[:n_samples * 2])
-                    peak = max(abs(s) for s in samples)
+                    peak = max(abs(s) for s in samples)
-                    rms = int(math.sqrt(sum(s * s for s in samples) / n_samples))
+                    rms = int(math.sqrt(sum(s * s for s in samples) / n_samples))
-                    output_queue.put_nowait({
+                    output_queue.put_nowait({
-                        'type': 'scope',
+                        'type': 'scope',
-                        'rms': rms,
+                        'rms': rms,
-                        'peak': peak,
+                        'peak': peak,
-                    })
+                        'waveform': _encode_scope_waveform(samples),
-                except (struct.error, ValueError, queue.Full):
+                    })
-                    pass
+                except (struct.error, ValueError, queue.Full):
                    pass
    except Exception as e:
        logger.debug(f"Audio relay error: {e}")
    finally:
@@ -538,31 +553,22 @@ def toggle_logging() -> Response:
    return jsonify({'logging': app_module.logging_enabled, 'log_file': app_module.log_file_path})
-@pager_bp.route('/stream')
+@pager_bp.route('/stream')
-def stream() -> Response:
+def stream() -> Response:
-    import json
+    def _on_msg(msg: dict[str, Any]) -> None:
-
+        process_event('pager', msg, msg.get('type'))
-    def generate() -> Generator[str, None, None]:
+
-        last_keepalive = time.time()
+    response = Response(
-        keepalive_interval = 30.0  # Send keepalive every 30 seconds instead of 1 second
+        sse_stream_fanout(
-
+            source_queue=app_module.output_queue,
-        while True:
+            channel_key='pager',
-            try:
+            timeout=1.0,
-                msg = app_module.output_queue.get(timeout=1)
+            keepalive_interval=30.0,
-                last_keepalive = time.time()
+            on_message=_on_msg,
-                try:
+        ),
-                    process_event('pager', msg, msg.get('type'))
+        mimetype='text/event-stream',
-                except Exception:
+    )
-                    pass
+    response.headers['Cache-Control'] = 'no-cache'
-                yield format_sse(msg)
+    response.headers['X-Accel-Buffering'] = 'no'
-            except queue.Empty:
+    response.headers['Connection'] = 'keep-alive'
-                now = time.time()
+    return response
                if now - last_keepalive >= keepalive_interval:
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
    return response
@@ -2,6 +2,7 @@
 from __future__ import annotations
 import json
 from pathlib import Path
 from flask import Blueprint, jsonify, request, send_file
@@ -107,3 +108,59 @@ def download_recording(session_id: str):
        as_attachment=True,
        download_name=file_path.name,
    )
@recordings_bp.route('/<session_id>/events', methods=['GET'])
 def get_recording_events(session_id: str):
    """Return parsed events from a recording for in-app replay."""
    manager = get_recording_manager()
    rec = manager.get_recording(session_id)
    if not rec:
        return jsonify({'status': 'error', 'message': 'Recording not found'}), 404
    file_path = Path(rec['file_path'])
    try:
        resolved_root = RECORDING_ROOT.resolve()
        resolved_file = file_path.resolve()
        if resolved_root not in resolved_file.parents:
            return jsonify({'status': 'error', 'message': 'Invalid recording path'}), 400
    except Exception:
        return jsonify({'status': 'error', 'message': 'Invalid recording path'}), 400
    if not file_path.exists():
        return jsonify({'status': 'error', 'message': 'Recording file missing'}), 404
    limit = max(1, min(5000, request.args.get('limit', default=500, type=int)))
    offset = max(0, request.args.get('offset', default=0, type=int))
    events: list[dict] = []
    seen = 0
    with file_path.open('r', encoding='utf-8', errors='replace') as fh:
        for idx, line in enumerate(fh):
            if idx < offset:
                continue
            if seen >= limit:
                break
            line = line.strip()
            if not line:
                continue
            try:
                events.append(json.loads(line))
                seen += 1
            except json.JSONDecodeError:
                continue
    return jsonify({
        'status': 'success',
        'recording': {
            'id': rec['id'],
            'mode': rec['mode'],
            'started_at': rec['started_at'],
            'stopped_at': rec['stopped_at'],
            'event_count': rec['event_count'],
        },
        'offset': offset,
        'limit': limit,
        'returned': len(events),
        'events': events,
    })
@@ -17,7 +17,7 @@ from utils.logging import sensor_logger as logger
 from utils.validation import (
    validate_frequency, validate_device_index, validate_gain, validate_ppm
 )
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.process import safe_terminate, register_process, unregister_process
@@ -288,26 +288,19 @@ def stop_rtlamr() -> Response:
@rtlamr_bp.route('/stream_rtlamr')
 def stream_rtlamr() -> Response:
-    def generate() -> Generator[str, None, None]:
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('rtlamr', msg, msg.get('type'))
        keepalive_interval = 30.0
-        while True:
+    response = Response(
-            try:
+        sse_stream_fanout(
-                msg = app_module.rtlamr_queue.get(timeout=1)
+            source_queue=app_module.rtlamr_queue,
-                last_keepalive = time.time()
+            channel_key='rtlamr',
-                try:
+            timeout=1.0,
-                    process_event('rtlamr', msg, msg.get('type'))
+            keepalive_interval=30.0,
-                except Exception:
+            on_message=_on_msg,
-                    pass
+        ),
-                yield format_sse(msg)
+        mimetype='text/event-stream',
-            except queue.Empty:
+    )
                now = time.time()
                if now - last_keepalive >= keepalive_interval:
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
@@ -16,6 +16,13 @@ from flask import Blueprint, jsonify, request, render_template, Response
 from config import SHARED_OBSERVER_LOCATION_ENABLED
 from data.satellites import TLE_SATELLITES
 from utils.database import (
    get_tracked_satellites,
    add_tracked_satellite,
    bulk_add_tracked_satellites,
    update_tracked_satellite,
    remove_tracked_satellite,
 )
 from utils.logging import satellite_logger as logger
 from utils.validation import validate_latitude, validate_longitude, validate_hours, validate_elevation
@@ -31,18 +38,38 @@ ALLOWED_TLE_HOSTS = ['celestrak.org', 'celestrak.com', 'www.celestrak.org', 'www
 _tle_cache = dict(TLE_SATELLITES)
 def _load_db_satellites_into_cache():
    """Load user-tracked satellites from DB into the TLE cache."""
    global _tle_cache
    try:
        db_sats = get_tracked_satellites()
        loaded = 0
        for sat in db_sats:
            if sat['tle_line1'] and sat['tle_line2']:
                # Use a cache key derived from name (sanitised)
                cache_key = sat['name'].replace(' ', '-').upper()
                if cache_key not in _tle_cache:
                    _tle_cache[cache_key] = (sat['name'], sat['tle_line1'], sat['tle_line2'])
                    loaded += 1
        if loaded:
            logger.info(f"Loaded {loaded} user-tracked satellites into TLE cache")
    except Exception as e:
        logger.warning(f"Failed to load DB satellites into TLE cache: {e}")
 def init_tle_auto_refresh():
    """Initialize TLE auto-refresh. Called by app.py after initialization."""
    import threading
-    
+
    def _auto_refresh_tle():
        try:
            _load_db_satellites_into_cache()
            updated = refresh_tle_data()
            if updated:
                logger.info(f"Auto-refreshed TLE data for: {', '.join(updated)}")
        except Exception as e:
            logger.warning(f"Auto TLE refresh failed: {e}")
-    
+
    # Start auto-refresh in background
    threading.Timer(2.0, _auto_refresh_tle).start()
    logger.info("TLE auto-refresh scheduled")
@@ -139,9 +166,11 @@ def _fetch_iss_realtime(observer_lat: Optional[float] = None, observer_lon: Opti
@satellite_bp.route('/dashboard')
 def satellite_dashboard():
    """Popout satellite tracking dashboard."""
    embedded = request.args.get('embedded', 'false') == 'true'
    return render_template(
        'satellite_dashboard.html',
        shared_observer_location=SHARED_OBSERVER_LOCATION_ENABLED,
        embedded=embedded,
    )
@@ -168,13 +197,13 @@ def predict_passes():
    except ValueError as e:
        return jsonify({'status': 'error', 'message': str(e)}), 400
-    norad_to_name = {
+    norad_to_name = {
-        25544: 'ISS',
+        25544: 'ISS',
-        40069: 'METEOR-M2',
+        40069: 'METEOR-M2',
-        57166: 'METEOR-M2-3'
+        57166: 'METEOR-M2-3'
-    }
+    }
-
+
-    sat_input = data.get('satellites', ['ISS', 'METEOR-M2', 'METEOR-M2-3'])
+    sat_input = data.get('satellites', ['ISS', 'METEOR-M2', 'METEOR-M2-3'])
    satellites = []
    for sat in sat_input:
        if isinstance(sat, int) and sat in norad_to_name:
@@ -183,11 +212,11 @@ def predict_passes():
            satellites.append(sat)
    passes = []
-    colors = {
+    colors = {
-        'ISS': '#00ffff',
+        'ISS': '#00ffff',
-        'METEOR-M2': '#9370DB',
+        'METEOR-M2': '#9370DB',
-        'METEOR-M2-3': '#ff00ff'
+        'METEOR-M2-3': '#ff00ff'
-    }
+    }
    name_to_norad = {v: k for k, v in norad_to_name.items()}
    ts = load.timescale()
@@ -319,11 +348,11 @@ def get_satellite_position():
    sat_input = data.get('satellites', [])
    include_track = bool(data.get('includeTrack', True))
-    norad_to_name = {
+    norad_to_name = {
-        25544: 'ISS',
+        25544: 'ISS',
-        40069: 'METEOR-M2',
+        40069: 'METEOR-M2',
-        57166: 'METEOR-M2-3'
+        57166: 'METEOR-M2-3'
-    }
+    }
    satellites = []
    for sat in sat_input:
@@ -543,3 +572,102 @@ def fetch_celestrak(category):
    except Exception as e:
        logger.error(f"Error fetching CelesTrak data: {e}")
        return jsonify({'status': 'error', 'message': 'Failed to fetch satellite data'})
 # =============================================================================
 # Tracked Satellites CRUD
 # =============================================================================
@satellite_bp.route('/tracked', methods=['GET'])
 def list_tracked_satellites():
    """Return all tracked satellites from the database."""
    enabled_only = request.args.get('enabled', '').lower() == 'true'
    sats = get_tracked_satellites(enabled_only=enabled_only)
    return jsonify({'status': 'success', 'satellites': sats})
@satellite_bp.route('/tracked', methods=['POST'])
 def add_tracked_satellites_endpoint():
    """Add one or more tracked satellites."""
    global _tle_cache
    data = request.get_json(silent=True)
    if not data:
        return jsonify({'status': 'error', 'message': 'No data provided'}), 400
    # Accept a single satellite dict or a list
    sat_list = data if isinstance(data, list) else [data]
    normalized: list[dict] = []
    for sat in sat_list:
        norad_id = str(sat.get('norad_id', sat.get('norad', '')))
        name = sat.get('name', '')
        if not norad_id or not name:
            continue
        tle1 = sat.get('tle_line1', sat.get('tle1'))
        tle2 = sat.get('tle_line2', sat.get('tle2'))
        enabled = sat.get('enabled', True)
        normalized.append({
            'norad_id': norad_id,
            'name': name,
            'tle_line1': tle1,
            'tle_line2': tle2,
            'enabled': bool(enabled),
            'builtin': False,
        })
        # Also inject into TLE cache if we have TLE data
        if tle1 and tle2:
            cache_key = name.replace(' ', '-').upper()
            _tle_cache[cache_key] = (name, tle1, tle2)
    # Single inserts preserve previous behavior; list inserts use DB-level bulk path.
    if len(normalized) == 1:
        sat = normalized[0]
        added = 1 if add_tracked_satellite(
            sat['norad_id'],
            sat['name'],
            sat.get('tle_line1'),
            sat.get('tle_line2'),
            sat.get('enabled', True),
            sat.get('builtin', False),
        ) else 0
    else:
        added = bulk_add_tracked_satellites(normalized)
    response_payload = {
        'status': 'success',
        'added': added,
        'processed': len(normalized),
    }
    # Returning all tracked satellites for very large imports can stall the UI.
    include_satellites = request.args.get('include_satellites', '').lower() == 'true'
    if include_satellites or len(normalized) <= 32:
        response_payload['satellites'] = get_tracked_satellites()
    return jsonify(response_payload)
@satellite_bp.route('/tracked/<norad_id>', methods=['PUT'])
 def update_tracked_satellite_endpoint(norad_id):
    """Update the enabled state of a tracked satellite."""
    data = request.json or {}
    enabled = data.get('enabled')
    if enabled is None:
        return jsonify({'status': 'error', 'message': 'Missing enabled field'}), 400
    ok = update_tracked_satellite(str(norad_id), bool(enabled))
    if ok:
        return jsonify({'status': 'success'})
    return jsonify({'status': 'error', 'message': 'Satellite not found'}), 404
@satellite_bp.route('/tracked/<norad_id>', methods=['DELETE'])
 def delete_tracked_satellite_endpoint(norad_id):
    """Remove a tracked satellite by NORAD ID."""
    ok, msg = remove_tracked_satellite(str(norad_id))
    if ok:
        return jsonify({'status': 'success', 'message': msg})
    status_code = 403 if 'builtin' in msg.lower() else 404
    return jsonify({'status': 'error', 'message': msg}), status_code
@@ -1,14 +1,15 @@
 """RTL_433 sensor monitoring routes."""
-from __future__ import annotations
+from __future__ import annotations
-
+
-import json
+import json
-import queue
+import math
-import subprocess
+import queue
-import threading
+import subprocess
-import time
+import threading
-from datetime import datetime
+import time
-from typing import Generator
+from datetime import datetime
 from typing import Any, Generator
 from flask import Blueprint, jsonify, request, Response
@@ -18,7 +19,7 @@ from utils.validation import (
    validate_frequency, validate_device_index, validate_gain, validate_ppm,
    validate_rtl_tcp_host, validate_rtl_tcp_port
 )
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.process import safe_terminate, register_process, unregister_process
 from utils.sdr import SDRFactory, SDRType
@@ -28,8 +29,42 @@ sensor_bp = Blueprint('sensor', __name__)
 # Track which device is being used
 sensor_active_device: int | None = None
-
+# RSSI history per device (model_id -> list of (timestamp, rssi))
-def stream_sensor_output(process: subprocess.Popen[bytes]) -> None:
+sensor_rssi_history: dict[str, list[tuple[float, float]]] = {}
 _MAX_RSSI_HISTORY = 60
 def _build_scope_waveform(rssi: float, snr: float, noise: float, points: int = 256) -> list[int]:
    """Synthesize a compact waveform from rtl_433 level metrics."""
    points = max(32, min(points, 512))
    # rssi is usually negative; stronger signals are closer to 0 dBm.
    rssi_norm = min(max(abs(rssi) / 40.0, 0.0), 1.0)
    snr_norm = min(max((snr + 5.0) / 35.0, 0.0), 1.0)
    noise_norm = min(max(abs(noise) / 40.0, 0.0), 1.0)
    amplitude = max(0.06, min(1.0, (0.6 * rssi_norm + 0.4 * snr_norm) - (0.22 * noise_norm)))
    cycles = 3.0 + (snr_norm * 8.0)
    harmonic = 0.25 + (0.35 * snr_norm)
    hiss = 0.08 + (0.18 * noise_norm)
    phase = (time.monotonic() * (1.4 + (snr_norm * 2.2))) % (2.0 * math.pi)
    waveform: list[int] = []
    for i in range(points):
        t = i / (points - 1)
        base = math.sin((2.0 * math.pi * cycles * t) + phase)
        overtone = math.sin((2.0 * math.pi * (cycles * 2.4) * t) + (phase * 0.7))
        noise_wobble = math.sin((2.0 * math.pi * (cycles * 7.0) * t) + (phase * 2.1))
        sample = amplitude * (base + (harmonic * overtone) + (hiss * noise_wobble))
        sample /= (1.0 + harmonic + hiss)
        packed = int(round(max(-1.0, min(1.0, sample)) * 127.0))
        waveform.append(max(-127, min(127, packed)))
    return waveform
 def stream_sensor_output(process: subprocess.Popen[bytes]) -> None:
    """Stream rtl_433 JSON output to queue."""
    try:
        app_module.sensor_queue.put({'type': 'status', 'text': 'started'})
@@ -45,20 +80,39 @@ def stream_sensor_output(process: subprocess.Popen[bytes]) -> None:
                data['type'] = 'sensor'
                app_module.sensor_queue.put(data)
                # Track RSSI history per device
                _model = data.get('model', '')
                _dev_id = data.get('id', '')
                _rssi_val = data.get('rssi')
                if _rssi_val is not None and _model:
                    _hist_key = f"{_model}_{_dev_id}"
                    hist = sensor_rssi_history.setdefault(_hist_key, [])
                    hist.append((time.time(), float(_rssi_val)))
                    if len(hist) > _MAX_RSSI_HISTORY:
                        del hist[: len(hist) - _MAX_RSSI_HISTORY]
                # Push scope event when signal level data is present
                rssi = data.get('rssi')
                snr = data.get('snr')
                noise = data.get('noise')
-                if rssi is not None or snr is not None:
+                if rssi is not None or snr is not None:
-                    try:
+                    try:
-                        app_module.sensor_queue.put_nowait({
+                        rssi_value = float(rssi) if rssi is not None else 0.0
-                            'type': 'scope',
+                        snr_value = float(snr) if snr is not None else 0.0
-                            'rssi': rssi if rssi is not None else 0,
+                        noise_value = float(noise) if noise is not None else 0.0
-                            'snr': snr if snr is not None else 0,
+                        app_module.sensor_queue.put_nowait({
-                            'noise': noise if noise is not None else 0,
+                            'type': 'scope',
-                        })
+                            'rssi': rssi_value,
-                    except queue.Full:
+                            'snr': snr_value,
-                        pass
+                            'noise': noise_value,
                            'waveform': _build_scope_waveform(
                                rssi=rssi_value,
                                snr=snr_value,
                                noise=noise_value,
                            ),
                        })
                    except (TypeError, ValueError, queue.Full):
                        pass
                # Log if enabled
                if app_module.logging_enabled:
@@ -199,10 +253,16 @@ def start_sensor() -> Response:
            thread.start()
            # Monitor stderr
            # Filter noisy rtl_433 diagnostics that aren't useful to display
            _stderr_noise = (
                'bitbuffer_add_bit',
                'row count limit',
            )
            def monitor_stderr():
                for line in app_module.sensor_process.stderr:
                    err = line.decode('utf-8', errors='replace').strip()
-                    if err:
+                    if err and not any(noise in err for noise in _stderr_noise):
                        logger.debug(f"[rtl_433] {err}")
                        app_module.sensor_queue.put({'type': 'info', 'text': f'[rtl_433] {err}'})
@@ -251,29 +311,31 @@ def stop_sensor() -> Response:
        return jsonify({'status': 'not_running'})
-@sensor_bp.route('/stream_sensor')
+@sensor_bp.route('/stream_sensor')
-def stream_sensor() -> Response:
+def stream_sensor() -> Response:
-    def generate() -> Generator[str, None, None]:
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('sensor', msg, msg.get('type'))
-        keepalive_interval = 30.0
+
    response = Response(
        sse_stream_fanout(
            source_queue=app_module.sensor_queue,
            channel_key='sensor',
            timeout=1.0,
            keepalive_interval=30.0,
            on_message=_on_msg,
        ),
        mimetype='text/event-stream',
    )
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
    return response
        while True:
            try:
                msg = app_module.sensor_queue.get(timeout=1)
                last_keepalive = time.time()
                try:
                    process_event('sensor', msg, msg.get('type'))
                except Exception:
                    pass
                yield format_sse(msg)
            except queue.Empty:
                now = time.time()
                if now - last_keepalive >= keepalive_interval:
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
-    response = Response(generate(), mimetype='text/event-stream')
+@sensor_bp.route('/sensor/rssi_history')
-    response.headers['Cache-Control'] = 'no-cache'
+def get_rssi_history() -> Response:
-    response.headers['X-Accel-Buffering'] = 'no'
+    """Return RSSI history for all tracked sensor devices."""
-    response.headers['Connection'] = 'keep-alive'
+    result = {}
-    return response
+    for key, entries in sensor_rssi_history.items():
        result[key] = [{'t': round(t, 1), 'rssi': rssi} for t, rssi in entries]
    return jsonify({'status': 'success', 'devices': result})
@@ -0,0 +1,352 @@
 """Signal identification enrichment routes (SigID Wiki proxy lookup)."""
 from __future__ import annotations
 import json
 import time
 import urllib.parse
 import urllib.request
 from typing import Any
 from flask import Blueprint, Response, jsonify, request
 from utils.logging import get_logger
 logger = get_logger('intercept.signalid')
 signalid_bp = Blueprint('signalid', __name__, url_prefix='/signalid')
 SIGID_API_URL = 'https://www.sigidwiki.com/api.php'
 SIGID_USER_AGENT = 'INTERCEPT-SignalID/1.0'
 SIGID_TIMEOUT_SECONDS = 12
 SIGID_CACHE_TTL_SECONDS = 600
 _cache: dict[str, dict[str, Any]] = {}
 def _cache_get(key: str) -> Any | None:
    entry = _cache.get(key)
    if not entry:
        return None
    if time.time() >= entry['expires']:
        _cache.pop(key, None)
        return None
    return entry['data']
 def _cache_set(key: str, data: Any, ttl_seconds: int = SIGID_CACHE_TTL_SECONDS) -> None:
    _cache[key] = {
        'data': data,
        'expires': time.time() + ttl_seconds,
    }
 def _fetch_api_json(params: dict[str, str]) -> dict[str, Any] | None:
    query = urllib.parse.urlencode(params, doseq=True)
    url = f'{SIGID_API_URL}?{query}'
    req = urllib.request.Request(url, headers={'User-Agent': SIGID_USER_AGENT})
    try:
        with urllib.request.urlopen(req, timeout=SIGID_TIMEOUT_SECONDS) as resp:
            payload = resp.read().decode('utf-8', errors='replace')
        data = json.loads(payload)
    except Exception as exc:
        logger.warning('SigID API request failed: %s', exc)
        return None
    if isinstance(data, dict) and data.get('error'):
        logger.warning('SigID API returned error: %s', data.get('error'))
        return None
    return data if isinstance(data, dict) else None
 def _ask_query(query: str) -> dict[str, Any] | None:
    return _fetch_api_json({
        'action': 'ask',
        'query': query,
        'format': 'json',
    })
 def _search_query(search_text: str, limit: int) -> dict[str, Any] | None:
    return _fetch_api_json({
        'action': 'query',
        'list': 'search',
        'srsearch': search_text,
        'srlimit': str(limit),
        'format': 'json',
    })
 def _to_float_list(values: Any) -> list[float]:
    if not isinstance(values, list):
        return []
    out: list[float] = []
    for value in values:
        try:
            out.append(float(value))
        except (TypeError, ValueError):
            continue
    return out
 def _to_text_list(values: Any) -> list[str]:
    if not isinstance(values, list):
        return []
    out: list[str] = []
    for value in values:
        text = str(value or '').strip()
        if text:
            out.append(text)
    return out
 def _normalize_modes(values: list[str]) -> list[str]:
    out: list[str] = []
    for value in values:
        for token in str(value).replace('/', ',').split(','):
            mode = token.strip().upper()
            if mode and mode not in out:
                out.append(mode)
    return out
 def _extract_matches_from_ask(data: dict[str, Any]) -> list[dict[str, Any]]:
    results = data.get('query', {}).get('results', {})
    if not isinstance(results, dict):
        return []
    matches: list[dict[str, Any]] = []
    for title, entry in results.items():
        if not isinstance(entry, dict):
            continue
        printouts = entry.get('printouts', {})
        if not isinstance(printouts, dict):
            printouts = {}
        frequencies_hz = _to_float_list(printouts.get('Frequencies'))
        frequencies_mhz = [round(v / 1e6, 6) for v in frequencies_hz if v > 0]
        modes = _normalize_modes(_to_text_list(printouts.get('Mode')))
        modulations = _normalize_modes(_to_text_list(printouts.get('Modulation')))
        match = {
            'title': str(entry.get('fulltext') or title),
            'url': str(entry.get('fullurl') or ''),
            'frequencies_mhz': frequencies_mhz,
            'modes': modes,
            'modulations': modulations,
            'source': 'SigID Wiki',
        }
        matches.append(match)
    return matches
 def _dedupe_matches(matches: list[dict[str, Any]]) -> list[dict[str, Any]]:
    deduped: dict[str, dict[str, Any]] = {}
    for match in matches:
        key = f"{match.get('title', '')}|{match.get('url', '')}"
        if key not in deduped:
            deduped[key] = match
            continue
        # Merge frequencies/modes/modulations from duplicates.
        existing = deduped[key]
        for field in ('frequencies_mhz', 'modes', 'modulations'):
            base = existing.get(field, [])
            extra = match.get(field, [])
            if not isinstance(base, list):
                base = []
            if not isinstance(extra, list):
                extra = []
            merged = list(base)
            for item in extra:
                if item not in merged:
                    merged.append(item)
            existing[field] = merged
    return list(deduped.values())
 def _rank_matches(
    matches: list[dict[str, Any]],
    *,
    frequency_mhz: float,
    modulation: str,
 ) -> list[dict[str, Any]]:
    target_hz = frequency_mhz * 1e6
    wanted_mod = str(modulation or '').strip().upper()
    def score(match: dict[str, Any]) -> tuple[int, float, str]:
        score_value = 0
        freqs_mhz = match.get('frequencies_mhz') or []
        distances_hz: list[float] = []
        for f_mhz in freqs_mhz:
            try:
                distances_hz.append(abs((float(f_mhz) * 1e6) - target_hz))
            except (TypeError, ValueError):
                continue
        min_distance_hz = min(distances_hz) if distances_hz else 1e12
        if min_distance_hz <= 100:
            score_value += 120
        elif min_distance_hz <= 1_000:
            score_value += 90
        elif min_distance_hz <= 10_000:
            score_value += 70
        elif min_distance_hz <= 100_000:
            score_value += 40
        if wanted_mod:
            modes = [str(v).upper() for v in (match.get('modes') or [])]
            modulations = [str(v).upper() for v in (match.get('modulations') or [])]
            if wanted_mod in modes:
                score_value += 25
            if wanted_mod in modulations:
                score_value += 25
        title = str(match.get('title') or '')
        title_lower = title.lower()
        if 'unidentified' in title_lower or 'unknown' in title_lower:
            score_value -= 10
        return (score_value, min_distance_hz, title.lower())
    ranked = sorted(matches, key=score, reverse=True)
    for match in ranked:
        try:
            nearest = min(abs((float(f) * 1e6) - target_hz) for f in (match.get('frequencies_mhz') or []))
            match['distance_hz'] = int(round(nearest))
        except Exception:
            match['distance_hz'] = None
    return ranked
 def _format_freq_variants_mhz(freq_mhz: float) -> list[str]:
    variants = [
        f'{freq_mhz:.6f}'.rstrip('0').rstrip('.'),
        f'{freq_mhz:.4f}'.rstrip('0').rstrip('.'),
        f'{freq_mhz:.3f}'.rstrip('0').rstrip('.'),
    ]
    out: list[str] = []
    for value in variants:
        if value and value not in out:
            out.append(value)
    return out
 def _lookup_sigidwiki_matches(frequency_mhz: float, modulation: str, limit: int) -> dict[str, Any]:
    all_matches: list[dict[str, Any]] = []
    exact_queries: list[str] = []
    for freq_token in _format_freq_variants_mhz(frequency_mhz):
        query = (
            f'[[Category:Signal]][[Frequencies::{freq_token} MHz]]'
            f'|?Frequencies|?Mode|?Modulation|limit={max(10, limit * 2)}'
        )
        exact_queries.append(query)
        data = _ask_query(query)
        if data:
            all_matches.extend(_extract_matches_from_ask(data))
        if all_matches:
            break
    search_used = False
    if not all_matches:
        search_used = True
        search_terms = [f'{frequency_mhz:.4f} MHz']
        if modulation:
            search_terms.insert(0, f'{frequency_mhz:.4f} MHz {modulation.upper()}')
        seen_titles: set[str] = set()
        for term in search_terms:
            search_data = _search_query(term, max(5, min(limit * 2, 10)))
            search_results = search_data.get('query', {}).get('search', []) if isinstance(search_data, dict) else []
            if not isinstance(search_results, list) or not search_results:
                continue
            for item in search_results:
                title = str(item.get('title') or '').strip()
                if not title or title in seen_titles:
                    continue
                seen_titles.add(title)
                page_query = f'[[{title}]]|?Frequencies|?Mode|?Modulation|limit=1'
                page_data = _ask_query(page_query)
                if page_data:
                    all_matches.extend(_extract_matches_from_ask(page_data))
                if len(all_matches) >= max(limit * 3, 12):
                    break
            if all_matches:
                break
    deduped = _dedupe_matches(all_matches)
    ranked = _rank_matches(deduped, frequency_mhz=frequency_mhz, modulation=modulation)
    return {
        'matches': ranked[:limit],
        'search_used': search_used,
        'exact_queries': exact_queries,
    }
@signalid_bp.route('/sigidwiki', methods=['POST'])
 def sigidwiki_lookup() -> Response:
    """Lookup likely signal types from SigID Wiki by tuned frequency."""
    payload = request.get_json(silent=True) or {}
    freq_raw = payload.get('frequency_mhz')
    if freq_raw is None:
        return jsonify({'status': 'error', 'message': 'frequency_mhz is required'}), 400
    try:
        frequency_mhz = float(freq_raw)
    except (TypeError, ValueError):
        return jsonify({'status': 'error', 'message': 'Invalid frequency_mhz'}), 400
    if frequency_mhz <= 0:
        return jsonify({'status': 'error', 'message': 'frequency_mhz must be positive'}), 400
    modulation = str(payload.get('modulation') or '').strip().upper()
    if modulation and len(modulation) > 16:
        modulation = modulation[:16]
    limit_raw = payload.get('limit', 8)
    try:
        limit = int(limit_raw)
    except (TypeError, ValueError):
        limit = 8
    limit = max(1, min(limit, 20))
    cache_key = f'{round(frequency_mhz, 6)}|{modulation}|{limit}'
    cached = _cache_get(cache_key)
    if cached is not None:
        return jsonify({
            'status': 'ok',
            'source': 'sigidwiki',
            'frequency_mhz': round(frequency_mhz, 6),
            'modulation': modulation or None,
            'cached': True,
            **cached,
        })
    try:
        lookup = _lookup_sigidwiki_matches(frequency_mhz, modulation, limit)
    except Exception as exc:
        logger.error('SigID lookup failed: %s', exc)
        return jsonify({'status': 'error', 'message': 'SigID lookup failed'}), 502
    response_payload = {
        'matches': lookup.get('matches', []),
        'match_count': len(lookup.get('matches', [])),
        'search_used': bool(lookup.get('search_used')),
        'exact_queries': lookup.get('exact_queries', []),
    }
    _cache_set(cache_key, response_payload)
    return jsonify({
        'status': 'ok',
        'source': 'sigidwiki',
        'frequency_mhz': round(frequency_mhz, 6),
        'modulation': modulation or None,
        'cached': False,
        **response_payload,
    })
@@ -0,0 +1,300 @@
 """Space Weather routes - proxies NOAA SWPC, NASA SDO, and HamQSL data."""
 from __future__ import annotations
 import json
 import time
 import urllib.error
 import urllib.request
 import xml.etree.ElementTree as ET
 from typing import Any
 from flask import Blueprint, Response, jsonify
 from utils.logging import get_logger
 logger = get_logger('intercept.space_weather')
 space_weather_bp = Blueprint('space_weather', __name__, url_prefix='/space-weather')
 # ---------------------------------------------------------------------------
 # TTL Cache
 # ---------------------------------------------------------------------------
 _cache: dict[str, dict[str, Any]] = {}
 # Cache TTLs in seconds
 TTL_REALTIME = 300       # 5 min for real-time data
 TTL_FORECAST = 1800      # 30 min for forecasts
 TTL_DAILY = 3600         # 1 hr for daily summaries
 TTL_IMAGE = 600          # 10 min for images
 def _cache_get(key: str) -> Any | None:
    entry = _cache.get(key)
    if entry and time.time() < entry['expires']:
        return entry['data']
    return None
 def _cache_set(key: str, data: Any, ttl: int) -> None:
    _cache[key] = {'data': data, 'expires': time.time() + ttl}
 # ---------------------------------------------------------------------------
 # HTTP helpers
 # ---------------------------------------------------------------------------
 _TIMEOUT = 15  # seconds
 SWPC_BASE = 'https://services.swpc.noaa.gov'
 SWPC_JSON = f'{SWPC_BASE}/products'
 def _fetch_json(url: str, timeout: int = _TIMEOUT) -> Any | None:
    try:
        req = urllib.request.Request(url, headers={'User-Agent': 'INTERCEPT/1.0'})
        with urllib.request.urlopen(req, timeout=timeout) as resp:
            return json.loads(resp.read().decode())
    except Exception as exc:
        logger.warning('Failed to fetch %s: %s', url, exc)
        return None
 def _fetch_text(url: str, timeout: int = _TIMEOUT) -> str | None:
    try:
        req = urllib.request.Request(url, headers={'User-Agent': 'INTERCEPT/1.0'})
        with urllib.request.urlopen(req, timeout=timeout) as resp:
            return resp.read().decode()
    except Exception as exc:
        logger.warning('Failed to fetch %s: %s', url, exc)
        return None
 def _fetch_bytes(url: str, timeout: int = _TIMEOUT) -> bytes | None:
    try:
        req = urllib.request.Request(url, headers={'User-Agent': 'INTERCEPT/1.0'})
        with urllib.request.urlopen(req, timeout=timeout) as resp:
            return resp.read()
    except Exception as exc:
        logger.warning('Failed to fetch %s: %s', url, exc)
        return None
 # ---------------------------------------------------------------------------
 # Data source fetchers
 # ---------------------------------------------------------------------------
 def _fetch_cached_json(cache_key: str, url: str, ttl: int) -> Any | None:
    cached = _cache_get(cache_key)
    if cached is not None:
        return cached
    data = _fetch_json(url)
    if data is not None:
        _cache_set(cache_key, data, ttl)
    return data
 def _fetch_kp_index() -> Any | None:
    return _fetch_cached_json('kp_index', f'{SWPC_JSON}/noaa-planetary-k-index.json', TTL_REALTIME)
 def _fetch_kp_forecast() -> Any | None:
    return _fetch_cached_json('kp_forecast', f'{SWPC_JSON}/noaa-planetary-k-index-forecast.json', TTL_FORECAST)
 def _fetch_scales() -> Any | None:
    return _fetch_cached_json('scales', f'{SWPC_JSON}/noaa-scales.json', TTL_REALTIME)
 def _fetch_flux() -> Any | None:
    return _fetch_cached_json('flux', f'{SWPC_JSON}/10cm-flux-30-day.json', TTL_DAILY)
 def _fetch_alerts() -> Any | None:
    return _fetch_cached_json('alerts', f'{SWPC_JSON}/alerts.json', TTL_REALTIME)
 def _fetch_solar_wind_plasma() -> Any | None:
    return _fetch_cached_json('sw_plasma', f'{SWPC_JSON}/solar-wind/plasma-6-hour.json', TTL_REALTIME)
 def _fetch_solar_wind_mag() -> Any | None:
    return _fetch_cached_json('sw_mag', f'{SWPC_JSON}/solar-wind/mag-6-hour.json', TTL_REALTIME)
 def _fetch_xrays() -> Any | None:
    return _fetch_cached_json('xrays', f'{SWPC_BASE}/json/goes/primary/xrays-1-day.json', TTL_REALTIME)
 def _fetch_xray_flares() -> Any | None:
    return _fetch_cached_json('xray_flares', f'{SWPC_BASE}/json/goes/primary/xray-flares-7-day.json', TTL_REALTIME)
 def _fetch_flare_probability() -> Any | None:
    return _fetch_cached_json('flare_prob', f'{SWPC_BASE}/json/solar_probabilities.json', TTL_FORECAST)
 def _fetch_solar_regions() -> Any | None:
    return _fetch_cached_json('solar_regions', f'{SWPC_BASE}/json/solar_regions.json', TTL_DAILY)
 def _fetch_sunspot_report() -> Any | None:
    return _fetch_cached_json('sunspot_report', f'{SWPC_BASE}/json/sunspot_report.json', TTL_DAILY)
 def _parse_hamqsl_xml(xml_text: str) -> dict[str, Any] | None:
    """Parse HamQSL solar XML into a dict of band conditions."""
    try:
        root = ET.fromstring(xml_text)
        solar = root.find('.//solardata')
        if solar is None:
            return None
        result: dict[str, Any] = {}
        # Scalar fields
        for tag in ('sfi', 'aindex', 'kindex', 'kindexnt', 'xray', 'sunspots',
                     'heliumline', 'protonflux', 'electonflux', 'aurora',
                     'normalization', 'latdegree', 'solarwind', 'magneticfield',
                     'calculatedconditions', 'calculatedvhfconditions',
                     'geomagfield', 'signalnoise', 'fof2', 'muffactor', 'muf'):
            el = solar.find(tag)
            if el is not None and el.text:
                result[tag] = el.text.strip()
        # Band conditions
        bands: list[dict[str, str]] = []
        for band_el in solar.findall('.//calculatedconditions/band'):
            bands.append({
                'name': band_el.get('name', ''),
                'time': band_el.get('time', ''),
                'condition': band_el.text.strip() if band_el.text else ''
            })
        result['bands'] = bands
        # VHF conditions
        vhf: list[dict[str, str]] = []
        for phen_el in solar.findall('.//calculatedvhfconditions/phenomenon'):
            vhf.append({
                'name': phen_el.get('name', ''),
                'location': phen_el.get('location', ''),
                'condition': phen_el.text.strip() if phen_el.text else ''
            })
        result['vhf'] = vhf
        return result
    except ET.ParseError as exc:
        logger.warning('Failed to parse HamQSL XML: %s', exc)
        return None
 def _fetch_band_conditions() -> dict[str, Any] | None:
    cached = _cache_get('band_conditions')
    if cached is not None:
        return cached
    xml_text = _fetch_text('https://www.hamqsl.com/solarxml.php')
    if xml_text is None:
        return None
    data = _parse_hamqsl_xml(xml_text)
    if data is not None:
        _cache_set('band_conditions', data, TTL_FORECAST)
    return data
 # ---------------------------------------------------------------------------
 # Image proxy whitelist
 # ---------------------------------------------------------------------------
 IMAGE_WHITELIST: dict[str, dict[str, str]] = {
    # D-RAP absorption maps
    'drap_global': {
        'url': f'{SWPC_BASE}/images/animations/d-rap/global/latest.png',
        'content_type': 'image/png',
    },
    'drap_5': {
        'url': f'{SWPC_BASE}/images/d-rap/global_f05.png',
        'content_type': 'image/png',
    },
    'drap_10': {
        'url': f'{SWPC_BASE}/images/d-rap/global_f10.png',
        'content_type': 'image/png',
    },
    'drap_15': {
        'url': f'{SWPC_BASE}/images/d-rap/global_f15.png',
        'content_type': 'image/png',
    },
    'drap_20': {
        'url': f'{SWPC_BASE}/images/d-rap/global_f20.png',
        'content_type': 'image/png',
    },
    'drap_25': {
        'url': f'{SWPC_BASE}/images/d-rap/global_f25.png',
        'content_type': 'image/png',
    },
    'drap_30': {
        'url': f'{SWPC_BASE}/images/d-rap/global_f30.png',
        'content_type': 'image/png',
    },
    # Aurora forecast
    'aurora_north': {
        'url': f'{SWPC_BASE}/images/animations/ovation/north/latest.jpg',
        'content_type': 'image/jpeg',
    },
    # SDO solar imagery
    'sdo_193': {
        'url': 'https://sdo.gsfc.nasa.gov/assets/img/latest/latest_512_0193.jpg',
        'content_type': 'image/jpeg',
    },
    'sdo_304': {
        'url': 'https://sdo.gsfc.nasa.gov/assets/img/latest/latest_512_0304.jpg',
        'content_type': 'image/jpeg',
    },
    'sdo_magnetogram': {
        'url': 'https://sdo.gsfc.nasa.gov/assets/img/latest/latest_512_HMIBC.jpg',
        'content_type': 'image/jpeg',
    },
 }
 # ---------------------------------------------------------------------------
 # Routes
 # ---------------------------------------------------------------------------
@space_weather_bp.route('/data')
 def get_data():
    """Return aggregated space weather data from all sources."""
    data = {
        'kp_index': _fetch_kp_index(),
        'kp_forecast': _fetch_kp_forecast(),
        'scales': _fetch_scales(),
        'flux': _fetch_flux(),
        'alerts': _fetch_alerts(),
        'solar_wind_plasma': _fetch_solar_wind_plasma(),
        'solar_wind_mag': _fetch_solar_wind_mag(),
        'xrays': _fetch_xrays(),
        'xray_flares': _fetch_xray_flares(),
        'flare_probability': _fetch_flare_probability(),
        'solar_regions': _fetch_solar_regions(),
        'sunspot_report': _fetch_sunspot_report(),
        'band_conditions': _fetch_band_conditions(),
        'timestamp': time.time(),
    }
    return jsonify(data)
@space_weather_bp.route('/image/<key>')
 def get_image(key: str):
    """Proxy and cache whitelisted space weather images."""
    entry = IMAGE_WHITELIST.get(key)
    if not entry:
        return jsonify({'error': 'Unknown image key'}), 404
    cache_key = f'img_{key}'
    cached = _cache_get(cache_key)
    if cached is not None:
        return Response(cached, content_type=entry['content_type'],
                        headers={'Cache-Control': 'public, max-age=300'})
    img_data = _fetch_bytes(entry['url'])
    if img_data is None:
        return jsonify({'error': 'Failed to fetch image'}), 502
    _cache_set(cache_key, img_data, TTL_IMAGE)
    return Response(img_data, content_type=entry['content_type'],
                    headers={'Cache-Control': 'public, max-age=300'})
@@ -15,7 +15,7 @@ from flask import Blueprint, jsonify, request, Response, send_file
 import app as app_module
 from utils.logging import get_logger
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.sstv import (
    get_sstv_decoder,
@@ -27,6 +27,12 @@ logger = get_logger('intercept.sstv')
 sstv_bp = Blueprint('sstv', __name__, url_prefix='/sstv')
 # ISS SSTV runs on a fixed downlink; allow a small entry tolerance so users
 # can type nearby values and still land on the canonical center frequency.
 ISS_SSTV_MODULATION = 'fm'
 ISS_SSTV_FREQUENCIES = (ISS_SSTV_FREQ,)
 ISS_SSTV_FREQ_TOLERANCE_MHZ = 0.05
 # Queue for SSE progress streaming
 _sstv_queue: queue.Queue = queue.Queue(maxsize=100)
@@ -46,6 +52,14 @@ def _progress_callback(data: dict) -> None:
            pass
 def _normalize_iss_frequency(frequency_mhz: float) -> float | None:
    """Snap near-match user input to a supported ISS SSTV center frequency."""
    for supported in ISS_SSTV_FREQUENCIES:
        if abs(frequency_mhz - supported) <= ISS_SSTV_FREQ_TOLERANCE_MHZ:
            return supported
    return None
@sstv_bp.route('/status')
 def get_status():
    """
@@ -62,6 +76,7 @@ def get_status():
        'decoder': decoder.decoder_available,
        'running': decoder.is_running,
        'iss_frequency': ISS_SSTV_FREQ,
        'modulation': ISS_SSTV_MODULATION,
        'image_count': len(decoder.get_images()),
        'doppler_enabled': decoder.doppler_enabled,
    }
@@ -82,6 +97,7 @@ def start_decoder():
    JSON body (optional):
        {
            "frequency": 145.800,  // Frequency in MHz (default: ISS 145.800)
            "modulation": "fm",    // ISS mode is FM-only
            "device": 0,           // RTL-SDR device index
            "latitude": 40.7128,   // Observer latitude for Doppler correction
            "longitude": -74.0060  // Observer longitude for Doppler correction
@@ -106,6 +122,7 @@ def start_decoder():
        return jsonify({
            'status': 'already_running',
            'frequency': ISS_SSTV_FREQ,
            'modulation': ISS_SSTV_MODULATION,
            'doppler_enabled': decoder.doppler_enabled
        })
@@ -119,18 +136,29 @@ def start_decoder():
    # Get parameters
    data = request.get_json(silent=True) or {}
    frequency = data.get('frequency', ISS_SSTV_FREQ)
    modulation = str(data.get('modulation', ISS_SSTV_MODULATION)).strip().lower()
    device_index = data.get('device', 0)
    latitude = data.get('latitude')
    longitude = data.get('longitude')
    # Validate modulation (ISS mode is FM-only)
    if modulation != ISS_SSTV_MODULATION:
        return jsonify({
            'status': 'error',
            'message': f'Modulation must be {ISS_SSTV_MODULATION} for ISS SSTV mode'
        }), 400
    # Validate frequency
    try:
        frequency = float(frequency)
-        if not (100 <= frequency <= 500):  # VHF range
+        normalized_frequency = _normalize_iss_frequency(frequency)
        if normalized_frequency is None:
            supported = ', '.join(f'{freq:.3f}' for freq in ISS_SSTV_FREQUENCIES)
            return jsonify({
                'status': 'error',
-                'message': 'Frequency must be between 100-500 MHz'
+                'message': f'Supported ISS SSTV frequency: {supported} MHz FM'
            }), 400
        frequency = normalized_frequency
    except (TypeError, ValueError):
        return jsonify({
            'status': 'error',
@@ -178,7 +206,8 @@ def start_decoder():
        frequency=frequency,
        device_index=device_index,
        latitude=latitude,
-        longitude=longitude
+        longitude=longitude,
        modulation=ISS_SSTV_MODULATION,
    )
    if success:
@@ -187,6 +216,7 @@ def start_decoder():
        result = {
            'status': 'started',
            'frequency': frequency,
            'modulation': ISS_SSTV_MODULATION,
            'device': device_index,
            'doppler_enabled': decoder.doppler_enabled
        }
@@ -379,8 +409,8 @@ def delete_all_images():
    return jsonify({'status': 'ok', 'deleted': count})
-@sstv_bp.route('/stream')
+@sstv_bp.route('/stream')
-def stream_progress():
+def stream_progress():
    """
    SSE stream of SSTV decode progress.
@@ -392,29 +422,22 @@ def stream_progress():
    Returns:
        SSE stream (text/event-stream)
    """
-    def generate() -> Generator[str, None, None]:
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('sstv', msg, msg.get('type'))
-        keepalive_interval = 30.0
+
-
+    response = Response(
-        while True:
+        sse_stream_fanout(
-            try:
+            source_queue=_sstv_queue,
-                progress = _sstv_queue.get(timeout=1)
+            channel_key='sstv',
-                last_keepalive = time.time()
+            timeout=1.0,
-                try:
+            keepalive_interval=30.0,
-                    process_event('sstv', progress, progress.get('type'))
+            on_message=_on_msg,
-                except Exception:
+        ),
-                    pass
+        mimetype='text/event-stream',
-                yield format_sse(progress)
+    )
-            except queue.Empty:
+    response.headers['Cache-Control'] = 'no-cache'
-                now = time.time()
+    response.headers['X-Accel-Buffering'] = 'no'
-                if now - last_keepalive >= keepalive_interval:
+    response.headers['Connection'] = 'keep-alive'
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
    return response
@@ -13,8 +13,9 @@ from pathlib import Path
 from flask import Blueprint, Response, jsonify, request, send_file
 import app as app_module
 from utils.logging import get_logger
-from utils.sse import format_sse
+from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.sstv import (
    get_general_sstv_decoder,
@@ -27,6 +28,9 @@ sstv_general_bp = Blueprint('sstv_general', __name__, url_prefix='/sstv-general'
 # Queue for SSE progress streaming
 _sstv_general_queue: queue.Queue = queue.Queue(maxsize=100)
 # Track which device is being used
 _sstv_general_active_device: int | None = None
 # Predefined SSTV frequencies
 SSTV_FREQUENCIES = [
    {'band': '80 m', 'frequency': 3.845, 'modulation': 'lsb', 'notes': 'Common US SSTV calling frequency', 'type': 'Terrestrial HF'},
@@ -40,7 +44,7 @@ SSTV_FREQUENCIES = [
    {'band': '15 m', 'frequency': 21.340, 'modulation': 'usb', 'notes': 'International calling frequency', 'type': 'Terrestrial HF'},
    {'band': '10 m', 'frequency': 28.680, 'modulation': 'usb', 'notes': 'International calling frequency', 'type': 'Terrestrial HF'},
    {'band': '6 m', 'frequency': 50.950, 'modulation': 'usb', 'notes': 'SSTV calling (less common)', 'type': 'Terrestrial VHF'},
-    {'band': '2 m', 'frequency': 145.625, 'modulation': 'fm', 'notes': 'Australia/common simplex (FM sometimes used)', 'type': 'Terrestrial VHF'},
+    {'band': '2 m', 'frequency': 145.500, 'modulation': 'fm', 'notes': 'Australia/common simplex (FM sometimes used)', 'type': 'Terrestrial VHF'},
    {'band': '70 cm', 'frequency': 433.775, 'modulation': 'fm', 'notes': 'Australia/common simplex', 'type': 'Terrestrial UHF'},
 ]
@@ -150,6 +154,17 @@ def start_decoder():
            'message': 'Modulation must be fm, usb, or lsb',
        }), 400
    # Claim SDR device
    global _sstv_general_active_device
    device_int = int(device_index)
    error = app_module.claim_sdr_device(device_int, 'sstv_general')
    if error:
        return jsonify({
            'status': 'error',
            'error_type': 'DEVICE_BUSY',
            'message': error,
        }), 409
    # Set callback and start
    decoder.set_callback(_progress_callback)
    success = decoder.start(
@@ -159,6 +174,7 @@ def start_decoder():
    )
    if success:
        _sstv_general_active_device = device_int
        return jsonify({
            'status': 'started',
            'frequency': frequency,
@@ -166,6 +182,7 @@ def start_decoder():
            'device': device_index,
        })
    else:
        app_module.release_sdr_device(device_int)
        return jsonify({
            'status': 'error',
            'message': 'Failed to start decoder',
@@ -175,8 +192,14 @@ def start_decoder():
@sstv_general_bp.route('/stop', methods=['POST'])
 def stop_decoder():
    """Stop general SSTV decoder."""
    global _sstv_general_active_device
    decoder = get_general_sstv_decoder()
    decoder.stop()
    if _sstv_general_active_device is not None:
        app_module.release_sdr_device(_sstv_general_active_device)
        _sstv_general_active_device = None
    return jsonify({'status': 'stopped'})
@@ -266,26 +289,19 @@ def delete_all_images():
@sstv_general_bp.route('/stream')
 def stream_progress():
    """SSE stream of SSTV decode progress."""
-    def generate() -> Generator[str, None, None]:
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('sstv_general', msg, msg.get('type'))
        keepalive_interval = 30.0
-        while True:
+    response = Response(
-            try:
+        sse_stream_fanout(
-                progress = _sstv_general_queue.get(timeout=1)
+            source_queue=_sstv_general_queue,
-                last_keepalive = time.time()
+            channel_key='sstv_general',
-                try:
+            timeout=1.0,
-                    process_event('sstv_general', progress, progress.get('type'))
+            keepalive_interval=30.0,
-                except Exception:
+            on_message=_on_msg,
-                    pass
+        ),
-                yield format_sse(progress)
+        mimetype='text/event-stream',
-            except queue.Empty:
+    )
                now = time.time()
                if now - last_keepalive >= keepalive_interval:
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
@@ -10,9 +10,10 @@ import queue
 from flask import Blueprint, jsonify, request, Response, send_file
-from utils.logging import get_logger
+from utils.logging import get_logger
-from utils.sse import sse_stream
+from utils.sse import sse_stream
-from utils.subghz import get_subghz_manager
+from utils.subghz import get_subghz_manager
 from utils.event_pipeline import process_event
 from utils.constants import (
    SUBGHZ_FREQ_MIN_MHZ,
    SUBGHZ_FREQ_MAX_MHZ,
@@ -32,10 +33,14 @@ subghz_bp = Blueprint('subghz', __name__, url_prefix='/subghz')
 _subghz_queue: queue.Queue = queue.Queue(maxsize=200)
-def _event_callback(event: dict) -> None:
+def _event_callback(event: dict) -> None:
-    """Forward SubGhzManager events to the SSE queue."""
+    """Forward SubGhzManager events to the SSE queue."""
-    try:
+    try:
-        _subghz_queue.put_nowait(event)
+        process_event('subghz', event, event.get('type'))
    except Exception:
        pass
    try:
        _subghz_queue.put_nowait(event)
    except queue.Full:
        try:
            _subghz_queue.get_nowait()
@@ -61,6 +61,7 @@ from utils.tscm.device_identity import (
    ingest_wifi_dict,
 )
 from utils.event_pipeline import process_event
 from utils.sse import sse_stream_fanout
 # Import unified Bluetooth scanner helper for TSCM integration
 try:
@@ -629,24 +630,17 @@ def sweep_status():
@tscm_bp.route('/sweep/stream')
 def sweep_stream():
    """SSE stream for real-time sweep updates."""
-    def generate():
+    def _on_msg(msg: dict[str, Any]) -> None:
-        while True:
+        process_event('tscm', msg, msg.get('type'))
            try:
                if tscm_queue:
                    msg = tscm_queue.get(timeout=1)
                    try:
                        process_event('tscm', msg, msg.get('type'))
                    except Exception:
                        pass
                    yield f"data: {json.dumps(msg)}\n\n"
                else:
                    time.sleep(1)
                    yield f"data: {json.dumps({'type': 'keepalive'})}\n\n"
            except queue.Empty:
                yield f"data: {json.dumps({'type': 'keepalive'})}\n\n"
    return Response(
-        generate(),
+        sse_stream_fanout(
            source_queue=tscm_queue,
            channel_key='tscm',
            timeout=1.0,
            keepalive_interval=30.0,
            on_message=_on_msg,
        ),
        mimetype='text/event-stream',
        headers={
            'Cache-Control': 'no-cache',
@@ -0,0 +1,383 @@
 """VDL2 aircraft datalink routes."""
 from __future__ import annotations
 import io
 import json
 import os
 import platform
 import pty
 import queue
 import shutil
 import subprocess
 import threading
 import time
 from datetime import datetime
 from typing import Generator
 from flask import Blueprint, jsonify, request, Response
 import app as app_module
 from utils.logging import sensor_logger as logger
 from utils.validation import validate_device_index, validate_gain, validate_ppm
 from utils.sdr import SDRFactory, SDRType
 from utils.sse import sse_stream_fanout
 from utils.event_pipeline import process_event
 from utils.constants import (
    PROCESS_TERMINATE_TIMEOUT,
    SSE_KEEPALIVE_INTERVAL,
    SSE_QUEUE_TIMEOUT,
    PROCESS_START_WAIT,
 )
 from utils.process import register_process, unregister_process
 vdl2_bp = Blueprint('vdl2', __name__, url_prefix='/vdl2')
 # Default VDL2 frequencies (MHz) - common worldwide
 DEFAULT_VDL2_FREQUENCIES = [
    '136975000',  # Primary worldwide
    '136725000',  # Europe
    '136775000',  # Europe
    '136800000',  # Multi-region
    '136875000',  # Multi-region
 ]
 # Message counter for statistics
 vdl2_message_count = 0
 vdl2_last_message_time = None
 # Track which device is being used
 vdl2_active_device: int | None = None
 def find_dumpvdl2():
    """Find dumpvdl2 binary."""
    return shutil.which('dumpvdl2')
 def stream_vdl2_output(process: subprocess.Popen, is_text_mode: bool = False) -> None:
    """Stream dumpvdl2 JSON output to queue."""
    global vdl2_message_count, vdl2_last_message_time
    try:
        app_module.vdl2_queue.put({'type': 'status', 'status': 'started'})
        # Use appropriate sentinel based on mode (text mode for pty on macOS)
        sentinel = '' if is_text_mode else b''
        for line in iter(process.stdout.readline, sentinel):
            if is_text_mode:
                line = line.strip()
            else:
                line = line.decode('utf-8', errors='replace').strip()
            if not line:
                continue
            try:
                data = json.loads(line)
                # Add our metadata
                data['type'] = 'vdl2'
                data['timestamp'] = datetime.utcnow().isoformat() + 'Z'
                # Update stats
                vdl2_message_count += 1
                vdl2_last_message_time = time.time()
                app_module.vdl2_queue.put(data)
                # Feed flight correlator
                try:
                    from utils.flight_correlator import get_flight_correlator
                    get_flight_correlator().add_vdl2_message(data)
                except Exception:
                    pass
                # Log if enabled
                if app_module.logging_enabled:
                    try:
                        with open(app_module.log_file_path, 'a') as f:
                            ts = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
                            f.write(f"{ts} | VDL2 | {json.dumps(data)}\n")
                    except Exception:
                        pass
            except json.JSONDecodeError:
                # Not JSON - could be status message
                if line:
                    logger.debug(f"dumpvdl2 non-JSON: {line[:100]}")
    except Exception as e:
        logger.error(f"VDL2 stream error: {e}")
        app_module.vdl2_queue.put({'type': 'error', 'message': str(e)})
    finally:
        global vdl2_active_device
        # Ensure process is terminated
        try:
            process.terminate()
            process.wait(timeout=2)
        except Exception:
            try:
                process.kill()
            except Exception:
                pass
        unregister_process(process)
        app_module.vdl2_queue.put({'type': 'status', 'status': 'stopped'})
        with app_module.vdl2_lock:
            app_module.vdl2_process = None
        # Release SDR device
        if vdl2_active_device is not None:
            app_module.release_sdr_device(vdl2_active_device)
            vdl2_active_device = None
@vdl2_bp.route('/tools')
 def check_vdl2_tools() -> Response:
    """Check for VDL2 decoding tools."""
    has_dumpvdl2 = find_dumpvdl2() is not None
    return jsonify({
        'dumpvdl2': has_dumpvdl2,
        'ready': has_dumpvdl2
    })
@vdl2_bp.route('/status')
 def vdl2_status() -> Response:
    """Get VDL2 decoder status."""
    running = False
    if app_module.vdl2_process:
        running = app_module.vdl2_process.poll() is None
    return jsonify({
        'running': running,
        'message_count': vdl2_message_count,
        'last_message_time': vdl2_last_message_time,
        'queue_size': app_module.vdl2_queue.qsize()
    })
@vdl2_bp.route('/start', methods=['POST'])
 def start_vdl2() -> Response:
    """Start VDL2 decoder."""
    global vdl2_message_count, vdl2_last_message_time, vdl2_active_device
    with app_module.vdl2_lock:
        if app_module.vdl2_process and app_module.vdl2_process.poll() is None:
            return jsonify({
                'status': 'error',
                'message': 'VDL2 decoder already running'
            }), 409
    # Check for dumpvdl2
    dumpvdl2_path = find_dumpvdl2()
    if not dumpvdl2_path:
        return jsonify({
            'status': 'error',
            'message': 'dumpvdl2 not found. Install from: https://github.com/szpajder/dumpvdl2'
        }), 400
    data = request.json or {}
    # Validate inputs
    try:
        device = validate_device_index(data.get('device', '0'))
        gain = validate_gain(data.get('gain', '40'))
        ppm = validate_ppm(data.get('ppm', '0'))
    except ValueError as e:
        return jsonify({'status': 'error', 'message': str(e)}), 400
    # Check if device is available
    device_int = int(device)
    error = app_module.claim_sdr_device(device_int, 'vdl2')
    if error:
        return jsonify({
            'status': 'error',
            'error_type': 'DEVICE_BUSY',
            'message': error
        }), 409
    vdl2_active_device = device_int
    # Get frequencies - use provided or defaults
    # dumpvdl2 expects frequencies in Hz (integers)
    frequencies = data.get('frequencies', DEFAULT_VDL2_FREQUENCIES)
    if isinstance(frequencies, str):
        frequencies = [f.strip() for f in frequencies.split(',')]
    # Clear queue
    while not app_module.vdl2_queue.empty():
        try:
            app_module.vdl2_queue.get_nowait()
        except queue.Empty:
            break
    # Reset stats
    vdl2_message_count = 0
    vdl2_last_message_time = None
    # Resolve SDR type for device selection
    sdr_type_str = data.get('sdr_type', 'rtlsdr')
    try:
        sdr_type = SDRType(sdr_type_str)
    except ValueError:
        sdr_type = SDRType.RTL_SDR
    is_soapy = sdr_type not in (SDRType.RTL_SDR,)
    # Build dumpvdl2 command
    # dumpvdl2 --output decoded:json --rtlsdr <device> --gain <gain> --correction <ppm> <freq1> <freq2> ...
    cmd = [dumpvdl2_path]
    cmd.extend(['--output', 'decoded:json:file:path=-'])
    if is_soapy:
        # SoapySDR device
        sdr_device = SDRFactory.create_default_device(sdr_type, index=device_int)
        builder = SDRFactory.get_builder(sdr_type)
        device_str = builder._build_device_string(sdr_device)
        cmd.extend(['--soapysdr', device_str])
    else:
        cmd.extend(['--rtlsdr', str(device)])
    # Add gain
    if gain and str(gain) != '0':
        cmd.extend(['--gain', str(gain)])
    # Add PPM correction if specified
    if ppm and str(ppm) != '0':
        cmd.extend(['--correction', str(ppm)])
    # Add frequencies (dumpvdl2 takes them as positional args in Hz)
    cmd.extend(frequencies)
    logger.info(f"Starting VDL2 decoder: {' '.join(cmd)}")
    try:
        is_text_mode = False
        # On macOS, use pty to avoid stdout buffering issues
        if platform.system() == 'Darwin':
            master_fd, slave_fd = pty.openpty()
            process = subprocess.Popen(
                cmd,
                stdout=slave_fd,
                stderr=subprocess.PIPE,
                start_new_session=True
            )
            os.close(slave_fd)
            # Wrap master_fd as a text file for line-buffered reading
            process.stdout = io.open(master_fd, 'r', buffering=1)
            is_text_mode = True
        else:
            process = subprocess.Popen(
                cmd,
                stdout=subprocess.PIPE,
                stderr=subprocess.PIPE,
                start_new_session=True
            )
        # Wait briefly to check if process started
        time.sleep(PROCESS_START_WAIT)
        if process.poll() is not None:
            # Process died - release device
            if vdl2_active_device is not None:
                app_module.release_sdr_device(vdl2_active_device)
                vdl2_active_device = None
            stderr = ''
            if process.stderr:
                stderr = process.stderr.read().decode('utf-8', errors='replace')
            error_msg = 'dumpvdl2 failed to start'
            if stderr:
                error_msg += f': {stderr[:200]}'
            logger.error(error_msg)
            return jsonify({'status': 'error', 'message': error_msg}), 500
        app_module.vdl2_process = process
        register_process(process)
        # Start output streaming thread
        thread = threading.Thread(
            target=stream_vdl2_output,
            args=(process, is_text_mode),
            daemon=True
        )
        thread.start()
        return jsonify({
            'status': 'started',
            'frequencies': frequencies,
            'device': device,
            'gain': gain
        })
    except Exception as e:
        # Release device on failure
        if vdl2_active_device is not None:
            app_module.release_sdr_device(vdl2_active_device)
            vdl2_active_device = None
        logger.error(f"Failed to start VDL2 decoder: {e}")
        return jsonify({'status': 'error', 'message': str(e)}), 500
@vdl2_bp.route('/stop', methods=['POST'])
 def stop_vdl2() -> Response:
    """Stop VDL2 decoder."""
    global vdl2_active_device
    with app_module.vdl2_lock:
        if not app_module.vdl2_process:
            return jsonify({
                'status': 'error',
                'message': 'VDL2 decoder not running'
            }), 400
        try:
            app_module.vdl2_process.terminate()
            app_module.vdl2_process.wait(timeout=PROCESS_TERMINATE_TIMEOUT)
        except subprocess.TimeoutExpired:
            app_module.vdl2_process.kill()
        except Exception as e:
            logger.error(f"Error stopping VDL2: {e}")
        app_module.vdl2_process = None
    # Release device from registry
    if vdl2_active_device is not None:
        app_module.release_sdr_device(vdl2_active_device)
        vdl2_active_device = None
    return jsonify({'status': 'stopped'})
@vdl2_bp.route('/stream')
 def stream_vdl2() -> Response:
    """SSE stream for VDL2 messages."""
    def _on_msg(msg: dict[str, Any]) -> None:
        process_event('vdl2', msg, msg.get('type'))
    response = Response(
        sse_stream_fanout(
            source_queue=app_module.vdl2_queue,
            channel_key='vdl2',
            timeout=SSE_QUEUE_TIMEOUT,
            keepalive_interval=SSE_KEEPALIVE_INTERVAL,
            on_message=_on_msg,
        ),
        mimetype='text/event-stream',
    )
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    return response
@vdl2_bp.route('/frequencies')
 def get_frequencies() -> Response:
    """Get default VDL2 frequencies."""
    return jsonify({
        'default': DEFAULT_VDL2_FREQUENCIES,
        'regions': {
            'north_america': ['136975000', '136100000', '136650000', '136700000', '136800000'],
            'europe': ['136975000', '136675000', '136725000', '136775000', '136825000'],
            'asia_pacific': ['136975000', '136900000'],
        }
    })
@@ -1,13 +1,16 @@
-"""WebSocket-based waterfall streaming with I/Q capture and server-side FFT."""
+"""WebSocket-based waterfall streaming with I/Q capture and server-side FFT."""
-
+
-import json
+import json
-import queue
+import queue
-import socket
+import socket
-import subprocess
+import subprocess
-import threading
+import threading
-import time
+import time
-
+from contextlib import suppress
-from flask import Flask
+from typing import Any
 import numpy as np
 from flask import Flask
 try:
    from flask_sock import Sock
@@ -16,31 +19,277 @@ except ImportError:
    WEBSOCKET_AVAILABLE = False
    Sock = None
-from utils.logging import get_logger
+from utils.logging import get_logger
-from utils.process import safe_terminate, register_process, unregister_process
+from utils.process import register_process, safe_terminate, unregister_process
-from utils.waterfall_fft import (
+from utils.sdr import SDRFactory, SDRType
-    build_binary_frame,
+from utils.sdr.base import SDRCapabilities, SDRDevice
-    compute_power_spectrum,
+from utils.waterfall_fft import (
-    cu8_to_complex,
+    build_binary_frame,
-    quantize_to_uint8,
+    compute_power_spectrum,
-)
+    cu8_to_complex,
-from utils.sdr import SDRFactory, SDRType
+    quantize_to_uint8,
-from utils.sdr.base import SDRCapabilities, SDRDevice
+)
 logger = get_logger('intercept.waterfall_ws')
 AUDIO_SAMPLE_RATE = 48000
 _shared_state_lock = threading.Lock()
 _shared_audio_queue: queue.Queue[bytes] = queue.Queue(maxsize=80)
 _shared_state: dict[str, Any] = {
    'running': False,
    'device': None,
    'center_mhz': 0.0,
    'span_mhz': 0.0,
    'sample_rate': 0,
    'monitor_enabled': False,
    'monitor_freq_mhz': 0.0,
    'monitor_modulation': 'wfm',
    'monitor_squelch': 0,
 }
-logger = get_logger('intercept.waterfall_ws')
+# Maximum bandwidth per SDR type (Hz)
-
+MAX_BANDWIDTH = {
-# Maximum bandwidth per SDR type (Hz)
+    SDRType.RTL_SDR: 2400000,
-MAX_BANDWIDTH = {
+    SDRType.HACKRF: 20000000,
-    SDRType.RTL_SDR: 2400000,
+    SDRType.LIME_SDR: 20000000,
-    SDRType.HACKRF: 20000000,
+    SDRType.AIRSPY: 10000000,
-    SDRType.LIME_SDR: 20000000,
+    SDRType.SDRPLAY: 2000000,
-    SDRType.AIRSPY: 10000000,
+}
-    SDRType.SDRPLAY: 2000000,
+
-}
+
-
+def _clear_shared_audio_queue() -> None:
-
+    while True:
-def _resolve_sdr_type(sdr_type_str: str) -> SDRType:
+        try:
-    """Convert client sdr_type string to SDRType enum."""
+            _shared_audio_queue.get_nowait()
        except queue.Empty:
            break
 def _set_shared_capture_state(
    *,
    running: bool,
    device: int | None = None,
    center_mhz: float | None = None,
    span_mhz: float | None = None,
    sample_rate: int | None = None,
 ) -> None:
    with _shared_state_lock:
        _shared_state['running'] = bool(running)
        _shared_state['device'] = device if running else None
        if center_mhz is not None:
            _shared_state['center_mhz'] = float(center_mhz)
        if span_mhz is not None:
            _shared_state['span_mhz'] = float(span_mhz)
        if sample_rate is not None:
            _shared_state['sample_rate'] = int(sample_rate)
        if not running:
            _shared_state['monitor_enabled'] = False
    if not running:
        _clear_shared_audio_queue()
 def _set_shared_monitor(
    *,
    enabled: bool,
    frequency_mhz: float | None = None,
    modulation: str | None = None,
    squelch: int | None = None,
 ) -> None:
    was_enabled = False
    with _shared_state_lock:
        was_enabled = bool(_shared_state.get('monitor_enabled'))
        _shared_state['monitor_enabled'] = bool(enabled)
        if frequency_mhz is not None:
            _shared_state['monitor_freq_mhz'] = float(frequency_mhz)
        if modulation is not None:
            _shared_state['monitor_modulation'] = str(modulation).lower().strip()
        if squelch is not None:
            _shared_state['monitor_squelch'] = max(0, min(100, int(squelch)))
    if was_enabled and not enabled:
        _clear_shared_audio_queue()
 def get_shared_capture_status() -> dict[str, Any]:
    with _shared_state_lock:
        return {
            'running': bool(_shared_state['running']),
            'device': _shared_state['device'],
            'center_mhz': float(_shared_state.get('center_mhz', 0.0) or 0.0),
            'span_mhz': float(_shared_state.get('span_mhz', 0.0) or 0.0),
            'sample_rate': int(_shared_state.get('sample_rate', 0) or 0),
            'monitor_enabled': bool(_shared_state.get('monitor_enabled')),
            'monitor_freq_mhz': float(_shared_state.get('monitor_freq_mhz', 0.0) or 0.0),
            'monitor_modulation': str(_shared_state.get('monitor_modulation', 'wfm')),
            'monitor_squelch': int(_shared_state.get('monitor_squelch', 0) or 0),
        }
 def start_shared_monitor_from_capture(
    *,
    device: int,
    frequency_mhz: float,
    modulation: str,
    squelch: int,
 ) -> tuple[bool, str]:
    with _shared_state_lock:
        if not _shared_state['running']:
            return False, 'Waterfall IQ stream not active'
        if _shared_state['device'] != device:
            return False, 'Waterfall stream is using a different SDR device'
        _shared_state['monitor_enabled'] = True
        _shared_state['monitor_freq_mhz'] = float(frequency_mhz)
        _shared_state['monitor_modulation'] = str(modulation).lower().strip()
        _shared_state['monitor_squelch'] = max(0, min(100, int(squelch)))
    _clear_shared_audio_queue()
    return True, 'started'
 def stop_shared_monitor_from_capture() -> None:
    _set_shared_monitor(enabled=False)
 def read_shared_monitor_audio_chunk(timeout: float = 1.0) -> bytes | None:
    with _shared_state_lock:
        if not _shared_state['running'] or not _shared_state['monitor_enabled']:
            return None
    try:
        return _shared_audio_queue.get(timeout=max(0.0, float(timeout)))
    except queue.Empty:
        return None
 def _snapshot_monitor_config() -> dict[str, Any] | None:
    with _shared_state_lock:
        if not (_shared_state['running'] and _shared_state['monitor_enabled']):
            return None
        return {
            'center_mhz': float(_shared_state['center_mhz']),
            'monitor_freq_mhz': float(_shared_state['monitor_freq_mhz']),
            'modulation': str(_shared_state['monitor_modulation']),
            'squelch': int(_shared_state['monitor_squelch']),
        }
 def _push_shared_audio_chunk(chunk: bytes) -> None:
    if not chunk:
        return
    if _shared_audio_queue.full():
        with suppress(queue.Empty):
            _shared_audio_queue.get_nowait()
    with suppress(queue.Full):
        _shared_audio_queue.put_nowait(chunk)
 def _demodulate_monitor_audio(
    samples: np.ndarray,
    sample_rate: int,
    center_mhz: float,
    monitor_freq_mhz: float,
    modulation: str,
    squelch: int,
 ) -> bytes | None:
    if samples.size < 32 or sample_rate <= 0:
        return None
    fs = float(sample_rate)
    freq_offset_hz = (float(monitor_freq_mhz) - float(center_mhz)) * 1e6
    nyquist = fs * 0.5
    if abs(freq_offset_hz) > nyquist * 0.98:
        return None
    n = np.arange(samples.size, dtype=np.float32)
    rotator = np.exp(-1j * (2.0 * np.pi * freq_offset_hz / fs) * n)
    shifted = samples * rotator
    mod = str(modulation or 'wfm').lower().strip()
    target_bb = 220000.0 if mod == 'wfm' else 48000.0
    pre_decim = max(1, int(fs // target_bb))
    if pre_decim > 1:
        usable = (shifted.size // pre_decim) * pre_decim
        if usable < pre_decim:
            return None
        shifted = shifted[:usable].reshape(-1, pre_decim).mean(axis=1)
    fs1 = fs / pre_decim
    if shifted.size < 16:
        return None
    if mod in ('wfm', 'fm'):
        audio = np.angle(shifted[1:] * np.conj(shifted[:-1])).astype(np.float32)
    elif mod == 'am':
        envelope = np.abs(shifted).astype(np.float32)
        audio = envelope - float(np.mean(envelope))
    elif mod == 'usb':
        audio = np.real(shifted).astype(np.float32)
    elif mod == 'lsb':
        audio = -np.real(shifted).astype(np.float32)
    else:
        audio = np.real(shifted).astype(np.float32)
    if audio.size < 8:
        return None
    audio = audio - float(np.mean(audio))
    if mod in ('fm', 'am', 'usb', 'lsb'):
        taps = int(max(1, min(31, fs1 / 12000.0)))
        if taps > 1:
            kernel = np.ones(taps, dtype=np.float32) / float(taps)
            audio = np.convolve(audio, kernel, mode='same')
    out_len = int(audio.size * AUDIO_SAMPLE_RATE / fs1)
    if out_len < 32:
        return None
    x_old = np.linspace(0.0, 1.0, audio.size, endpoint=False, dtype=np.float32)
    x_new = np.linspace(0.0, 1.0, out_len, endpoint=False, dtype=np.float32)
    audio = np.interp(x_new, x_old, audio).astype(np.float32)
    rms = float(np.sqrt(np.mean(audio * audio) + 1e-12))
    level = min(100.0, rms * 450.0)
    if squelch > 0 and level < float(squelch):
        audio.fill(0.0)
    peak = float(np.max(np.abs(audio))) if audio.size else 0.0
    if peak > 0:
        audio = audio * min(20.0, 0.85 / peak)
    pcm = np.clip(audio, -1.0, 1.0)
    return (pcm * 32767.0).astype(np.int16).tobytes()
 def _parse_center_freq_mhz(payload: dict[str, Any]) -> float:
    """Parse center frequency from mixed legacy/new payload formats."""
    if payload.get('center_freq_mhz') is not None:
        return float(payload['center_freq_mhz'])
    if payload.get('center_freq_hz') is not None:
        return float(payload['center_freq_hz']) / 1e6
    raw = float(payload.get('center_freq', 100.0))
    # Backward compatibility: some clients still send center_freq in Hz.
    if raw > 100000:
        return raw / 1e6
    return raw
 def _parse_span_mhz(payload: dict[str, Any]) -> float:
    """Parse display span in MHz from mixed payload formats."""
    if payload.get('span_hz') is not None:
        return float(payload['span_hz']) / 1e6
    return float(payload.get('span_mhz', 2.0))
 def _pick_sample_rate(span_hz: int, caps: SDRCapabilities, sdr_type: SDRType) -> int:
    """Pick a valid hardware sample rate nearest the requested span."""
    valid_rates = sorted({int(r) for r in caps.sample_rates if int(r) > 0})
    if valid_rates:
        return min(valid_rates, key=lambda rate: abs(rate - span_hz))
    max_bw = MAX_BANDWIDTH.get(sdr_type, 2400000)
    return max(62500, min(span_hz, max_bw))
 def _resolve_sdr_type(sdr_type_str: str) -> SDRType:
    """Convert client sdr_type string to SDRType enum."""
    mapping = {
        'rtlsdr': SDRType.RTL_SDR,
        'rtl_sdr': SDRType.RTL_SDR,
@@ -83,12 +332,16 @@ def init_waterfall_websocket(app: Flask):
        # Import app module for device claiming
        import app as app_module
-        iq_process = None
+        iq_process = None
-        reader_thread = None
+        reader_thread = None
-        stop_event = threading.Event()
+        stop_event = threading.Event()
-        claimed_device = None
+        claimed_device = None
-        # Queue for outgoing messages — only the main loop touches ws.send()
+        capture_center_mhz = 0.0
-        send_queue = queue.Queue(maxsize=120)
+        capture_start_freq = 0.0
        capture_end_freq = 0.0
        capture_span_mhz = 0.0
        # Queue for outgoing messages — only the main loop touches ws.send()
        send_queue = queue.Queue(maxsize=120)
        try:
            while True:
@@ -105,7 +358,7 @@ def init_waterfall_websocket(app: Flask):
                        break
                try:
-                    msg = ws.receive(timeout=0.1)
+                    msg = ws.receive(timeout=0.01)
                except Exception as e:
                    err = str(e).lower()
                    if "closed" in err:
@@ -130,257 +383,370 @@ def init_waterfall_websocket(app: Flask):
                cmd = data.get('cmd')
-                if cmd == 'start':
+                if cmd == 'start':
-                    # Stop any existing capture
+                    # Stop any existing capture
-                    was_restarting = iq_process is not None
+                    was_restarting = iq_process is not None
-                    stop_event.set()
+                    stop_event.set()
-                    if reader_thread and reader_thread.is_alive():
+                    if reader_thread and reader_thread.is_alive():
-                        reader_thread.join(timeout=2)
+                        reader_thread.join(timeout=2)
-                    if iq_process:
+                    if iq_process:
                        safe_terminate(iq_process)
                        unregister_process(iq_process)
                        iq_process = None
                    if claimed_device is not None:
                        app_module.release_sdr_device(claimed_device)
                        claimed_device = None
                    _set_shared_capture_state(running=False)
                    stop_event.clear()
                    # Flush stale frames from previous capture
                    while not send_queue.empty():
                        try:
                            send_queue.get_nowait()
                        except queue.Empty:
                            break
                    # Allow USB device to be released by the kernel
                    if was_restarting:
                        time.sleep(0.5)
                    # Parse config
                    try:
                        center_freq_mhz = _parse_center_freq_mhz(data)
                        span_mhz = _parse_span_mhz(data)
                        gain_raw = data.get('gain')
                        if gain_raw is None or str(gain_raw).lower() == 'auto':
                            gain = None
                        else:
                            gain = float(gain_raw)
                        device_index = int(data.get('device', 0))
                        sdr_type_str = data.get('sdr_type', 'rtlsdr')
                        fft_size = int(data.get('fft_size', 1024))
                        fps = int(data.get('fps', 25))
                        avg_count = int(data.get('avg_count', 4))
                        ppm = data.get('ppm')
                        if ppm is not None:
                            ppm = int(ppm)
                        bias_t = bool(data.get('bias_t', False))
                        db_min = data.get('db_min')
                        db_max = data.get('db_max')
                        if db_min is not None:
                            db_min = float(db_min)
                        if db_max is not None:
                            db_max = float(db_max)
                    except (TypeError, ValueError) as exc:
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': f'Invalid waterfall configuration: {exc}',
                        }))
                        continue
                    # Clamp and normalize runtime settings
                    fft_size = max(256, min(8192, fft_size))
                    fps = max(2, min(60, fps))
                    avg_count = max(1, min(32, avg_count))
                    if center_freq_mhz <= 0 or span_mhz <= 0:
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': 'center_freq_mhz and span_mhz must be > 0',
                        }))
                        continue
                    # Resolve SDR type and choose a valid sample rate
                    sdr_type = _resolve_sdr_type(sdr_type_str)
                    builder = SDRFactory.get_builder(sdr_type)
                    caps = builder.get_capabilities()
                    requested_span_hz = max(1000, int(span_mhz * 1e6))
                    sample_rate = _pick_sample_rate(requested_span_hz, caps, sdr_type)
                    # Compute effective frequency range
                    effective_span_mhz = sample_rate / 1e6
                    start_freq = center_freq_mhz - effective_span_mhz / 2
                    end_freq = center_freq_mhz + effective_span_mhz / 2
                    # Claim the device
                    claim_err = app_module.claim_sdr_device(device_index, 'waterfall')
                    if claim_err:
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': claim_err,
                            'error_type': 'DEVICE_BUSY',
                        }))
                        continue
                    claimed_device = device_index
                    # Build I/Q capture command
                    try:
                        device = _build_dummy_device(device_index, sdr_type)
                        iq_cmd = builder.build_iq_capture_command(
                            device=device,
                            frequency_mhz=center_freq_mhz,
                            sample_rate=sample_rate,
                            gain=gain,
                            ppm=ppm,
                            bias_t=bias_t,
                        )
                    except NotImplementedError as e:
                        app_module.release_sdr_device(device_index)
                        claimed_device = None
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': str(e),
                        }))
                        continue
                    # Spawn I/Q capture process (retry to handle USB release lag)
                    max_attempts = 3 if was_restarting else 1
                    try:
                        for attempt in range(max_attempts):
                            logger.info(
                                f"Starting I/Q capture: {center_freq_mhz:.6f} MHz, "
                                f"span={effective_span_mhz:.1f} MHz, "
                                f"sr={sample_rate}, fft={fft_size}"
                            )
                            iq_process = subprocess.Popen(
                                iq_cmd,
                                stdout=subprocess.PIPE,
                                stderr=subprocess.DEVNULL,
                                bufsize=0,
                            )
                            register_process(iq_process)
                            # Brief check that process started
                            time.sleep(0.3)
                            if iq_process.poll() is not None:
                                unregister_process(iq_process)
                                iq_process = None
                                if attempt < max_attempts - 1:
                                    logger.info(
                                        f"I/Q process exited immediately, "
                                        f"retrying ({attempt + 1}/{max_attempts})..."
                                    )
                                    time.sleep(0.5)
                                    continue
                                raise RuntimeError(
                                    "I/Q capture process exited immediately"
                                )
                            break  # Process started successfully
                    except Exception as e:
                        logger.error(f"Failed to start I/Q capture: {e}")
                        if iq_process:
                            safe_terminate(iq_process)
                            unregister_process(iq_process)
                            iq_process = None
                        app_module.release_sdr_device(device_index)
                        claimed_device = None
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': f'Failed to start I/Q capture: {e}',
                        }))
                        continue
                    capture_center_mhz = center_freq_mhz
                    capture_start_freq = start_freq
                    capture_end_freq = end_freq
                    capture_span_mhz = effective_span_mhz
                    _set_shared_capture_state(
                        running=True,
                        device=device_index,
                        center_mhz=center_freq_mhz,
                        span_mhz=effective_span_mhz,
                        sample_rate=sample_rate,
                    )
                    _set_shared_monitor(
                        enabled=False,
                        frequency_mhz=center_freq_mhz,
                        modulation='wfm',
                        squelch=0,
                    )
                    # Send started confirmation
                    ws.send(json.dumps({
                        'status': 'started',
                        'center_mhz': center_freq_mhz,
                        'start_freq': start_freq,
                        'end_freq': end_freq,
                        'fft_size': fft_size,
                        'sample_rate': sample_rate,
                        'effective_span_mhz': effective_span_mhz,
                        'db_min': db_min,
                        'db_max': db_max,
                        'vfo_freq_mhz': center_freq_mhz,
                    }))
                    # Start reader thread — puts frames on queue, never calls ws.send()
                    def fft_reader(
                        proc, _send_q, stop_evt,
                        _fft_size, _avg_count, _fps, _sample_rate,
                        _start_freq, _end_freq, _center_mhz,
                        _db_min=None, _db_max=None,
                    ):
                        """Read I/Q from subprocess, compute FFT, enqueue binary frames."""
                        required_fft_samples = _fft_size * _avg_count
                        timeslice_samples = max(required_fft_samples, int(_sample_rate / max(1, _fps)))
                        bytes_per_frame = timeslice_samples * 2
                        frame_interval = 1.0 / _fps
                        try:
                            while not stop_evt.is_set():
                                if proc.poll() is not None:
                                    break
                                frame_start = time.monotonic()
                                # Read raw I/Q bytes
                                raw = b''
                                remaining = bytes_per_frame
                                while remaining > 0 and not stop_evt.is_set():
                                    chunk = proc.stdout.read(min(remaining, 65536))
                                    if not chunk:
                                        break
                                    raw += chunk
                                    remaining -= len(chunk)
                                if len(raw) < _fft_size * 2:
                                    break
                                # Process FFT pipeline
                                samples = cu8_to_complex(raw)
                                fft_samples = samples[-required_fft_samples:] if len(samples) > required_fft_samples else samples
                                power_db = compute_power_spectrum(
                                    fft_samples,
                                    fft_size=_fft_size,
                                    avg_count=_avg_count,
                                )
                                quantized = quantize_to_uint8(
                                    power_db,
                                    db_min=_db_min,
                                    db_max=_db_max,
                                )
                                frame = build_binary_frame(
                                    _start_freq, _end_freq, quantized,
                                )
                                # Drop frame if main loop cannot keep up.
                                with suppress(queue.Full):
                                    _send_q.put_nowait(frame)
                                monitor_cfg = _snapshot_monitor_config()
                                if monitor_cfg:
                                    audio_chunk = _demodulate_monitor_audio(
                                        samples=samples,
                                        sample_rate=_sample_rate,
                                        center_mhz=monitor_cfg.get('center_mhz', _center_mhz),
                                        monitor_freq_mhz=monitor_cfg.get('monitor_freq_mhz', _center_mhz),
                                        modulation=monitor_cfg.get('modulation', 'wfm'),
                                        squelch=int(monitor_cfg.get('squelch', 0)),
                                    )
                                    if audio_chunk:
                                        _push_shared_audio_chunk(audio_chunk)
                                # Pace to target FPS
                                elapsed = time.monotonic() - frame_start
                                sleep_time = frame_interval - elapsed
                                if sleep_time > 0:
                                    stop_evt.wait(sleep_time)
                        except Exception as e:
                            logger.debug(f"FFT reader stopped: {e}")
                    reader_thread = threading.Thread(
                        target=fft_reader,
                        args=(
                            iq_process, send_queue, stop_event,
                            fft_size, avg_count, fps, sample_rate,
                            start_freq, end_freq, center_freq_mhz,
                            db_min, db_max,
                        ),
                        daemon=True,
                    )
                    reader_thread.start()
                elif cmd in ('tune', 'set_vfo'):
                    if not iq_process or claimed_device is None or iq_process.poll() is not None:
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': 'Waterfall capture is not running',
                        }))
                        continue
                    try:
                        shared = get_shared_capture_status()
                        vfo_freq_mhz = float(
                            data.get(
                                'vfo_freq_mhz',
                                data.get('frequency_mhz', data.get('center_freq_mhz', capture_center_mhz)),
                            )
                        )
                        squelch = int(data.get('squelch', shared.get('monitor_squelch', 0)))
                        modulation = str(data.get('modulation', shared.get('monitor_modulation', 'wfm')))
                    except (TypeError, ValueError) as exc:
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': f'Invalid tune request: {exc}',
                        }))
                        continue
                    if not (capture_start_freq <= vfo_freq_mhz <= capture_end_freq):
                        ws.send(json.dumps({
                            'status': 'retune_required',
                            'message': 'Frequency outside current capture span',
                            'capture_start_freq': capture_start_freq,
                            'capture_end_freq': capture_end_freq,
                            'vfo_freq_mhz': vfo_freq_mhz,
                        }))
                        continue
                    monitor_enabled = bool(shared.get('monitor_enabled'))
                    _set_shared_monitor(
                        enabled=monitor_enabled,
                        frequency_mhz=vfo_freq_mhz,
                        modulation=modulation,
                        squelch=squelch,
                    )
                    ws.send(json.dumps({
                        'status': 'tuned',
                        'vfo_freq_mhz': vfo_freq_mhz,
                        'start_freq': capture_start_freq,
                        'end_freq': capture_end_freq,
                        'center_mhz': capture_center_mhz,
                    }))
                elif cmd == 'stop':
                    stop_event.set()
                    if reader_thread and reader_thread.is_alive():
                        reader_thread.join(timeout=2)
                        reader_thread = None
                    if iq_process:
                        safe_terminate(iq_process)
                        unregister_process(iq_process)
                        iq_process = None
-                    if claimed_device is not None:
+                    if claimed_device is not None:
-                        app_module.release_sdr_device(claimed_device)
+                        app_module.release_sdr_device(claimed_device)
-                        claimed_device = None
+                        claimed_device = None
-                    stop_event.clear()
+                    _set_shared_capture_state(running=False)
-                    # Flush stale frames from previous capture
+                    stop_event.clear()
-                    while not send_queue.empty():
+                    ws.send(json.dumps({'status': 'stopped'}))
                        try:
                            send_queue.get_nowait()
                        except queue.Empty:
                            break
                    # Allow USB device to be released by the kernel
                    if was_restarting:
                        time.sleep(0.5)
                    # Parse config
                    center_freq = float(data.get('center_freq', 100.0))
                    span_mhz = float(data.get('span_mhz', 2.0))
                    gain = data.get('gain')
                    if gain is not None:
                        gain = float(gain)
                    device_index = int(data.get('device', 0))
                    sdr_type_str = data.get('sdr_type', 'rtlsdr')
                    fft_size = int(data.get('fft_size', 1024))
                    fps = int(data.get('fps', 25))
                    avg_count = int(data.get('avg_count', 4))
                    ppm = data.get('ppm')
                    if ppm is not None:
                        ppm = int(ppm)
                    bias_t = bool(data.get('bias_t', False))
                    # Clamp FFT size to valid powers of 2
                    fft_size = max(256, min(8192, fft_size))
                    # Resolve SDR type and bandwidth
                    sdr_type = _resolve_sdr_type(sdr_type_str)
                    max_bw = MAX_BANDWIDTH.get(sdr_type, 2400000)
                    span_hz = int(span_mhz * 1e6)
                    sample_rate = min(span_hz, max_bw)
                    # Compute effective frequency range
                    effective_span_mhz = sample_rate / 1e6
                    start_freq = center_freq - effective_span_mhz / 2
                    end_freq = center_freq + effective_span_mhz / 2
                    # Claim the device
                    claim_err = app_module.claim_sdr_device(device_index, 'waterfall')
                    if claim_err:
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': claim_err,
                            'error_type': 'DEVICE_BUSY',
                        }))
                        continue
                    claimed_device = device_index
                    # Build I/Q capture command
                    try:
                        builder = SDRFactory.get_builder(sdr_type)
                        device = _build_dummy_device(device_index, sdr_type)
                        iq_cmd = builder.build_iq_capture_command(
                            device=device,
                            frequency_mhz=center_freq,
                            sample_rate=sample_rate,
                            gain=gain,
                            ppm=ppm,
                            bias_t=bias_t,
                        )
                    except NotImplementedError as e:
                        app_module.release_sdr_device(device_index)
                        claimed_device = None
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': str(e),
                        }))
                        continue
                    # Spawn I/Q capture process (retry to handle USB release lag)
                    max_attempts = 3 if was_restarting else 1
                    try:
                        for attempt in range(max_attempts):
                            logger.info(
                                f"Starting I/Q capture: {center_freq} MHz, "
                                f"span={effective_span_mhz:.1f} MHz, "
                                f"sr={sample_rate}, fft={fft_size}"
                            )
                            iq_process = subprocess.Popen(
                                iq_cmd,
                                stdout=subprocess.PIPE,
                                stderr=subprocess.DEVNULL,
                                bufsize=0,
                            )
                            register_process(iq_process)
                            # Brief check that process started
                            time.sleep(0.3)
                            if iq_process.poll() is not None:
                                unregister_process(iq_process)
                                iq_process = None
                                if attempt < max_attempts - 1:
                                    logger.info(
                                        f"I/Q process exited immediately, "
                                        f"retrying ({attempt + 1}/{max_attempts})..."
                                    )
                                    time.sleep(0.5)
                                    continue
                                raise RuntimeError(
                                    "I/Q capture process exited immediately"
                                )
                            break  # Process started successfully
                    except Exception as e:
                        logger.error(f"Failed to start I/Q capture: {e}")
                        if iq_process:
                            safe_terminate(iq_process)
                            unregister_process(iq_process)
                            iq_process = None
                        app_module.release_sdr_device(device_index)
                        claimed_device = None
                        ws.send(json.dumps({
                            'status': 'error',
                            'message': f'Failed to start I/Q capture: {e}',
                        }))
                        continue
                    # Send started confirmation
                    ws.send(json.dumps({
                        'status': 'started',
                        'start_freq': start_freq,
                        'end_freq': end_freq,
                        'fft_size': fft_size,
                        'sample_rate': sample_rate,
                    }))
                    # Start reader thread — puts frames on queue, never calls ws.send()
                    def fft_reader(
                        proc, _send_q, stop_evt,
                        _fft_size, _avg_count, _fps,
                        _start_freq, _end_freq,
                    ):
                        """Read I/Q from subprocess, compute FFT, enqueue binary frames."""
                        bytes_per_frame = _fft_size * _avg_count * 2
                        frame_interval = 1.0 / _fps
                        try:
                            while not stop_evt.is_set():
                                if proc.poll() is not None:
                                    break
                                frame_start = time.monotonic()
                                # Read raw I/Q bytes
                                raw = b''
                                remaining = bytes_per_frame
                                while remaining > 0 and not stop_evt.is_set():
                                    chunk = proc.stdout.read(min(remaining, 65536))
                                    if not chunk:
                                        break
                                    raw += chunk
                                    remaining -= len(chunk)
                                if len(raw) < _fft_size * 2:
                                    break
                                # Process FFT pipeline
                                samples = cu8_to_complex(raw)
                                power_db = compute_power_spectrum(
                                    samples,
                                    fft_size=_fft_size,
                                    avg_count=_avg_count,
                                )
                                quantized = quantize_to_uint8(power_db)
                                frame = build_binary_frame(
                                    _start_freq, _end_freq, quantized,
                                )
                                try:
                                    _send_q.put_nowait(frame)
                                except queue.Full:
                                    # Drop frame if main loop can't keep up
                                    pass
                                # Pace to target FPS
                                elapsed = time.monotonic() - frame_start
                                sleep_time = frame_interval - elapsed
                                if sleep_time > 0:
                                    stop_evt.wait(sleep_time)
                        except Exception as e:
                            logger.debug(f"FFT reader stopped: {e}")
                    reader_thread = threading.Thread(
                        target=fft_reader,
                        args=(
                            iq_process, send_queue, stop_event,
                            fft_size, avg_count, fps,
                            start_freq, end_freq,
                        ),
                        daemon=True,
                    )
                    reader_thread.start()
                elif cmd == 'stop':
                    stop_event.set()
                    if reader_thread and reader_thread.is_alive():
                        reader_thread.join(timeout=2)
                        reader_thread = None
                    if iq_process:
                        safe_terminate(iq_process)
                        unregister_process(iq_process)
                        iq_process = None
                    if claimed_device is not None:
                        app_module.release_sdr_device(claimed_device)
                        claimed_device = None
                    stop_event.clear()
                    ws.send(json.dumps({'status': 'stopped'}))
        except Exception as e:
            logger.info(f"WebSocket waterfall closed: {e}")
-        finally:
+        finally:
-            # Cleanup
+            # Cleanup
-            stop_event.set()
+            stop_event.set()
-            if reader_thread and reader_thread.is_alive():
+            if reader_thread and reader_thread.is_alive():
-                reader_thread.join(timeout=2)
+                reader_thread.join(timeout=2)
            if iq_process:
                safe_terminate(iq_process)
                unregister_process(iq_process)
-            if claimed_device is not None:
+            if claimed_device is not None:
-                app_module.release_sdr_device(claimed_device)
+                app_module.release_sdr_device(claimed_device)
-            # Complete WebSocket close handshake, then shut down the
+            _set_shared_capture_state(running=False)
-            # raw socket so Werkzeug cannot write its HTTP 200 response
+            # Complete WebSocket close handshake, then shut down the
            # raw socket so Werkzeug cannot write its HTTP 200 response
            # on top of the WebSocket stream (which browsers see as
            # "Invalid frame header").
-            try:
+            with suppress(Exception):
-                ws.close()
+                ws.close()
-            except Exception:
+            with suppress(Exception):
-                pass
+                ws.sock.shutdown(socket.SHUT_RDWR)
-            try:
+            with suppress(Exception):
-                ws.sock.shutdown(socket.SHUT_RDWR)
+                ws.sock.close()
-            except Exception:
+            logger.info("WebSocket waterfall client disconnected")
                pass
            try:
                ws.sock.close()
            except Exception:
                pass
            logger.info("WebSocket waterfall client disconnected")
@@ -563,19 +563,26 @@ def enable_schedule():
            'message': 'Invalid parameter value'
        }), 400
-    scheduler = get_weather_sat_scheduler()
+    scheduler = get_weather_sat_scheduler()
-    scheduler.set_callbacks(_progress_callback, _scheduler_event_callback)
+    scheduler.set_callbacks(_progress_callback, _scheduler_event_callback)
-
+
-    result = scheduler.enable(
+    try:
-        lat=lat,
+        result = scheduler.enable(
-        lon=lon,
+            lat=lat,
-        min_elevation=min_elev,
+            lon=lon,
-        device=device,
+            min_elevation=min_elev,
-        gain=gain_val,
+            device=device,
-        bias_t=bool(data.get('bias_t', False)),
+            gain=gain_val,
-    )
+            bias_t=bool(data.get('bias_t', False)),
-
+        )
-    return jsonify({'status': 'ok', **result})
+    except Exception as e:
        logger.exception("Failed to enable weather sat scheduler")
        return jsonify({
            'status': 'error',
            'message': 'Failed to enable scheduler'
        }), 500
    return jsonify({'status': 'ok', **result})
@weather_sat_bp.route('/schedule/disable', methods=['POST'])
@@ -20,7 +20,7 @@ from utils.dependencies import check_tool, get_tool_path
 from utils.logging import wifi_logger as logger
 from utils.process import is_valid_mac, is_valid_channel
 from utils.validation import validate_wifi_channel, validate_mac_address, validate_network_interface
-from utils.sse import format_sse
+from utils.sse import format_sse, sse_stream_fanout
 from utils.event_pipeline import process_event
 from data.oui import get_manufacturer
 from utils.constants import (
@@ -1132,33 +1132,26 @@ def get_wifi_networks():
    })
-@wifi_bp.route('/stream')
+@wifi_bp.route('/stream')
-def stream_wifi():
+def stream_wifi():
-    """SSE stream for WiFi events."""
+    """SSE stream for WiFi events."""
-    def generate():
+    def _on_msg(msg: dict[str, Any]) -> None:
-        last_keepalive = time.time()
+        process_event('wifi', msg, msg.get('type'))
-        keepalive_interval = 30.0
+
-
+    response = Response(
-        while True:
+        sse_stream_fanout(
-            try:
+            source_queue=app_module.wifi_queue,
-                msg = app_module.wifi_queue.get(timeout=1)
+            channel_key='wifi',
-                last_keepalive = time.time()
+            timeout=1.0,
-                try:
+            keepalive_interval=30.0,
-                    process_event('wifi', msg, msg.get('type'))
+            on_message=_on_msg,
-                except Exception:
+        ),
-                    pass
+        mimetype='text/event-stream',
-                yield format_sse(msg)
+    )
-            except queue.Empty:
+    response.headers['Cache-Control'] = 'no-cache'
-                now = time.time()
+    response.headers['X-Accel-Buffering'] = 'no'
-                if now - last_keepalive >= keepalive_interval:
+    response.headers['Connection'] = 'keep-alive'
-                    yield format_sse({'type': 'keepalive'})
+    return response
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
    return response
 # =============================================================================
@@ -1545,8 +1538,8 @@ def v2_deauth_status():
        return jsonify({'error': str(e)}), 500
-@wifi_bp.route('/v2/deauth/stream')
+@wifi_bp.route('/v2/deauth/stream')
-def v2_deauth_stream():
+def v2_deauth_stream():
    """
    SSE stream for real-time deauth alerts.
@@ -1557,26 +1550,18 @@ def v2_deauth_stream():
        - deauth_error: An error occurred
        - keepalive: Periodic keepalive
    """
-    def generate():
+    response = Response(
-        last_keepalive = time.time()
+        sse_stream_fanout(
-        keepalive_interval = SSE_KEEPALIVE_INTERVAL
+            source_queue=app_module.deauth_detector_queue,
-
+            channel_key='wifi_deauth',
-        while True:
+            timeout=SSE_QUEUE_TIMEOUT,
-            try:
+            keepalive_interval=SSE_KEEPALIVE_INTERVAL,
-                # Try to get from the dedicated deauth queue
+        ),
-                msg = app_module.deauth_detector_queue.get(timeout=SSE_QUEUE_TIMEOUT)
+        mimetype='text/event-stream',
-                last_keepalive = time.time()
+    )
-                yield format_sse(msg)
+    response.headers['Cache-Control'] = 'no-cache'
-            except queue.Empty:
+    response.headers['X-Accel-Buffering'] = 'no'
-                now = time.time()
+    response.headers['Connection'] = 'keep-alive'
                if now - last_keepalive >= keepalive_interval:
                    yield format_sse({'type': 'keepalive'})
                    last_keepalive = now
    response = Response(generate(), mimetype='text/event-stream')
    response.headers['Cache-Control'] = 'no-cache'
    response.headers['X-Accel-Buffering'] = 'no'
    response.headers['Connection'] = 'keep-alive'
    return response
@@ -137,6 +137,14 @@ need_sudo() {
  fi
 }
 # Refresh sudo credential cache so long-running builds don't trigger
 # mid-compilation password prompts (which can fail due to TTY issues
 # inside subshells). Safe to call multiple times.
 refresh_sudo() {
  [[ -z "${SUDO:-}" ]] && return 0
  sudo -v 2>/dev/null || true
 }
 detect_os() {
  if [[ "${OSTYPE:-}" == "darwin"* ]]; then
    OS="macos"
@@ -218,16 +226,13 @@ check_tools() {
  check_optional "hackrf_sweep"    "HackRF spectrum analyzer" hackrf_sweep
  check_required "dump1090"    "ADS-B decoder" dump1090
  check_required "acarsdec"    "ACARS decoder" acarsdec
  check_optional "dumpvdl2"    "VDL2 decoder" dumpvdl2
  check_required "AIS-catcher" "AIS vessel decoder" AIS-catcher aiscatcher
  check_optional "satdump" "Weather satellite decoder (NOAA/Meteor)" satdump
  echo
  info "GPS:"
  check_required "gpsd" "GPS daemon" gpsd
  echo
  info "Digital Voice:"
  check_optional "dsd" "Digital Speech Decoder (DMR/P25)" dsd dsd-fme
  echo
  info "Audio:"
  check_required "ffmpeg" "Audio encoder/decoder" ffmpeg
@@ -304,28 +309,40 @@ install_python_deps() {
  # shellcheck disable=SC1091
  source venv/bin/activate
  local PIP="venv/bin/python -m pip"
  local PY="venv/bin/python"
-  python -m pip install --upgrade pip setuptools wheel >/dev/null 2>&1 || true
+  $PIP install --upgrade pip setuptools wheel >/dev/null 2>&1 || true
  ok "Upgraded pip tooling"
  progress "Installing Python dependencies"
  # Try pip install, but don't fail if apt packages already satisfied deps
  if ! python -m pip install -r requirements.txt 2>/dev/null; then
    warn "Some pip packages failed - checking if apt packages cover them..."
    # Verify critical packages are available
    python -c "import flask; import requests; from flask_limiter import Limiter" 2>/dev/null || {
      fail "Critical Python packages (flask, requests, flask-limiter) not installed"
      echo "Try: pip install flask requests flask-limiter"
      exit 1
    }
    ok "Core Python dependencies available"
  else
    ok "Python dependencies installed"
  fi
-  # Ensure Flask 3.0+ is installed (required for Werkzeug 3.x compatibility)
+  # Install critical packages first to avoid all-or-nothing failures
-  # System apt packages may have older Flask 2.x which is incompatible
+  # (C extension packages like scipy/numpy can fail on newer Python versions
-  python -m pip install --upgrade "flask>=3.0.0" >/dev/null 2>&1 || true
+  #  and cause pip to roll back pure-Python packages like flask)
  info "Installing core packages..."
  $PIP install --quiet "flask>=3.0.0" "flask-limiter>=2.5.4" "requests>=2.28.0" \
    "Werkzeug>=3.1.5" "pyserial>=3.5" "flask-sock" "websocket-client>=1.6.0" 2>/dev/null || true
  # Verify critical packages
  $PY -c "import flask; import requests; from flask_limiter import Limiter" 2>/dev/null || {
    fail "Critical Python packages (flask, requests, flask-limiter) not installed"
    echo "Try: venv/bin/pip install flask requests flask-limiter"
    exit 1
  }
  ok "Core Python packages installed"
  # Install optional packages individually (some may fail on newer Python)
  info "Installing optional packages..."
  for pkg in "numpy>=1.24.0" "scipy>=1.10.0" "Pillow>=9.0.0" "skyfield>=1.45" \
             "bleak>=0.21.0" "psycopg2-binary>=2.9.9" "meshtastic>=2.0.0" \
             "scapy>=2.4.5" "qrcode[pil]>=7.4" "cryptography>=41.0.0"; do
    pkg_name="${pkg%%>=*}"
    if ! $PIP install "$pkg" 2>/dev/null; then
      warn "${pkg_name} failed to install (optional - related features may be unavailable)"
    fi
  done
  ok "Optional packages processed"
  echo
 }
@@ -388,7 +405,7 @@ install_rtlamr_from_source() {
        if [[ -w /usr/local/bin ]]; then
          ln -sf "$GOPATH/bin/rtlamr" /usr/local/bin/rtlamr
        else
-          sudo ln -sf "$GOPATH/bin/rtlamr" /usr/local/bin/rtlamr
+          $SUDO ln -sf "$GOPATH/bin/rtlamr" /usr/local/bin/rtlamr
        fi
      else
        $SUDO ln -sf "$GOPATH/bin/rtlamr" /usr/local/bin/rtlamr
@@ -430,99 +447,13 @@ install_multimon_ng_from_source_macos() {
    if [[ -w /usr/local/bin ]]; then
      install -m 0755 multimon-ng /usr/local/bin/multimon-ng
    else
-      sudo install -m 0755 multimon-ng /usr/local/bin/multimon-ng
+      refresh_sudo
      $SUDO install -m 0755 multimon-ng /usr/local/bin/multimon-ng
    fi
    ok "multimon-ng installed successfully from source"
  )
 }
 install_dsd_from_source() {
  info "Building DSD (Digital Speech Decoder) from source..."
  info "This requires mbelib (vocoder library) as a prerequisite."
  if [[ "$OS" == "macos" ]]; then
    brew_install cmake
    brew_install libsndfile
    brew_install ncurses
    brew_install fftw
    brew_install codec2
    brew_install librtlsdr
    brew_install pulseaudio || true
  else
    apt_install build-essential git cmake libsndfile1-dev libpulse-dev \
      libfftw3-dev liblapack-dev libncurses-dev librtlsdr-dev libcodec2-dev
  fi
  (
    tmp_dir="$(mktemp -d)"
    trap 'rm -rf "$tmp_dir"' EXIT
    # Step 1: Build and install mbelib (required dependency)
    info "Building mbelib (vocoder library)..."
    git clone https://github.com/lwvmobile/mbelib.git "$tmp_dir/mbelib" >/dev/null 2>&1 \
      || { warn "Failed to clone mbelib"; exit 1; }
    cd "$tmp_dir/mbelib"
    git checkout ambe_tones >/dev/null 2>&1 || true
    mkdir -p build && cd build
    if cmake .. >/dev/null 2>&1 && make -j "$(nproc 2>/dev/null || sysctl -n hw.ncpu)" >/dev/null 2>&1; then
      if [[ "$OS" == "macos" ]]; then
        if [[ -w /usr/local/lib ]]; then
          make install >/dev/null 2>&1
        else
          sudo make install >/dev/null 2>&1
        fi
      else
        $SUDO make install >/dev/null 2>&1
        $SUDO ldconfig 2>/dev/null || true
      fi
      ok "mbelib installed"
    else
      warn "Failed to build mbelib. Cannot build DSD without it."
      exit 1
    fi
    # Step 2: Build dsd-fme (or fall back to original dsd)
    info "Building dsd-fme..."
    git clone --depth 1 https://github.com/lwvmobile/dsd-fme.git "$tmp_dir/dsd-fme" >/dev/null 2>&1 \
      || { warn "Failed to clone dsd-fme, trying original DSD...";
           git clone --depth 1 https://github.com/szechyjs/dsd.git "$tmp_dir/dsd-fme" >/dev/null 2>&1 \
             || { warn "Failed to clone DSD"; exit 1; }; }
    cd "$tmp_dir/dsd-fme"
    mkdir -p build && cd build
    # On macOS, help cmake find Homebrew ncurses
    local cmake_flags=""
    if [[ "$OS" == "macos" ]]; then
      local ncurses_prefix
      ncurses_prefix="$(brew --prefix ncurses 2>/dev/null || echo /opt/homebrew/opt/ncurses)"
      cmake_flags="-DCMAKE_PREFIX_PATH=$ncurses_prefix"
    fi
    info "Compiling DSD..."
    if cmake .. $cmake_flags >/dev/null 2>&1 && make -j "$(nproc 2>/dev/null || sysctl -n hw.ncpu)" >/dev/null 2>&1; then
      if [[ "$OS" == "macos" ]]; then
        if [[ -w /usr/local/bin ]]; then
          install -m 0755 dsd-fme /usr/local/bin/dsd 2>/dev/null || install -m 0755 dsd /usr/local/bin/dsd 2>/dev/null || true
        else
          sudo install -m 0755 dsd-fme /usr/local/bin/dsd 2>/dev/null || sudo install -m 0755 dsd /usr/local/bin/dsd 2>/dev/null || true
        fi
      else
        $SUDO make install >/dev/null 2>&1 \
          || $SUDO install -m 0755 dsd-fme /usr/local/bin/dsd 2>/dev/null \
          || $SUDO install -m 0755 dsd /usr/local/bin/dsd 2>/dev/null \
          || true
        $SUDO ldconfig 2>/dev/null || true
      fi
      ok "DSD installed successfully"
    else
      warn "Failed to build DSD from source. DMR/P25 decoding will not be available."
    fi
  )
 }
 install_dump1090_from_source_macos() {
  info "dump1090 not available via Homebrew. Building from source..."
@@ -545,7 +476,8 @@ install_dump1090_from_source_macos() {
      if [[ -w /usr/local/bin ]]; then
        install -m 0755 dump1090 /usr/local/bin/dump1090
      else
-        sudo install -m 0755 dump1090 /usr/local/bin/dump1090
+        refresh_sudo
        $SUDO install -m 0755 dump1090 /usr/local/bin/dump1090
      fi
      ok "dump1090 installed successfully from source"
    else
@@ -571,18 +503,129 @@ install_acarsdec_from_source_macos() {
      || { warn "Failed to clone acarsdec"; exit 1; }
    cd "$tmp_dir/acarsdec"
    # Fix compiler flags for macOS Apple Silicon (ARM64)
    # -march=native can fail with Apple Clang on M-series chips
    # -Ofast is deprecated in modern Clang
    if [[ "$(uname -m)" == "arm64" ]]; then
      sed -i '' 's/-Ofast -march=native/-O3 -ffast-math/g' CMakeLists.txt
      info "Patched compiler flags for Apple Silicon (arm64)"
    fi
    # Fix pthread_tryjoin_np (Linux-only GNU extension) for macOS
    # Replace with pthread_join which provides equivalent behavior
    if grep -q 'pthread_tryjoin_np' rtl.c 2>/dev/null; then
      sed -i '' 's/pthread_tryjoin_np(\([^,]*\), NULL)/pthread_join(\1, NULL)/g' rtl.c
      info "Patched pthread_tryjoin_np for macOS compatibility"
    fi
    # Fix libacars linking on macOS (upstream issue #112)
    # Use LIBACARS_LINK_LIBRARIES (full path) instead of LIBACARS_LIBRARIES (name only)
    if grep -q 'LIBACARS_LIBRARIES' CMakeLists.txt 2>/dev/null; then
      sed -i '' 's/${LIBACARS_LIBRARIES}/${LIBACARS_LINK_LIBRARIES}/g' CMakeLists.txt
      info "Patched libacars linking for macOS"
    fi
    mkdir -p build && cd build
    # Set Homebrew paths for Apple Silicon (/opt/homebrew) or Intel (/usr/local)
    HOMEBREW_PREFIX="$(brew --prefix)"
    export PKG_CONFIG_PATH="${HOMEBREW_PREFIX}/lib/pkgconfig:${PKG_CONFIG_PATH:-}"
    export CMAKE_PREFIX_PATH="${HOMEBREW_PREFIX}"
    info "Compiling acarsdec..."
-    if cmake .. -Drtl=ON >/dev/null 2>&1 && make >/dev/null 2>&1; then
+    build_log="$tmp_dir/acarsdec-build.log"
    if cmake .. -Drtl=ON \
         -DCMAKE_POLICY_VERSION_MINIMUM=3.5 \
         -DCMAKE_C_FLAGS="-I${HOMEBREW_PREFIX}/include" \
         -DCMAKE_EXE_LINKER_FLAGS="-L${HOMEBREW_PREFIX}/lib" \
         >"$build_log" 2>&1 \
       && make >>"$build_log" 2>&1; then
      if [[ -w /usr/local/bin ]]; then
        install -m 0755 acarsdec /usr/local/bin/acarsdec
      else
-        sudo install -m 0755 acarsdec /usr/local/bin/acarsdec
+        refresh_sudo
        $SUDO install -m 0755 acarsdec /usr/local/bin/acarsdec
      fi
      ok "acarsdec installed successfully from source"
    else
      warn "Failed to build acarsdec. ACARS decoding will not be available."
      warn "Build log (last 30 lines):"
      tail -30 "$build_log" | while IFS= read -r line; do warn "  $line"; done
    fi
  )
 }
 install_dumpvdl2_from_source_macos() {
  info "Building dumpvdl2 from source (with libacars dependency)..."
  brew_install cmake
  brew_install librtlsdr
  brew_install pkg-config
  brew_install glib
  (
    tmp_dir="$(mktemp -d)"
    trap 'rm -rf "$tmp_dir"' EXIT
    HOMEBREW_PREFIX="$(brew --prefix)"
    export PKG_CONFIG_PATH="${HOMEBREW_PREFIX}/lib/pkgconfig:${PKG_CONFIG_PATH:-}"
    export CMAKE_PREFIX_PATH="${HOMEBREW_PREFIX}"
    # Build libacars first
    info "Cloning libacars..."
    git clone --depth 1 https://github.com/szpajder/libacars.git "$tmp_dir/libacars" >/dev/null 2>&1 \
      || { warn "Failed to clone libacars"; exit 1; }
    cd "$tmp_dir/libacars"
    mkdir -p build && cd build
    info "Compiling libacars..."
    build_log="$tmp_dir/libacars-build.log"
    if cmake .. \
         -DCMAKE_C_FLAGS="-I${HOMEBREW_PREFIX}/include" \
         -DCMAKE_EXE_LINKER_FLAGS="-L${HOMEBREW_PREFIX}/lib" \
         >"$build_log" 2>&1 \
       && make >>"$build_log" 2>&1; then
      if [[ -w /usr/local/lib ]]; then
        make install >>"$build_log" 2>&1
      else
        refresh_sudo
        $SUDO make install >>"$build_log" 2>&1
      fi
      ok "libacars installed"
    else
      warn "Failed to build libacars."
      tail -20 "$build_log" | while IFS= read -r line; do warn "  $line"; done
      exit 1
    fi
    # Build dumpvdl2
    info "Cloning dumpvdl2..."
    git clone --depth 1 https://github.com/szpajder/dumpvdl2.git "$tmp_dir/dumpvdl2" >/dev/null 2>&1 \
      || { warn "Failed to clone dumpvdl2"; exit 1; }
    cd "$tmp_dir/dumpvdl2"
    mkdir -p build && cd build
    info "Compiling dumpvdl2..."
    build_log="$tmp_dir/dumpvdl2-build.log"
    if cmake .. \
         -DCMAKE_C_FLAGS="-I${HOMEBREW_PREFIX}/include" \
         -DCMAKE_EXE_LINKER_FLAGS="-L${HOMEBREW_PREFIX}/lib" \
         >"$build_log" 2>&1 \
       && make >>"$build_log" 2>&1; then
      if [[ -w /usr/local/bin ]]; then
        install -m 0755 src/dumpvdl2 /usr/local/bin/dumpvdl2
      else
        refresh_sudo
        $SUDO install -m 0755 src/dumpvdl2 /usr/local/bin/dumpvdl2
      fi
      ok "dumpvdl2 installed successfully from source"
    else
      warn "Failed to build dumpvdl2. VDL2 decoding will not be available."
      warn "Build log (last 30 lines):"
      tail -30 "$build_log" | while IFS= read -r line; do warn "  $line"; done
    fi
  )
 }
@@ -611,7 +654,8 @@ install_aiscatcher_from_source_macos() {
      if [[ -w /usr/local/bin ]]; then
        install -m 0755 AIS-catcher /usr/local/bin/AIS-catcher
      else
-        sudo install -m 0755 AIS-catcher /usr/local/bin/AIS-catcher
+        refresh_sudo
        $SUDO install -m 0755 AIS-catcher /usr/local/bin/AIS-catcher
      fi
      ok "AIS-catcher installed successfully from source"
    else
@@ -623,11 +667,23 @@ install_aiscatcher_from_source_macos() {
 install_satdump_from_source_debian() {
  info "Building SatDump v1.2.2 from source (weather satellite decoder)..."
  # Core deps — hard-fail if missing
  apt_install build-essential git cmake pkg-config \
-    libpng-dev libtiff-dev libjemalloc-dev libvolk-dev libnng-dev \
+    libpng-dev libtiff-dev libzstd-dev \
    libzstd-dev libsoapysdr-dev libhackrf-dev liblimesuite-dev \
    libsqlite3-dev libcurl4-openssl-dev zlib1g-dev libzmq3-dev libfftw3-dev
  # libvolk: package name differs between distros
  #   Ubuntu / Debian Trixie+: libvolk-dev
  #   Raspberry Pi OS Bookworm / Debian Bookworm: libvolk2-dev
  apt_try_install_any libvolk-dev libvolk2-dev \
    || warn "libvolk not found — SatDump will build without VOLK acceleration"
  # Optional SDR hardware libs — soft-fail so missing hardware doesn't abort
  for pkg in libjemalloc-dev libnng-dev libsoapysdr-dev libhackrf-dev liblimesuite-dev; do
    $SUDO apt-get install -y --no-install-recommends "$pkg" >/dev/null 2>&1 \
      || warn "${pkg} not available — skipping (SatDump can build without it)"
  done
  # Run in subshell to isolate EXIT trap
  (
    tmp_dir="$(mktemp -d)"
@@ -638,11 +694,42 @@ install_satdump_from_source_debian() {
      || { warn "Failed to clone SatDump"; exit 1; }
    cd "$tmp_dir/SatDump"
    # Patch: fix deprecated std::allocator usage for newer compilers
    # GCC 13+ errors on deprecated allocator members in sol2.
    # Pragmas must go in lua_utils.cpp (the instantiation site), not sol.hpp (definition site).
    lua_utils="src-core/common/lua/lua_utils.cpp"
    if [ -f "$lua_utils" ]; then
      {
        echo '#pragma GCC diagnostic push'
        echo '#pragma GCC diagnostic ignored "-Wdeprecated"'
        echo '#pragma GCC diagnostic ignored "-Wdeprecated-declarations"'
        cat "$lua_utils"
        echo  # ensure the file ends with a newline before the closing pragma
        echo '#pragma GCC diagnostic pop'
      } > "${lua_utils}.patched" && mv "${lua_utils}.patched" "$lua_utils"
    fi
    mkdir -p build && cd build
-    info "Compiling SatDump (this may take a while)..."
+    info "Compiling SatDump (this is a large C++ project and may take 10-30 minutes)..."
-    if cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_GUI=OFF -DCMAKE_INSTALL_LIBDIR=lib .. >/dev/null 2>&1 \
+    build_log="$tmp_dir/satdump-build.log"
-        && make -j "$(nproc)" >/dev/null 2>&1; then
+
    # Show periodic progress while building so the user knows it's not hung
    (
      while true; do
        sleep 30
        if [ -f "$build_log" ]; then
          local_lines=$(wc -l < "$build_log" 2>/dev/null || echo 0)
          printf "  [*] Still compiling SatDump... (%s lines of build output so far)\n" "$local_lines"
        fi
      done
    ) &
    progress_pid=$!
    if cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_GUI=OFF -DCMAKE_INSTALL_LIBDIR=lib .. >"$build_log" 2>&1 \
        && make -j "$(nproc)" >>"$build_log" 2>&1; then
      kill $progress_pid 2>/dev/null; wait $progress_pid 2>/dev/null
      $SUDO make install >/dev/null 2>&1
      $SUDO ldconfig
@@ -659,54 +746,86 @@ install_satdump_from_source_debian() {
      ok "SatDump installed successfully."
    else
      kill $progress_pid 2>/dev/null; wait $progress_pid 2>/dev/null
      warn "Failed to build SatDump from source. Weather satellite decoding will not be available."
      warn "Build log (last 30 lines):"
      tail -30 "$build_log" | while IFS= read -r line; do warn "  $line"; done
    fi
  )
 }
-install_satdump_from_source_macos() {
+install_satdump_macos() {
-  info "Building SatDump v1.2.2 from source (weather satellite decoder)..."
+  info "Installing SatDump v1.2.2 from pre-built release (weather satellite decoder)..."
-  brew_install cmake
+  # Determine architecture
-  brew_install libpng
+  local arch
-  brew_install libtiff
+  arch="$(uname -m)"
-  brew_install jemalloc
+  local dmg_name
-  brew_install libvolk
+  if [ "$arch" = "arm64" ]; then
-  brew_install nng
+    dmg_name="SatDump-macOS-Silicon.dmg"
-  brew_install zstd
+  else
-  brew_install soapysdr
+    dmg_name="SatDump-macOS-Intel.dmg"
-  brew_install hackrf
+  fi
-  brew_install fftw
+
  local dmg_url="https://github.com/SatDump/SatDump/releases/download/1.2.2/${dmg_name}"
  local install_dir="/usr/local/lib/satdump"
  # Run in subshell to isolate EXIT trap
  (
    tmp_dir="$(mktemp -d)"
-    trap 'rm -rf "$tmp_dir"' EXIT
+    trap 'hdiutil detach "$tmp_dir/mnt" -quiet 2>/dev/null || true; rm -rf "$tmp_dir"' EXIT
-    info "Cloning SatDump v1.2.2..."
+    info "Downloading ${dmg_name}..."
-    git clone --depth 1 --branch 1.2.2 https://github.com/SatDump/SatDump.git "$tmp_dir/SatDump" >/dev/null 2>&1 \
+    if ! curl -sL -o "$tmp_dir/satdump.dmg" "$dmg_url"; then
-      || { warn "Failed to clone SatDump"; exit 1; }
+      warn "Failed to download SatDump. Weather satellite decoding will not be available."
      exit 1
    fi
-    cd "$tmp_dir/SatDump"
+    info "Installing SatDump..."
-    mkdir -p build && cd build
+    # Mount the DMG
    hdiutil attach "$tmp_dir/satdump.dmg" -nobrowse -quiet -mountpoint "$tmp_dir/mnt" \
      || { warn "Failed to mount SatDump DMG"; exit 1; }
-    info "Compiling SatDump (this may take a while)..."
+    local app_dir="$tmp_dir/mnt/SatDump.app"
-    if cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_GUI=OFF .. >/dev/null 2>&1 \
+    if [ ! -d "$app_dir" ]; then
-        && make -j "$(sysctl -n hw.ncpu)" >/dev/null 2>&1; then
+      warn "SatDump.app not found in DMG"
-      if [[ -w /usr/local/bin ]]; then
+      exit 1
-        make install >/dev/null 2>&1
+    fi
-      else
+
-        sudo make install >/dev/null 2>&1
+    # Install: copy app contents to /usr/local/lib/satdump
-      fi
+    refresh_sudo
-      ok "SatDump installed successfully."
+    $SUDO mkdir -p "$install_dir"
    $SUDO cp -R "$app_dir/Contents/MacOS/"* "$install_dir/"
    $SUDO cp -R "$app_dir/Contents/Resources/"* "$install_dir/"
    # Create wrapper script so satdump can find its resources via @executable_path
    $SUDO tee /usr/local/bin/satdump >/dev/null <<'WRAPPER'
 #!/bin/sh
 exec /usr/local/lib/satdump/satdump "$@"
 WRAPPER
    $SUDO chmod +x /usr/local/bin/satdump
    hdiutil detach "$tmp_dir/mnt" -quiet 2>/dev/null
    # Verify installation
    if /usr/local/lib/satdump/satdump 2>&1 | grep -q "Usage"; then
      ok "SatDump v1.2.2 installed successfully."
    else
-      warn "Failed to build SatDump from source. Weather satellite decoding will not be available."
+      warn "SatDump installed but may not work correctly."
    fi
  )
 }
 install_macos_packages() {
-  TOTAL_STEPS=19
+  need_sudo
  # Prime sudo credentials upfront so builds don't prompt mid-compilation
  if [[ -n "${SUDO:-}" ]]; then
    info "Some tools require sudo to install. You may be prompted for your password."
    sudo -v || { fail "sudo authentication failed"; exit 1; }
  fi
  TOTAL_STEPS=21
  CURRENT_STEP=0
  progress "Checking Homebrew"
@@ -729,19 +848,6 @@ install_macos_packages() {
  progress "SSTV decoder"
  ok "SSTV uses built-in pure Python decoder (no external tools needed)"
  progress "Installing DSD (Digital Speech Decoder, optional)"
  if ! cmd_exists dsd && ! cmd_exists dsd-fme; then
    echo
    info "DSD is used for DMR, P25, NXDN, and D-STAR digital voice decoding."
    if ask_yes_no "Do you want to install DSD?"; then
      install_dsd_from_source || warn "DSD build failed. DMR/P25 decoding will not be available."
    else
      warn "Skipping DSD installation. DMR/P25 decoding will not be available."
    fi
  else
    ok "DSD already installed"
  fi
  progress "Installing ffmpeg"
  brew_install ffmpeg
@@ -779,6 +885,13 @@ install_macos_packages() {
    ok "acarsdec already installed"
  fi
  progress "Installing dumpvdl2"
  if ! cmd_exists dumpvdl2; then
    install_dumpvdl2_from_source_macos || warn "dumpvdl2 not available. VDL2 decoding will not be available."
  else
    ok "dumpvdl2 already installed"
  fi
  progress "Installing AIS-catcher"
  if ! cmd_exists AIS-catcher && ! cmd_exists aiscatcher; then
    (brew_install aiscatcher) || install_aiscatcher_from_source_macos || warn "AIS-catcher not available"
@@ -791,7 +904,7 @@ install_macos_packages() {
    echo
    info "SatDump is used for weather satellite imagery (NOAA APT & Meteor LRPT)."
    if ask_yes_no "Do you want to install SatDump?"; then
-      install_satdump_from_source_macos || warn "SatDump build failed. Weather satellite decoding will not be available."
+      install_satdump_macos || warn "SatDump installation failed. Weather satellite decoding will not be available."
    else
      warn "Skipping SatDump installation. You can install it later if needed."
    fi
@@ -872,10 +985,13 @@ install_dump1090_from_source_debian() {
    librtlsdr-dev libusb-1.0-0-dev \
    libncurses-dev tcl-dev python3-dev
  local JOBS
  JOBS="$(nproc 2>/dev/null || echo 1)"
  # Run in subshell to isolate EXIT trap
  (
    tmp_dir="$(mktemp -d)"
-    trap 'rm -rf "$tmp_dir"' EXIT
+    trap '{ [[ -n "${progress_pid:-}" ]] && kill "$progress_pid" 2>/dev/null && wait "$progress_pid" 2>/dev/null || true; }; rm -rf "$tmp_dir"' EXIT
    info "Cloning FlightAware dump1090..."
    git clone --depth 1 https://github.com/flightaware/dump1090.git "$tmp_dir/dump1090" >/dev/null 2>&1 \
@@ -883,23 +999,45 @@ install_dump1090_from_source_debian() {
    cd "$tmp_dir/dump1090"
    # Remove -Werror to prevent build failures on newer GCC versions
-    sed -i 's/-Werror//g' Makefile 2>/dev/null || sed -i '' 's/-Werror//g' Makefile
+    sed -i 's/-Werror//g' Makefile 2>/dev/null || true
-    info "Compiling FlightAware dump1090..."
+    info "Compiling FlightAware dump1090 (using ${JOBS} CPU cores)..."
-    if make BLADERF=no RTLSDR=yes >/dev/null 2>&1; then
+    build_log="$tmp_dir/dump1090-build.log"
    (while true; do sleep 20; printf "  [*] Still compiling dump1090...\n"; done) &
    progress_pid=$!
    if make -j "$JOBS" BLADERF=no RTLSDR=yes >"$build_log" 2>&1; then
      kill "$progress_pid" 2>/dev/null; wait "$progress_pid" 2>/dev/null || true; progress_pid=
      $SUDO install -m 0755 dump1090 /usr/local/bin/dump1090
      ok "dump1090 installed successfully (FlightAware)."
      exit 0
    fi
    kill "$progress_pid" 2>/dev/null; wait "$progress_pid" 2>/dev/null || true; progress_pid=
    warn "FlightAware build failed. Falling back to wiedehopf/readsb..."
    warn "Build log (last 20 lines):"
    tail -20 "$build_log" | while IFS= read -r line; do warn "  $line"; done
    rm -rf "$tmp_dir/dump1090"
    git clone --depth 1 https://github.com/wiedehopf/readsb.git "$tmp_dir/dump1090" >/dev/null 2>&1 \
      || { fail "Failed to clone wiedehopf/readsb"; exit 1; }
    cd "$tmp_dir/dump1090"
-    info "Compiling readsb..."
+    info "Compiling readsb (using ${JOBS} CPU cores)..."
-    make RTLSDR=yes >/dev/null 2>&1 || { fail "Failed to build readsb from source (required)."; exit 1; }
+    build_log="$tmp_dir/readsb-build.log"
    (while true; do sleep 20; printf "  [*] Still compiling readsb...\n"; done) &
    progress_pid=$!
    if ! make -j "$JOBS" RTLSDR=yes >"$build_log" 2>&1; then
      kill "$progress_pid" 2>/dev/null; wait "$progress_pid" 2>/dev/null || true; progress_pid=
      warn "Build log (last 20 lines):"
      tail -20 "$build_log" | while IFS= read -r line; do warn "  $line"; done
      fail "Failed to build readsb from source (required)."
      exit 1
    fi
    kill "$progress_pid" 2>/dev/null; wait "$progress_pid" 2>/dev/null || true; progress_pid=
    $SUDO install -m 0755 readsb /usr/local/bin/dump1090
    ok "dump1090 installed successfully (via readsb)."
  )
@@ -924,7 +1062,7 @@ install_acarsdec_from_source_debian() {
    mkdir -p build && cd build
    info "Compiling acarsdec..."
-    if cmake .. -Drtl=ON >/dev/null 2>&1 && make >/dev/null 2>&1; then
+    if cmake .. -Drtl=ON -DCMAKE_POLICY_VERSION_MINIMUM=3.5 >/dev/null 2>&1 && make >/dev/null 2>&1; then
      $SUDO install -m 0755 acarsdec /usr/local/bin/acarsdec
      ok "acarsdec installed successfully."
    else
@@ -933,6 +1071,52 @@ install_acarsdec_from_source_debian() {
  )
 }
 install_dumpvdl2_from_source_debian() {
  info "Building dumpvdl2 from source (with libacars dependency)..."
  apt_install build-essential git cmake \
    librtlsdr-dev libusb-1.0-0-dev libglib2.0-dev libxml2-dev
  (
    tmp_dir="$(mktemp -d)"
    trap 'rm -rf "$tmp_dir"' EXIT
    # Build libacars first
    info "Cloning libacars..."
    git clone --depth 1 https://github.com/szpajder/libacars.git "$tmp_dir/libacars" >/dev/null 2>&1 \
      || { warn "Failed to clone libacars"; exit 1; }
    cd "$tmp_dir/libacars"
    mkdir -p build && cd build
    info "Compiling libacars..."
    if cmake .. >/dev/null 2>&1 && make >/dev/null 2>&1; then
      $SUDO make install >/dev/null 2>&1
      $SUDO ldconfig
      ok "libacars installed"
    else
      warn "Failed to build libacars."
      exit 1
    fi
    # Build dumpvdl2
    info "Cloning dumpvdl2..."
    git clone --depth 1 https://github.com/szpajder/dumpvdl2.git "$tmp_dir/dumpvdl2" >/dev/null 2>&1 \
      || { warn "Failed to clone dumpvdl2"; exit 1; }
    cd "$tmp_dir/dumpvdl2"
    mkdir -p build && cd build
    info "Compiling dumpvdl2..."
    if cmake .. >/dev/null 2>&1 && make >/dev/null 2>&1; then
      $SUDO install -m 0755 src/dumpvdl2 /usr/local/bin/dumpvdl2
      ok "dumpvdl2 installed successfully."
    else
      warn "Failed to build dumpvdl2 from source. VDL2 decoding will not be available."
    fi
  )
 }
 install_aiscatcher_from_source_debian() {
  info "AIS-catcher not available via APT. Building from source..."
@@ -1025,6 +1209,17 @@ install_rtlsdr_blog_drivers_debian() {
        $SUDO udevadm trigger || true
      fi
      # Make the Blog drivers' library take priority over the apt-installed
      # librtlsdr.  Removing apt packages is too destructive (dump1090-mutability
      # and other tools depend on librtlsdr0 and get swept out).  Instead,
      # prepend /usr/local/lib to ldconfig's search path — files named 00-*
      # sort before the distro's aarch64-linux-gnu.conf — so ldconfig lists
      # /usr/local/lib/librtlsdr.so.0 first and the dynamic linker uses it.
      if [[ -d /etc/ld.so.conf.d ]]; then
        echo '/usr/local/lib' | $SUDO tee /etc/ld.so.conf.d/00-local-first.conf >/dev/null
      fi
      $SUDO ldconfig
      ok "RTL-SDR Blog drivers installed successfully."
      info "These drivers provide improved support for RTL-SDR Blog V4 and other devices."
      warn "Unplug and replug your RTL-SDR devices for the new drivers to take effect."
@@ -1034,6 +1229,7 @@ install_rtlsdr_blog_drivers_debian() {
      warn "See: https://github.com/rtlsdrblog/rtl-sdr-blog"
    fi
  )
 }
 setup_udev_rules_debian() {
@@ -1058,24 +1254,35 @@ blacklist_kernel_drivers_debian() {
  if [[ -f "$blacklist_file" ]]; then
    ok "RTL-SDR kernel driver blacklist already present"
-    return 0
+  else
-  fi
+    info "Blacklisting conflicting DVB kernel drivers..."
-
+    $SUDO tee "$blacklist_file" >/dev/null <<'EOF'
  info "Blacklisting conflicting DVB kernel drivers..."
  $SUDO tee "$blacklist_file" >/dev/null <<'EOF'
 # Blacklist DVB-T drivers to allow rtl-sdr to access RTL2832U devices
 blacklist dvb_usb_rtl28xxu
 blacklist rtl2832
 blacklist rtl2830
 blacklist r820t
 EOF
  fi
-  # Unload modules if currently loaded
+  # Always unload modules if currently loaded — this must happen even on
  # re-runs where the blacklist file already exists, since the modules may
  # still be live from the current boot (e.g. blacklist wasn't in initramfs).
  local unloaded=false
  for mod in dvb_usb_rtl28xxu rtl2832 rtl2830 r820t; do
    if lsmod | grep -q "^$mod"; then
      $SUDO modprobe -r "$mod" 2>/dev/null || true
      unloaded=true
    fi
  done
  $unloaded && info "Unloaded conflicting DVB kernel modules from current session."
  # Bake the blacklist into the initramfs so it survives reboots on
  # Raspberry Pi OS / Debian (without this the modules can reload on boot).
  if cmd_exists update-initramfs; then
    info "Updating initramfs to persist driver blacklist across reboots..."
    $SUDO update-initramfs -u >/dev/null 2>&1 || true
  fi
  ok "Kernel drivers blacklisted. Unplug/replug your RTL-SDR if connected."
  echo
@@ -1096,7 +1303,7 @@ install_debian_packages() {
    export NEEDRESTART_MODE=a
  fi
-  TOTAL_STEPS=26
+  TOTAL_STEPS=27
  CURRENT_STEP=0
  progress "Updating APT package lists"
@@ -1138,12 +1345,18 @@ install_debian_packages() {
  apt_install_if_missing rtl-sdr
-  progress "RTL-SDR Blog drivers"
+  progress "RTL-SDR Blog drivers (V4 support)"
-  if cmd_exists rtl_test; then
+  if $IS_DRAGONOS; then
-    ok "RTL-SDR drivers already installed"
+    info "DragonOS: skipping RTL-SDR Blog driver install (pre-configured)."
  else
-    info "RTL-SDR drivers not found, installing RTL-SDR Blog drivers..."
+    echo
-    install_rtlsdr_blog_drivers_debian
+    info "RTL-SDR Blog drivers add V4 (R828D tuner) support and bias-tee improvements."
    info "They are backward-compatible with all RTL-SDR devices."
    if ask_yes_no "Install RTL-SDR Blog drivers? (recommended for V4 users, safe for all)" "y"; then
      install_rtlsdr_blog_drivers_debian
    else
      warn "Skipping RTL-SDR Blog drivers. V4 devices may not work correctly."
    fi
  fi
  progress "Installing multimon-ng"
@@ -1155,19 +1368,6 @@ install_debian_packages() {
  progress "SSTV decoder"
  ok "SSTV uses built-in pure Python decoder (no external tools needed)"
  progress "Installing DSD (Digital Speech Decoder, optional)"
  if ! cmd_exists dsd && ! cmd_exists dsd-fme; then
    echo
    info "DSD is used for DMR, P25, NXDN, and D-STAR digital voice decoding."
    if ask_yes_no "Do you want to install DSD?"; then
      install_dsd_from_source || warn "DSD build failed. DMR/P25 decoding will not be available."
    else
      warn "Skipping DSD installation. DMR/P25 decoding will not be available."
    fi
  else
    ok "DSD already installed"
  fi
  progress "Installing ffmpeg"
  apt_install ffmpeg
@@ -1233,12 +1433,21 @@ install_debian_packages() {
  $SUDO apt-get install -y python3-bleak >/dev/null 2>&1 || true
  progress "Installing dump1090"
  # Remove any stale symlink left from a previous run where dump1090-mutability
  # was later uninstalled — cmd_exists finds the broken symlink and skips the
  # real install, leaving dump1090 seemingly present but non-functional.
  local dump1090_path
  dump1090_path="$(command -v dump1090 2>/dev/null || true)"
  if [[ -n "$dump1090_path" ]] && [[ ! -x "$dump1090_path" ]]; then
    info "Removing broken dump1090 symlink: $dump1090_path"
    $SUDO rm -f "$dump1090_path"
  fi
  if ! cmd_exists dump1090 && ! cmd_exists dump1090-mutability; then
    apt_try_install_any dump1090-fa dump1090-mutability dump1090 || true
  fi
  if ! cmd_exists dump1090; then
    if cmd_exists dump1090-mutability; then
-      $SUDO ln -s $(which dump1090-mutability) /usr/local/sbin/dump1090
+      $SUDO ln -s "$(which dump1090-mutability)" /usr/local/sbin/dump1090
    fi
  fi
  cmd_exists dump1090 || install_dump1090_from_source_debian
@@ -1249,6 +1458,13 @@ install_debian_packages() {
  fi
  cmd_exists acarsdec || install_acarsdec_from_source_debian
  progress "Installing dumpvdl2"
  if ! cmd_exists dumpvdl2; then
    install_dumpvdl2_from_source_debian || warn "dumpvdl2 not available. VDL2 decoding will not be available."
  else
    ok "dumpvdl2 already installed"
  fi
  progress "Installing AIS-catcher"
  if ! cmd_exists AIS-catcher && ! cmd_exists aiscatcher; then
    install_aiscatcher_from_source_debian
@@ -5,8 +5,8 @@
 }
 :root {
-    --font-sans: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-sans: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
-    --font-mono: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-mono: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
    --bg-dark: #0b1118;
    --bg-panel: #101823;
    --bg-card: #151f2b;
@@ -27,12 +27,36 @@
    --radar-bg: #101823;
 }
 [data-theme="light"] {
    --bg-dark: #f4f7fb;
    --bg-panel: #e9eef5;
    --bg-card: #ffffff;
    --border-color: #d1d9e6;
    --border-glow: #1f5fa8;
    --text-primary: #122034;
    --text-secondary: #3a4a5f;
    --text-dim: #6b7c93;
    --accent-green: #1f8a57;
    --accent-cyan: #1f5fa8;
    --accent-orange: #b5863a;
    --accent-red: #c74444;
    --accent-yellow: #b5863a;
    --accent-amber: #b5863a;
    --grid-line: rgba(31, 95, 168, 0.12);
    --noise-image: url("data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%20viewBox='0%200%2040%2040'%3E%3Cg%20fill='%23000000'%20fill-opacity='0.05'%3E%3Ccircle%20cx='3'%20cy='5'%20r='1'/%3E%3Ccircle%20cx='11'%20cy='9'%20r='1'/%3E%3Ccircle%20cx='18'%20cy='3'%20r='1'/%3E%3Ccircle%20cx='26'%20cy='12'%20r='1'/%3E%3Ccircle%20cx='34'%20cy='6'%20r='1'/%3E%3Ccircle%20cx='7'%20cy='19'%20r='1'/%3E%3Ccircle%20cx='15'%20cy='24'%20r='1'/%3E%3Ccircle%20cx='28'%20cy='22'%20r='1'/%3E%3Ccircle%20cx='36'%20cy='18'%20r='1'/%3E%3Ccircle%20cx='5'%20cy='33'%20r='1'/%3E%3Ccircle%20cx='19'%20cy='32'%20r='1'/%3E%3Ccircle%20cx='31'%20cy='34'%20r='1'/%3E%3C/g%3E%3C/svg%3E");
    --radar-cyan: #1f5fa8;
    --radar-bg: #e9eef5;
 }
 body {
    font-family: var(--font-sans);
    background: var(--bg-dark);
    color: var(--text-primary);
-    min-height: 100vh;
+    height: 100dvh;
-    overflow-x: hidden;
+    height: 100vh; /* Fallback */
    display: flex;
    flex-direction: column;
    overflow: hidden;
 }
 /* Animated radar sweep background */
@@ -227,16 +251,14 @@ body {
 }
 /* Main dashboard grid - Mobile first */
 /* Header ~52px + Nav 44px + Stats strip ~55px = ~151px, using 160px for safety */
 .dashboard {
    position: relative;
    z-index: 10;
    display: flex;
    flex-direction: column;
    gap: 0;
-    height: calc(100dvh - 160px);
+    flex: 1;
-    height: calc(100vh - 160px); /* Fallback */
+    min-height: 0;
    min-height: 400px;
 }
 /* Tablet: Two-column layout */
@@ -249,13 +271,29 @@ body {
    }
 }
-/* Desktop: Full layout with ACARS */
+/* Desktop: Full layout with ACARS/VDL2 + map + sidebar */
@media (min-width: 1024px) {
    .dashboard {
        grid-template-columns: auto 1fr 300px;
    }
 }
 /* Left sidebars wrapper (ACARS + VDL2) */
 .left-sidebars {
    display: none;
 }
@media (min-width: 1024px) {
    .left-sidebars {
        display: flex;
        flex-direction: row;
        grid-column: 1;
        grid-row: 1;
        height: 100%;
        overflow: hidden;
    }
 }
 /* ACARS sidebar (left of map) - Collapsible */
 .acars-sidebar {
    display: none;
@@ -267,12 +305,10 @@ body {
    min-height: 0;
 }
-/* Show ACARS sidebar on desktop */
+/* Show ACARS sidebar inside wrapper */
-@media (min-width: 1024px) {
+.left-sidebars .acars-sidebar {
-    .acars-sidebar {
+    display: flex;
-        display: flex;
+    height: 100%;
        max-height: calc(100dvh - 160px);
    }
 }
 .acars-collapse-btn {
@@ -419,6 +455,335 @@ body {
    to { opacity: 1; transform: translateY(0); }
 }
 /* VDL2 sidebar (left of map, after ACARS) - Collapsible */
 .vdl2-sidebar {
    display: none;
    background: var(--bg-panel);
    border-right: 1px solid var(--border-color);
    flex-direction: row;
    overflow: hidden;
    height: 100%;
    min-height: 0;
 }
 /* Show VDL2 sidebar inside wrapper */
 .left-sidebars .vdl2-sidebar {
    display: flex;
    height: 100%;
 }
 .vdl2-collapse-btn {
    width: 28px;
    min-width: 28px;
    background: var(--bg-card);
    border: none;
    border-left: 1px solid var(--border-color);
    color: var(--accent-cyan);
    cursor: pointer;
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    gap: 6px;
    padding: 8px 0;
    transition: background 0.2s;
 }
 .vdl2-collapse-btn:hover {
    background: rgba(74, 158, 255, 0.2);
 }
 .vdl2-collapse-label {
    writing-mode: vertical-rl;
    text-orientation: mixed;
    font-size: 9px;
    font-weight: 600;
    letter-spacing: 1px;
    text-transform: uppercase;
 }
 .vdl2-sidebar.collapsed .vdl2-collapse-label {
    display: block;
 }
 .vdl2-sidebar:not(.collapsed) .vdl2-collapse-label {
    display: none;
 }
 #vdl2CollapseIcon {
    font-size: 10px;
    transition: transform 0.3s;
 }
 .vdl2-sidebar.collapsed #vdl2CollapseIcon {
    transform: rotate(180deg);
 }
 .vdl2-sidebar-content {
    width: 300px;
    display: flex;
    flex-direction: column;
    overflow: hidden;
    transition: width 0.3s ease, opacity 0.2s ease;
    height: 100%;
    min-height: 0;
 }
 .vdl2-sidebar.collapsed .vdl2-sidebar-content {
    width: 0;
    opacity: 0;
    pointer-events: none;
 }
 .vdl2-sidebar .panel {
    flex: 1;
    display: flex;
    flex-direction: column;
    border: none;
    border-radius: 0;
    min-height: 0;
    overflow: hidden;
 }
 .vdl2-sidebar .panel::before {
    display: none;
 }
 .vdl2-sidebar .panel-header {
    flex-shrink: 0;
 }
 .vdl2-sidebar #vdl2PanelContent {
    display: flex;
    flex-direction: column;
    flex: 1;
    min-height: 0;
    overflow: hidden;
 }
 .vdl2-sidebar .vdl2-info,
 .vdl2-sidebar .vdl2-controls {
    flex-shrink: 0;
 }
 .vdl2-sidebar .vdl2-messages {
    flex: 1;
    overflow-y: auto;
    min-height: 0;
 }
 .vdl2-sidebar .vdl2-btn {
    background: var(--accent-green);
    border: none;
    color: #fff;
    padding: 6px 10px;
    font-size: 10px;
    font-weight: 600;
    cursor: pointer;
    transition: all 0.2s;
    text-transform: uppercase;
    letter-spacing: 1px;
    border-radius: 4px;
 }
 .vdl2-sidebar .vdl2-btn:hover {
    background: #1db954;
    box-shadow: 0 0 10px rgba(34, 197, 94, 0.3);
 }
 .vdl2-sidebar .vdl2-btn.active {
    background: var(--accent-red);
 }
 .vdl2-sidebar .vdl2-btn.active:hover {
    background: #dc2626;
    box-shadow: 0 0 10px rgba(239, 68, 68, 0.3);
 }
 .vdl2-message-item {
    padding: 8px 10px;
    border-bottom: 1px solid var(--border-color);
    font-size: 10px;
    animation: fadeIn 0.3s ease;
    cursor: pointer;
    transition: background 0.2s;
 }
 .vdl2-message-item:hover {
    background: rgba(74, 158, 255, 0.08);
 }
 /* VDL2 Message Modal */
 .vdl2-modal-overlay {
    position: fixed;
    inset: 0;
    background: rgba(0, 0, 0, 0.6);
    backdrop-filter: blur(4px);
    z-index: 10000;
    display: flex;
    align-items: center;
    justify-content: center;
    animation: vdl2ModalFadeIn 0.15s ease;
 }
@keyframes vdl2ModalFadeIn {
    from { opacity: 0; }
    to { opacity: 1; }
 }
 .vdl2-modal {
    background: var(--bg-panel, #1a1a2e);
    border: 1px solid var(--accent-cyan, #4a9eff);
    border-radius: 8px;
    width: 520px;
    max-width: 90vw;
    max-height: 80vh;
    display: flex;
    flex-direction: column;
    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.5), 0 0 1px var(--accent-cyan, #4a9eff);
    animation: vdl2ModalSlideIn 0.15s ease;
 }
@keyframes vdl2ModalSlideIn {
    from { opacity: 0; transform: scale(0.95) translateY(10px); }
    to { opacity: 1; transform: scale(1) translateY(0); }
 }
 .vdl2-modal-header {
    display: flex;
    justify-content: space-between;
    align-items: center;
    padding: 14px 18px;
    border-bottom: 1px solid var(--border-color);
    flex-shrink: 0;
 }
 .vdl2-modal-title {
    font-size: 14px;
    font-weight: 700;
    color: var(--accent-cyan, #4a9eff);
    letter-spacing: 0.5px;
 }
 .vdl2-modal-time {
    font-size: 11px;
    color: var(--text-muted);
 }
 .vdl2-modal-close {
    background: none;
    border: 1px solid var(--border-color);
    color: var(--text-muted);
    width: 28px;
    height: 28px;
    border-radius: 4px;
    cursor: pointer;
    font-size: 14px;
    display: flex;
    align-items: center;
    justify-content: center;
    transition: all 0.15s;
    margin-left: 12px;
 }
 .vdl2-modal-close:hover {
    background: rgba(239, 68, 68, 0.15);
    border-color: var(--accent-red, #ef4444);
    color: var(--accent-red, #ef4444);
 }
 .vdl2-modal-body {
    padding: 16px 18px;
    overflow-y: auto;
    flex: 1;
    min-height: 0;
 }
 .vdl2-modal-section {
    margin-bottom: 14px;
 }
 .vdl2-modal-section:last-child {
    margin-bottom: 0;
 }
 .vdl2-modal-section-title {
    font-size: 9px;
    font-weight: 700;
    color: var(--text-muted);
    text-transform: uppercase;
    letter-spacing: 1.5px;
    margin-bottom: 8px;
 }
 .vdl2-modal-grid {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 6px 16px;
 }
 .vdl2-modal-field {
    display: flex;
    flex-direction: column;
    gap: 1px;
 }
 .vdl2-modal-field-label {
    font-size: 10px;
    color: var(--text-dim);
 }
 .vdl2-modal-field-value {
    font-size: 12px;
    color: var(--text-primary);
    font-weight: 500;
 }
 .vdl2-modal-msg-body {
    padding: 10px 12px;
    background: rgba(0, 0, 0, 0.25);
    border-radius: 4px;
    font-family: var(--font-mono);
    font-size: 12px;
    color: var(--text-primary);
    white-space: pre-wrap;
    word-break: break-word;
    line-height: 1.5;
    max-height: 250px;
    overflow-y: auto;
 }
 .vdl2-modal-raw-toggle {
    display: inline-block;
    margin-top: 10px;
    font-size: 10px;
    color: var(--accent-cyan, #4a9eff);
    cursor: pointer;
    opacity: 0.7;
    transition: opacity 0.15s;
 }
 .vdl2-modal-raw-toggle:hover {
    opacity: 1;
 }
 .vdl2-modal-raw-json {
    display: none;
    margin-top: 8px;
    padding: 10px 12px;
    background: rgba(0, 0, 0, 0.3);
    border: 1px solid var(--border-color);
    border-radius: 4px;
    font-family: var(--font-mono);
    font-size: 11px;
    color: var(--text-dim);
    white-space: pre-wrap;
    word-break: break-all;
    max-height: 300px;
    overflow-y: auto;
    line-height: 1.4;
 }
 /* Panels */
 .panel {
    background: var(--bg-panel);
@@ -495,6 +860,8 @@ body {
    position: relative;
    flex: 1;
    min-height: 300px;
    min-width: 0;
    overflow: hidden;
 }
@media (min-width: 768px) {
@@ -526,40 +893,90 @@ body {
    display: block;
 }
-#radarOverlayCanvas {
+.map-crosshair-overlay {
    position: absolute;
-    top: 0;
+    inset: 0;
    left: 0;
    width: 100%;
    height: 100%;
    pointer-events: none;
-    z-index: 500;
+    overflow: hidden;
-    display: none;
+    z-index: 1200;
    --crosshair-x-start: 100%;
    --crosshair-y-start: 100%;
    --crosshair-x-end: 50%;
    --crosshair-y-end: 50%;
    --crosshair-duration: 1500ms;
 }
-#radarOverlayCanvas.active {
+.map-crosshair-line {
    display: block;
 }
 #radarScope {
    position: absolute;
    opacity: 0;
    background: var(--accent-cyan);
    box-shadow: none;
    will-change: transform, opacity;
 }
 .map-crosshair-vertical {
    top: 0;
    bottom: 0;
    width: 1px;
    left: 0;
-    width: 100%;
+    transform: translateX(var(--crosshair-x-start));
    height: 100%;
    display: none;
    background: var(--radar-bg);
 }
-#radarScope.active {
+.map-crosshair-horizontal {
-    display: flex;
+    left: 0;
-    justify-content: center;
+    right: 0;
-    align-items: center;
+    height: 1px;
    top: 0;
    transform: translateY(var(--crosshair-y-start));
 }
-#radarCanvas {
+.map-crosshair-overlay.active .map-crosshair-vertical {
-    max-width: 100%;
+    animation: mapCrosshairSweepX var(--crosshair-duration) cubic-bezier(0.2, 0.85, 0.28, 1) forwards;
-    max-height: 100%;
+}
 .map-crosshair-overlay.active .map-crosshair-horizontal {
    animation: mapCrosshairSweepY var(--crosshair-duration) cubic-bezier(0.2, 0.85, 0.28, 1) forwards;
 }
@keyframes mapCrosshairSweepX {
    0% {
        transform: translateX(var(--crosshair-x-start));
        opacity: 0;
    }
    12% {
        opacity: 1;
    }
    85% {
        opacity: 1;
    }
    100% {
        transform: translateX(var(--crosshair-x-end));
        opacity: 0;
    }
 }
@keyframes mapCrosshairSweepY {
    0% {
        transform: translateY(var(--crosshair-y-start));
        opacity: 0;
    }
    12% {
        opacity: 1;
    }
    85% {
        opacity: 1;
    }
    100% {
        transform: translateY(var(--crosshair-y-end));
        opacity: 0;
    }
 }
@media (prefers-reduced-motion: reduce) {
    .map-crosshair-overlay.active .map-crosshair-vertical,
    .map-crosshair-overlay.active .map-crosshair-horizontal {
        animation-duration: 220ms;
    }
 }
 /* Right sidebar - Mobile first */
@@ -588,51 +1005,21 @@ body {
    }
 }
 /* View toggle */
 .view-toggle {
    display: flex;
    padding: 10px;
    gap: 8px;
    background: var(--bg-panel);
    border-bottom: 1px solid rgba(74, 158, 255, 0.2);
 }
 .view-btn {
    flex: 1;
    padding: 10px;
    border: 1px solid rgba(74, 158, 255, 0.3);
    background: transparent;
    color: var(--text-secondary);
    font-family: 'Orbitron', monospace;
    font-size: 11px;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 2px;
    border-radius: 4px;
    cursor: pointer;
    transition: all 0.2s ease;
 }
 .view-btn:hover {
    border-color: var(--accent-cyan);
    color: var(--accent-cyan);
 }
 .view-btn.active {
    background: var(--accent-cyan);
    border-color: var(--accent-cyan);
    color: var(--bg-dark);
 }
 /* Selected aircraft panel */
 .selected-aircraft {
    flex-shrink: 0;
-    max-height: 480px;
+    max-height: 280px;
    overflow-y: auto;
 }
@media (min-height: 900px) {
    .selected-aircraft {
        max-height: 340px;
    }
 }
 .selected-info {
-    padding: 12px;
+    padding: 8px;
 }
 #aircraftPhotoContainer {
@@ -640,7 +1027,7 @@ body {
 }
 #aircraftPhotoContainer img {
-    max-height: 140px;
+    max-height: 100px;
    width: 100%;
    object-fit: cover;
    border-radius: 6px;
@@ -649,24 +1036,24 @@ body {
 .selected-callsign {
    font-family: 'Orbitron', monospace;
-    font-size: 20px;
+    font-size: 16px;
    font-weight: 700;
    color: var(--accent-cyan);
    text-shadow: 0 0 15px var(--accent-cyan);
    text-align: center;
-    margin-bottom: 12px;
+    margin-bottom: 6px;
 }
 .telemetry-grid {
    display: grid;
    grid-template-columns: repeat(2, 1fr);
-    gap: 6px;
+    gap: 4px;
 }
 .telemetry-item {
    background: rgba(0, 0, 0, 0.3);
    border-radius: 4px;
-    padding: 8px;
+    padding: 5px 8px;
    border-left: 2px solid var(--accent-cyan);
 }
@@ -776,9 +1163,10 @@ body {
    gap: 8px;
    padding: 8px 15px;
    background: var(--bg-panel);
-    border-top: 1px solid rgba(74, 158, 255, 0.3);
+    border-top: none;
    font-size: 11px;
-    overflow: hidden;
+    overflow-x: auto;
    overflow-y: hidden;
 }
 .controls-bar > .control-group {
@@ -907,6 +1295,15 @@ body {
 .control-group.airband-group {
    background: rgba(245, 158, 11, 0.05);
    border-color: rgba(245, 158, 11, 0.2);
    flex: 1 1 auto;
    min-width: 0;
 }
 .control-group.airband-group > .control-group-items {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: 5px;
 }
 .control-group.airband-group .control-group-label {
@@ -1010,6 +1407,7 @@ body {
 /* Custom scrollbar */
 ::-webkit-scrollbar {
    width: 6px;
    height: 6px;
 }
 ::-webkit-scrollbar-track {
@@ -1021,6 +1419,15 @@ body {
    border-radius: 3px;
 }
 /* Hide scrollbar on controls bar */
 .controls-bar::-webkit-scrollbar {
    display: none;
 }
 .controls-bar {
    scrollbar-width: none;
 }
 /* No aircraft message */
 .no-aircraft {
    text-align: center;
@@ -1289,7 +1696,7 @@ body {
        display: flex !important;
        flex-direction: column !important;
        height: auto !important;
-        min-height: calc(100dvh - 160px);
+        min-height: 400px;
        overflow-y: auto !important;
        overflow-x: hidden;
        -webkit-overflow-scrolling: touch;
@@ -1489,6 +1896,10 @@ body {
    margin-top: 1px;
 }
 .strip-stat.source-stat .strip-value {
    font-size: 14px;
 }
 .strip-stat.session-stat {
    background: rgba(34, 197, 94, 0.05);
    border-color: rgba(34, 197, 94, 0.2);
@@ -1779,6 +2190,9 @@ body {
 .strip-btn {
    position: relative;
    z-index: 10;
    display: inline-flex;
    align-items: center;
    gap: 4px;
    background: rgba(74, 158, 255, 0.1);
    border: 1px solid rgba(74, 158, 255, 0.2);
    color: var(--text-primary);
@@ -1789,6 +2203,12 @@ body {
    cursor: pointer;
    transition: all 0.2s;
    white-space: nowrap;
    text-decoration: none;
 }
 .strip-btn svg {
    flex-shrink: 0;
    opacity: 0.7;
 }
 .strip-btn:hover:not(:disabled) {
@@ -5,8 +5,8 @@
 }
 :root {
-    --font-sans: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-sans: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
-    --font-mono: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-mono: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
    --bg-dark: #0b1118;
    --bg-panel: #101823;
    --bg-card: #151f2b;
@@ -8,8 +8,8 @@
 }
 :root {
-    --font-sans: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-sans: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
-    --font-mono: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-mono: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
    --bg-dark: #0b1118;
    --bg-panel: #101823;
    --bg-card: #151f2b;
@@ -30,6 +30,27 @@
    --radar-bg: #101823;
 }
 [data-theme="light"] {
    --bg-dark: #f4f7fb;
    --bg-panel: #e9eef5;
    --bg-card: #ffffff;
    --border-color: #d1d9e6;
    --border-glow: #1f5fa8;
    --text-primary: #122034;
    --text-secondary: #3a4a5f;
    --text-dim: #6b7c93;
    --accent-green: #1f8a57;
    --accent-cyan: #1f5fa8;
    --accent-orange: #b5863a;
    --accent-red: #c74444;
    --accent-yellow: #b5863a;
    --accent-amber: #b5863a;
    --grid-line: rgba(31, 95, 168, 0.12);
    --noise-image: url("data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%20viewBox='0%200%2040%2040'%3E%3Cg%20fill='%23000000'%20fill-opacity='0.05'%3E%3Ccircle%20cx='3'%20cy='5'%20r='1'/%3E%3Ccircle%20cx='11'%20cy='9'%20r='1'/%3E%3Ccircle%20cx='18'%20cy='3'%20r='1'/%3E%3Ccircle%20cx='26'%20cy='12'%20r='1'/%3E%3Ccircle%20cx='34'%20cy='6'%20r='1'/%3E%3Ccircle%20cx='7'%20cy='19'%20r='1'/%3E%3Ccircle%20cx='15'%20cy='24'%20r='1'/%3E%3Ccircle%20cx='28'%20cy='22'%20r='1'/%3E%3Ccircle%20cx='36'%20cy='18'%20r='1'/%3E%3Ccircle%20cx='5'%20cy='33'%20r='1'/%3E%3Ccircle%20cx='19'%20cy='32'%20r='1'/%3E%3Ccircle%20cx='31'%20cy='34'%20r='1'/%3E%3C/g%3E%3C/svg%3E");
    --radar-cyan: #1f5fa8;
    --radar-bg: #e9eef5;
 }
 body {
    font-family: var(--font-sans);
    background: var(--bg-dark);
@@ -496,7 +517,7 @@ body {
    padding: 10px 15px;
    background: rgba(74, 158, 255, 0.05);
    border-bottom: 1px solid rgba(74, 158, 255, 0.1);
-    font-family: 'Orbitron', 'Space Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
    font-weight: 500;
    letter-spacing: 2px;
@@ -568,7 +589,7 @@ body {
 }
 .vessel-name {
-    font-family: 'Orbitron', 'Space Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 16px;
    font-weight: 700;
    color: var(--accent-cyan);
@@ -662,7 +683,7 @@ body {
 }
 .vessel-item-name {
-    font-family: 'Orbitron', 'Space Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 12px;
    font-weight: 600;
    color: var(--accent-cyan);
@@ -1223,7 +1244,7 @@ body {
 }
 .dsc-distress-alert .dsc-alert-header {
-    font-family: 'Orbitron', 'Space Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 24px;
    font-weight: 700;
    color: var(--accent-red);
@@ -13,13 +13,11 @@
 }
 .radar-device {
    transition: transform 0.2s ease;
    transform-origin: center center;
    cursor: pointer;
 }
-.radar-device:hover {
+.radar-device:hover .radar-dot {
-    transform: scale(1.2);
+    filter: brightness(1.5);
 }
 /* Invisible larger hit area to prevent hover flicker */
@@ -0,0 +1,440 @@
 /* Shared UX platform components: run-state strip, command palette, setup assistant, and toasts */
 .run-state-strip {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 10px;
    padding: 8px 14px;
    margin: 6px 12px 0;
    border: 1px solid rgba(74, 163, 255, 0.32);
    border-radius: 8px;
    background: linear-gradient(180deg, rgba(19, 30, 44, 0.96), rgba(11, 18, 28, 0.97));
    box-shadow: 0 12px 24px rgba(0, 0, 0, 0.28), inset 0 1px 0 rgba(255, 255, 255, 0.04);
 }
 .run-state-left {
    display: flex;
    align-items: center;
    gap: 8px;
    flex-wrap: wrap;
    min-width: 0;
 }
 #runStateChips {
    display: flex;
    align-items: center;
    gap: 6px;
    flex-wrap: wrap;
 }
 .run-state-label {
    font-size: 10px;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: var(--text-dim, #8697aa);
    font-weight: 600;
 }
 .run-state-chip {
    display: inline-flex;
    align-items: center;
    gap: 6px;
    padding: 3px 7px;
    border-radius: 999px;
    border: 1px solid rgba(74, 163, 255, 0.25);
    background: linear-gradient(180deg, rgba(17, 26, 38, 0.82), rgba(12, 18, 28, 0.84));
    font-size: 10px;
    color: var(--text-secondary, #b1c2d4);
    white-space: nowrap;
 }
 .run-state-chip .dot {
    width: 6px;
    height: 6px;
    border-radius: 50%;
    background: #667788;
    box-shadow: 0 0 0 0 rgba(102, 119, 136, 0.45);
 }
 .run-state-chip.running .dot {
    background: var(--accent-green, #28c27a);
    box-shadow: 0 0 0 4px rgba(40, 194, 122, 0.16), 0 0 12px rgba(40, 194, 122, 0.35);
 }
 .run-state-chip.active {
    border-color: rgba(74, 163, 255, 0.65);
    color: var(--text-primary, #e6edf5);
    box-shadow: inset 0 0 0 1px rgba(74, 163, 255, 0.18);
 }
 .run-state-right {
    display: inline-flex;
    align-items: center;
    gap: 8px;
 }
 .run-state-value {
    font-size: 10px;
    color: var(--text-dim, #8697aa);
 }
 .run-state-btn {
    background: linear-gradient(180deg, rgba(17, 27, 41, 0.9), rgba(10, 16, 25, 0.92));
    color: var(--accent-cyan, #4aa3ff);
    border: 1px solid rgba(74, 163, 255, 0.45);
    border-radius: 6px;
    font-size: 10px;
    padding: 4px 8px;
    cursor: pointer;
    transition: background 0.16s ease, border-color 0.16s ease, transform 0.16s ease;
 }
 .run-state-btn:hover {
    background: rgba(74, 163, 255, 0.14);
    border-color: rgba(74, 163, 255, 0.7);
    transform: translateY(-1px);
 }
 .command-palette-overlay {
    position: fixed;
    inset: 0;
    display: none;
    align-items: flex-start;
    justify-content: center;
    padding: 10vh 18px 0;
    z-index: 25000;
    background: rgba(4, 8, 14, 0.65);
    backdrop-filter: blur(3px);
 }
 .command-palette-overlay.open {
    display: flex;
 }
 .command-palette {
    width: min(760px, 100%);
    border: 1px solid rgba(74, 163, 255, 0.32);
    border-radius: 12px;
    background: linear-gradient(180deg, rgba(16, 26, 39, 0.98), rgba(10, 17, 27, 0.98));
    box-shadow: 0 26px 60px rgba(0, 0, 0, 0.56), inset 0 1px 0 rgba(255, 255, 255, 0.04);
    overflow: hidden;
 }
 .command-palette-header {
    display: flex;
    align-items: center;
    gap: 10px;
    padding: 10px 12px;
    border-bottom: 1px solid var(--border-color, #1e2d3d);
 }
 .command-palette-input {
    width: 100%;
    border: none;
    outline: none;
    background: transparent;
    color: var(--text-primary, #e6edf5);
    font-size: 14px;
    padding: 2px 0;
 }
 .command-palette-hint {
    font-size: 10px;
    color: var(--text-dim, #8697aa);
    white-space: nowrap;
 }
 .command-palette-list {
    max-height: min(62vh, 520px);
    overflow-y: auto;
 }
 .command-palette-item {
    width: 100%;
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 8px;
    padding: 10px 12px;
    border: none;
    border-bottom: 1px solid rgba(255, 255, 255, 0.04);
    background: transparent;
    color: var(--text-secondary, #b1c2d4);
    cursor: pointer;
    text-align: left;
 }
 .command-palette-item:last-child {
    border-bottom: none;
 }
 .command-palette-item .meta {
    display: flex;
    flex-direction: column;
    gap: 2px;
    min-width: 0;
 }
 .command-palette-item .title {
    color: var(--text-primary, #e6edf5);
    font-size: 12px;
    font-weight: 600;
 }
 .command-palette-item .desc {
    color: var(--text-dim, #8697aa);
    font-size: 10px;
 }
 .command-palette-item .kbd {
    font-size: 9px;
    color: var(--text-dim, #8697aa);
    border: 1px solid rgba(255, 255, 255, 0.15);
    border-radius: 4px;
    padding: 1px 5px;
 }
 .command-palette-item.active,
 .command-palette-item:hover,
 .command-palette-item:focus-visible {
    background: rgba(74, 163, 255, 0.12);
    outline: none;
 }
 .command-palette-empty {
    padding: 22px 16px;
    color: var(--text-dim, #8697aa);
    font-size: 11px;
    text-align: center;
 }
 .setup-overlay {
    position: fixed;
    inset: 0;
    display: none;
    align-items: center;
    justify-content: center;
    z-index: 26000;
    background: rgba(4, 8, 14, 0.72);
    backdrop-filter: blur(4px);
    padding: 14px;
 }
 .setup-overlay.open {
    display: flex;
 }
 .setup-modal {
    width: min(760px, 100%);
    max-height: 84vh;
    overflow-y: auto;
    border: 1px solid var(--border-color, #1e2d3d);
    border-radius: 12px;
    background: #101926;
    box-shadow: 0 20px 50px rgba(0, 0, 0, 0.6);
 }
 .setup-header {
    display: flex;
    align-items: flex-start;
    justify-content: space-between;
    gap: 8px;
    border-bottom: 1px solid var(--border-color, #1e2d3d);
    padding: 14px;
 }
 .setup-title {
    font-size: 16px;
    margin: 0;
    color: var(--text-primary, #e6edf5);
 }
 .setup-subtitle {
    margin: 4px 0 0;
    font-size: 11px;
    color: var(--text-dim, #8697aa);
 }
 .setup-close {
    background: transparent;
    border: none;
    color: var(--text-dim, #8697aa);
    font-size: 22px;
    cursor: pointer;
    line-height: 1;
 }
 .setup-content {
    padding: 14px;
    display: grid;
    gap: 10px;
 }
 .setup-step {
    border: 1px solid var(--border-color, #1e2d3d);
    border-radius: 8px;
    padding: 10px;
    background: rgba(255, 255, 255, 0.02);
 }
 .setup-step-header {
    display: flex;
    justify-content: space-between;
    gap: 8px;
    margin-bottom: 6px;
 }
 .setup-step-title {
    font-size: 12px;
    color: var(--text-primary, #e6edf5);
    font-weight: 600;
 }
 .setup-step-status {
    font-size: 10px;
    color: var(--text-dim, #8697aa);
 }
 .setup-step-status.done {
    color: var(--accent-green, #28c27a);
 }
 .setup-step-desc {
    font-size: 11px;
    color: var(--text-secondary, #b1c2d4);
    margin: 0 0 8px;
 }
 .setup-step-actions {
    display: flex;
    gap: 8px;
    flex-wrap: wrap;
 }
 .setup-btn {
    padding: 6px 10px;
    border-radius: 6px;
    border: 1px solid var(--border-color, #1e2d3d);
    background: var(--bg-tertiary, #121f2d);
    color: var(--text-secondary, #b1c2d4);
    font-size: 11px;
    cursor: pointer;
 }
 .setup-btn.primary {
    color: #fff;
    background: var(--accent-cyan, #4aa3ff);
    border-color: var(--accent-cyan, #4aa3ff);
 }
 .setup-footer {
    padding: 12px 14px;
    border-top: 1px solid var(--border-color, #1e2d3d);
    display: flex;
    justify-content: space-between;
    gap: 8px;
    flex-wrap: wrap;
    align-items: center;
 }
 .setup-footer-note {
    color: var(--text-dim, #8697aa);
    font-size: 10px;
 }
 .app-toast-stack {
    position: fixed;
    right: 14px;
    bottom: 16px;
    z-index: 25500;
    display: flex;
    flex-direction: column;
    gap: 8px;
    max-width: min(380px, calc(100vw - 24px));
 }
 .app-toast {
    border: 1px solid var(--border-color, #1e2d3d);
    border-left: 3px solid var(--accent-cyan, #4aa3ff);
    border-radius: 8px;
    background: rgba(15, 24, 35, 0.97);
    color: var(--text-secondary, #b1c2d4);
    box-shadow: 0 10px 20px rgba(0, 0, 0, 0.35);
    padding: 8px 10px;
    font-size: 11px;
 }
 .app-toast.error {
    border-left-color: var(--accent-red, #e25d5d);
 }
 .app-toast.warning {
    border-left-color: var(--accent-orange, #d6a85e);
 }
 .app-toast-title {
    font-size: 11px;
    color: var(--text-primary, #e6edf5);
    font-weight: 600;
    margin-bottom: 4px;
 }
 .app-toast-msg {
    color: var(--text-secondary, #b1c2d4);
 }
 .app-toast-actions {
    margin-top: 7px;
    display: flex;
    gap: 6px;
    flex-wrap: wrap;
 }
 .app-toast-actions button {
    border: 1px solid var(--border-color, #1e2d3d);
    border-radius: 4px;
    background: var(--bg-tertiary, #132133);
    color: var(--text-secondary, #b1c2d4);
    font-size: 10px;
    padding: 3px 6px;
    cursor: pointer;
 }
 .app-toast-actions button:hover {
    border-color: rgba(74, 163, 255, 0.5);
    color: var(--text-primary, #e6edf5);
 }
@media (max-width: 920px) {
    .run-state-strip {
        flex-direction: column;
        align-items: stretch;
    }
    .run-state-right {
        justify-content: space-between;
    }
 }
@media (max-width: 640px) {
    .command-palette-overlay {
        padding: 8vh 10px 0;
    }
    .command-palette-item {
        padding: 9px 10px;
    }
    .setup-header,
    .setup-content,
    .setup-footer {
        padding: 10px;
    }
    .app-toast-stack {
        left: 10px;
        right: 10px;
        max-width: none;
    }
 }
@@ -28,14 +28,16 @@ body {
    color: var(--text-primary);
    background-color: var(--bg-primary);
    background-image:
        radial-gradient(1200px 620px at 8% -12%, var(--ambient-top-left), transparent 62%),
        radial-gradient(980px 560px at 92% -16%, var(--ambient-top-right), transparent 64%),
        radial-gradient(900px 520px at 50% 126%, var(--ambient-bottom), transparent 68%),
        var(--noise-image),
        radial-gradient(circle at 15% 0%, var(--grid-dot), transparent 45%),
        linear-gradient(180deg, var(--grid-dot), transparent 35%),
        linear-gradient(var(--grid-line) 1px, transparent 1px),
        linear-gradient(90deg, var(--grid-line) 1px, transparent 1px);
-    background-size: 40px 40px, auto, auto, 48px 48px, 48px 48px;
+    background-size: auto, auto, auto, 40px 40px, 48px 48px, 48px 48px;
    background-attachment: fixed;
    min-height: 100vh;
    font-variant-numeric: tabular-nums;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
 }
@@ -123,11 +123,12 @@
   CARDS / PANELS
   ============================================ */
 .card {
-    background: linear-gradient(180deg, var(--bg-card) 0%, var(--bg-secondary) 100%);
+    background: var(--surface-panel-gradient);
-    border: 1px solid var(--border-color);
+    border: 1px solid rgba(74, 163, 255, 0.24);
    border-radius: var(--radius-lg);
    overflow: hidden;
-    box-shadow: var(--shadow-sm);
+    box-shadow: var(--shadow-sm), inset 0 1px 0 rgba(255, 255, 255, 0.04);
    backdrop-filter: blur(5px);
 }
 .card-header {
@@ -135,8 +136,8 @@
    align-items: center;
    justify-content: space-between;
    padding: var(--space-3) var(--space-4);
-    border-bottom: 1px solid var(--border-color);
+    border-bottom: 1px solid rgba(74, 163, 255, 0.18);
-    background: var(--bg-secondary);
+    background: linear-gradient(180deg, rgba(25, 38, 55, 0.88) 0%, rgba(17, 27, 40, 0.9) 100%);
    position: relative;
 }
@@ -160,11 +161,12 @@
 /* Panel variant (used in dashboards) */
 .panel {
-    background: linear-gradient(180deg, var(--bg-card) 0%, var(--bg-secondary) 100%);
+    background: var(--surface-panel-gradient);
-    border: 1px solid var(--border-color);
+    border: 1px solid rgba(74, 163, 255, 0.24);
    border-radius: var(--radius-lg);
    overflow: hidden;
-    box-shadow: var(--shadow-sm);
+    box-shadow: var(--shadow-sm), inset 0 1px 0 rgba(255, 255, 255, 0.04);
    backdrop-filter: blur(5px);
 }
@supports (clip-path: polygon(0 0)) {
@@ -190,8 +192,8 @@
    align-items: center;
    justify-content: space-between;
    padding: var(--space-2) var(--space-3);
-    border-bottom: 1px solid var(--border-color);
+    border-bottom: 1px solid rgba(74, 163, 255, 0.18);
-    background: linear-gradient(180deg, var(--bg-elevated) 0%, var(--bg-secondary) 100%);
+    background: linear-gradient(180deg, rgba(25, 38, 55, 0.88) 0%, rgba(17, 27, 40, 0.9) 100%);
    font-size: var(--text-xs);
    font-weight: var(--font-semibold);
    text-transform: uppercase;
@@ -720,10 +722,23 @@
        transform var(--transition-base);
 }
-.card:hover,
+.card:hover,
-.panel:hover {
+.panel:hover {
-    border-color: var(--border-light);
+    border-color: var(--border-glow);
-}
+    box-shadow: var(--shadow-md), var(--shadow-glow), inset 0 1px 0 rgba(255, 255, 255, 0.06);
    transform: translateY(-1px);
 }
 [data-theme="light"] .card,
 [data-theme="light"] .panel {
    border-color: rgba(31, 95, 168, 0.24);
 }
 [data-theme="light"] .card-header,
 [data-theme="light"] .panel-header {
    border-bottom-color: rgba(31, 95, 168, 0.2);
    background: linear-gradient(180deg, rgba(243, 247, 252, 0.96) 0%, rgba(233, 239, 247, 0.95) 100%);
 }
 /* Stats strip value highlight on hover */
 .strip-stat {
@@ -16,6 +16,11 @@
    --bg-card: #121a25;
    --bg-elevated: #1b2734;
    --bg-overlay: rgba(8, 13, 20, 0.75);
    --surface-glass: rgba(16, 25, 37, 0.82);
    --surface-panel-gradient: linear-gradient(160deg, rgba(20, 32, 47, 0.94) 0%, rgba(11, 18, 27, 0.96) 100%);
    --ambient-top-left: rgba(74, 163, 255, 0.14);
    --ambient-top-right: rgba(56, 193, 128, 0.09);
    --ambient-bottom: rgba(214, 168, 94, 0.06);
    /* Background aliases for components */
    --bg-dark: var(--bg-primary);
@@ -78,8 +83,8 @@
    /* ============================================
       TYPOGRAPHY
       ============================================ */
-    --font-sans: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-sans: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
-    --font-mono: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-mono: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
    /* Font sizes */
    --text-xs: 10px;
@@ -158,6 +163,11 @@
    --bg-card: #ffffff;
    --bg-elevated: #f1f4f9;
    --bg-overlay: rgba(244, 247, 251, 0.92);
    --surface-glass: rgba(255, 255, 255, 0.84);
    --surface-panel-gradient: linear-gradient(160deg, rgba(255, 255, 255, 0.96) 0%, rgba(241, 245, 251, 0.97) 100%);
    --ambient-top-left: rgba(31, 95, 168, 0.1);
    --ambient-top-right: rgba(31, 138, 87, 0.06);
    --ambient-bottom: rgba(181, 134, 58, 0.05);
    /* Background aliases for components */
    --bg-dark: var(--bg-primary);
@@ -1,18 +1,20 @@
 /* Local font declarations for offline mode */
 /* Roboto Condensed - variable font, one file covers all weights */
 /* Space Mono - Console font */
@font-face {
-    font-family: 'Space Mono';
+    font-family: 'Roboto Condensed';
    font-style: normal;
-    font-weight: 400;
+    font-weight: 300 700;
    font-display: swap;
-    src: url('/static/vendor/fonts/SpaceMono-Regular.woff2') format('woff2');
+    src: url('/static/vendor/fonts/RobotoCondensed-Latin.woff2') format('woff2');
    unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
 }
@font-face {
-    font-family: 'Space Mono';
+    font-family: 'Roboto Condensed';
    font-style: normal;
-    font-weight: 700;
+    font-weight: 300 700;
    font-display: swap;
-    src: url('/static/vendor/fonts/SpaceMono-Bold.woff2') format('woff2');
+    src: url('/static/vendor/fonts/RobotoCondensed-LatinExt.woff2') format('woff2');
    unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF;
 }
@@ -30,7 +30,7 @@
    border-bottom: 1px solid var(--border-color, #202833);
    padding: 0 20px;
    position: relative;
-    z-index: 100;
+    z-index: 1100;
    backdrop-filter: blur(10px);
 }
@@ -434,6 +434,6 @@ a.nav-dashboard-btn:hover {
 }
 .nav-dashboard-btn .nav-label {
-    font-family: var(--font-mono, 'JetBrains Mono', monospace);
+    font-family: var(--font-mono, 'Roboto Condensed', 'Arial Narrow', sans-serif);
    letter-spacing: 0.5px;
 }
@@ -14,6 +14,7 @@
    z-index: 10000;
    overflow-y: auto;
    padding: 40px 20px;
    font-family: var(--font-mono, 'Roboto Condensed', 'Arial Narrow', sans-serif);
 }
 .help-modal.active {
@@ -26,37 +27,41 @@
    background: var(--bg-card, var(--bg-secondary, #0f1218));
    border: 1px solid var(--border-color, #1f2937);
    border-radius: 8px;
-    padding: 30px;
+    padding: 24px;
    position: relative;
 }
 .help-content h2 {
    color: var(--accent-cyan, #4a9eff);
-    margin-bottom: 20px;
+    margin-bottom: 16px;
-    font-size: 24px;
+    font-size: 15px;
    letter-spacing: 2px;
    text-transform: uppercase;
    font-weight: 600;
 }
 .help-content h3 {
    color: var(--text-primary, #e8eaed);
-    margin: 25px 0 15px 0;
+    margin: 20px 0 10px 0;
-    font-size: 14px;
+    font-size: 11px;
    text-transform: uppercase;
    letter-spacing: 1px;
    border-bottom: 1px solid var(--border-color, #1f2937);
-    padding-bottom: 8px;
+    padding-bottom: 6px;
    font-weight: 600;
 }
 .help-close {
    position: absolute;
-    top: 15px;
+    top: 12px;
-    right: 15px;
+    right: 12px;
    background: none;
    border: none;
    color: var(--text-dim, #4b5563);
-    font-size: 24px;
+    font-size: 20px;
    cursor: pointer;
    transition: color 0.2s;
    line-height: 1;
 }
 .help-close:hover {
@@ -66,43 +71,54 @@
 .help-modal .icon-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
-    gap: 12px;
+    gap: 8px;
-    margin: 15px 0;
+    margin: 10px 0;
 }
 .help-modal .icon-item {
    display: flex;
    align-items: center;
-    gap: 10px;
+    gap: 8px;
-    padding: 10px;
+    padding: 6px 8px;
    background: var(--bg-primary, #0a0c10);
    border: 1px solid var(--border-color, #1f2937);
    border-radius: 4px;
-    font-size: 12px;
+    font-size: 11px;
 }
 .help-modal .icon-item .icon {
-    font-size: 18px;
+    width: 20px;
-    width: 30px;
+    height: 20px;
-    text-align: center;
+    flex-shrink: 0;
    display: flex;
    align-items: center;
    justify-content: center;
 }
 .help-modal .icon-item .icon svg {
    width: 16px;
    height: 16px;
 }
 .help-modal .icon-item .desc {
    color: var(--text-secondary, #9ca3af);
    font-size: 10.5px;
    line-height: 1.3;
 }
 .help-modal .tip-list {
    list-style: none;
    padding: 0;
-    margin: 15px 0;
+    margin: 10px 0;
 }
 .help-modal .tip-list li {
-    padding: 8px 0;
+    padding: 5px 0;
-    padding-left: 20px;
+    padding-left: 16px;
    position: relative;
    color: var(--text-secondary, #9ca3af);
-    font-size: 13px;
+    font-size: 11px;
    line-height: 1.5;
    border-bottom: 1px solid var(--border-color, #1f2937);
 }
@@ -118,10 +134,15 @@
    font-weight: bold;
 }
 .help-modal .tip-list li strong {
    color: var(--text-primary, #e8eaed);
    font-weight: 600;
 }
 .help-tabs {
    display: flex;
    gap: 0;
-    margin-bottom: 20px;
+    margin-bottom: 16px;
    border: 1px solid var(--border-color, #1f2937);
    border-radius: 4px;
    overflow: hidden;
@@ -129,12 +150,13 @@
 .help-tab {
    flex: 1;
-    padding: 10px;
+    padding: 8px;
    background: var(--bg-primary, #0a0c10);
    border: none;
    color: var(--text-secondary, #9ca3af);
    cursor: pointer;
-    font-size: 11px;
+    font-family: var(--font-mono, 'Roboto Condensed', 'Arial Narrow', sans-serif);
    font-size: 10px;
    text-transform: uppercase;
    letter-spacing: 1px;
    transition: all 0.15s ease;
@@ -176,9 +198,9 @@
 /* Ensure code tags are styled */
 .help-modal code {
    background: var(--bg-tertiary, #151a23);
-    padding: 2px 6px;
+    padding: 1px 5px;
    border-radius: 3px;
-    font-family: var(--font-mono, 'JetBrains Mono', monospace);
+    font-family: var(--font-mono, 'Roboto Condensed', 'Arial Narrow', sans-serif);
-    font-size: 11px;
+    font-size: 10.5px;
    color: var(--accent-cyan, #4a9eff);
 }
@@ -0,0 +1,628 @@
 /* BT Locate Mode Styles */
 /* Environment preset grid */
 .btl-env-grid {
    display: grid;
    grid-template-columns: 1fr 1fr 1fr;
    gap: 6px;
 }
 .btl-env-btn {
    display: flex;
    flex-direction: column;
    align-items: center;
    gap: 2px;
    padding: 8px 4px;
    background: rgba(255, 255, 255, 0.03);
    border: 1px solid rgba(255, 255, 255, 0.1);
    border-radius: 6px;
    cursor: pointer;
    transition: all 0.2s;
    color: var(--text-secondary);
 }
 .btl-env-btn:hover {
    background: rgba(255, 255, 255, 0.06);
    border-color: rgba(255, 255, 255, 0.2);
 }
 .btl-env-btn.active {
    background: rgba(0, 255, 136, 0.1);
    border-color: var(--accent-green, #00ff88);
    color: var(--text-primary);
 }
 .btl-env-icon {
    font-size: 18px;
    line-height: 1;
 }
 .btl-env-label {
    font-size: 10px;
    font-weight: 600;
    text-transform: uppercase;
 }
 .btl-env-n {
    font-size: 9px;
    font-family: var(--font-mono);
    color: var(--text-dim);
 }
 /* ============================================
   PROXIMITY HUD — main visuals area
   ============================================ */
 .btl-hud {
    display: flex;
    flex-direction: column;
    gap: 0;
    background: rgba(0, 0, 0, 0.5);
    border: 1px solid rgba(255, 255, 255, 0.08);
    border-radius: 8px;
    flex-shrink: 0;
    overflow: hidden;
 }
 .btl-hud-top {
    display: flex;
    align-items: center;
    gap: 20px;
    padding: 14px 20px;
 }
 .btl-hud-band {
    font-size: 22px;
    font-weight: 800;
    font-family: var(--font-mono);
    letter-spacing: 2px;
    padding: 14px 20px;
    border-radius: 8px;
    background: rgba(255, 255, 255, 0.03);
    border: 2px solid rgba(255, 255, 255, 0.1);
    color: var(--text-dim);
    text-align: center;
    min-width: 130px;
    transition: all 0.3s;
    flex-shrink: 0;
 }
 .btl-hud-band.immediate {
    color: #ef4444;
    border-color: #ef4444;
    background: rgba(239, 68, 68, 0.15);
    box-shadow: 0 0 20px rgba(239, 68, 68, 0.2);
    animation: btl-pulse 1s ease-in-out infinite;
 }
 .btl-hud-band.near {
    color: #f97316;
    border-color: #f97316;
    background: rgba(249, 115, 22, 0.12);
    box-shadow: 0 0 15px rgba(249, 115, 22, 0.15);
    animation: btl-pulse 2s ease-in-out infinite;
 }
 .btl-hud-band.far {
    color: #eab308;
    border-color: #eab308;
    background: rgba(234, 179, 8, 0.1);
    box-shadow: 0 0 10px rgba(234, 179, 8, 0.1);
 }
@keyframes btl-pulse {
    0%, 100% { opacity: 1; }
    50% { opacity: 0.6; }
 }
 .btl-hud-metrics {
    display: flex;
    gap: 20px;
    flex: 1;
    align-items: flex-start;
 }
 .btl-hud-separator {
    width: 1px;
    height: 40px;
    background: rgba(255, 255, 255, 0.08);
    align-self: center;
    flex-shrink: 0;
 }
 .btl-hud-metric {
    display: flex;
    flex-direction: column;
    align-items: center;
    min-width: 60px;
 }
 .btl-hud-metric-lg .btl-hud-value {
    font-size: 28px;
 }
 .btl-hud-value {
    font-size: 22px;
    font-weight: 700;
    font-family: var(--font-mono);
    color: var(--text-primary);
    line-height: 1.1;
 }
 .btl-hud-unit {
    font-size: 10px;
    color: var(--text-dim);
    font-family: var(--font-mono);
 }
 .btl-hud-label {
    font-size: 9px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.5px;
    margin-top: 2px;
 }
 .btl-hud-controls {
    display: flex;
    flex-direction: column;
    gap: 6px;
    flex-shrink: 0;
 }
 .btl-hud-export-row {
    display: flex;
    gap: 5px;
    align-items: center;
 }
 .btl-hud-export-format {
    min-width: 62px;
    padding: 3px 6px;
    font-size: 10px;
    font-family: var(--font-mono);
    color: var(--text-secondary);
    background: rgba(0, 0, 0, 0.45);
    border: 1px solid rgba(255, 255, 255, 0.12);
    border-radius: 4px;
 }
 .btl-hud-audio-toggle {
    display: flex;
    align-items: center;
    gap: 5px;
    font-size: 11px;
    color: var(--text-secondary);
    cursor: pointer;
    white-space: nowrap;
 }
 .btl-hud-audio-toggle input[type="checkbox"] {
    margin: 0;
 }
 .btl-hud-clear-btn {
    padding: 4px 10px;
    font-size: 10px;
    background: rgba(255, 255, 255, 0.05);
    border: 1px solid rgba(255, 255, 255, 0.1);
    border-radius: 4px;
    color: var(--text-dim);
    cursor: pointer;
    transition: all 0.2s;
 }
 .btl-hud-clear-btn:hover {
    background: rgba(255, 255, 255, 0.1);
    color: var(--text-secondary);
 }
 /* Bottom info bar */
 .btl-hud-bottom {
    display: flex;
    justify-content: space-between;
    align-items: center;
    padding: 6px 20px;
    background: rgba(0, 0, 0, 0.3);
    border-top: 1px solid rgba(255, 255, 255, 0.05);
 }
 .btl-hud-info {
    display: flex;
    align-items: center;
    gap: 6px;
    flex-wrap: wrap;
 }
 .btl-hud-info-item {
    font-size: 10px;
    font-family: var(--font-mono);
    color: var(--text-dim);
 }
 .btl-hud-info-sep {
    color: rgba(255, 255, 255, 0.15);
    font-size: 10px;
 }
 .btl-hud-diag {
    display: none;
    font-size: 9px;
    color: var(--text-dim);
    font-family: var(--font-mono);
    opacity: 0.5;
    white-space: nowrap;
 }
 .btl-hud-diag:not(:empty) {
    display: block;
 }
 /* ============================================
   VISUALS AREA — map + chart
   ============================================ */
 .btl-visuals-container {
    display: flex;
    flex-direction: column;
    gap: 8px;
    flex: 1;
    min-height: 0;
    overflow: hidden;
    padding: 8px;
 }
 .btl-map-container {
    flex: 1;
    min-height: 250px;
    position: relative;
    border-radius: 8px;
    overflow: hidden;
    border: 1px solid rgba(255, 255, 255, 0.1);
 }
 #btLocateMap {
    position: absolute;
    inset: 0;
    background: #1a1a2e;
 }
 .btl-map-overlay-controls {
    position: absolute;
    top: 10px;
    right: 10px;
    z-index: 450;
    display: flex;
    flex-direction: column;
    gap: 4px;
    padding: 7px 8px;
    border-radius: 7px;
    background: rgba(0, 0, 0, 0.6);
    border: 1px solid rgba(255, 255, 255, 0.15);
    backdrop-filter: blur(4px);
 }
 .btl-map-overlay-toggle {
    display: flex;
    align-items: center;
    gap: 5px;
    font-size: 10px;
    color: var(--text-secondary);
    font-family: var(--font-mono);
    cursor: pointer;
    white-space: nowrap;
 }
 .btl-map-overlay-toggle input[type="checkbox"] {
    margin: 0;
 }
 .btl-map-overlay-toggle input[type="checkbox"]:disabled + span {
    opacity: 0.45;
 }
 .btl-map-heat-legend {
    position: absolute;
    left: 10px;
    bottom: 10px;
    z-index: 430;
    min-width: 120px;
    padding: 6px 8px;
    border-radius: 7px;
    background: rgba(0, 0, 0, 0.6);
    border: 1px solid rgba(255, 255, 255, 0.14);
    backdrop-filter: blur(4px);
 }
 .btl-map-heat-label {
    display: block;
    font-size: 9px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.7px;
    margin-bottom: 4px;
 }
 .btl-map-heat-bar {
    height: 7px;
    border-radius: 4px;
    background: linear-gradient(90deg, #2563eb 0%, #16a34a 40%, #f59e0b 70%, #ef4444 100%);
    border: 1px solid rgba(255, 255, 255, 0.15);
 }
 .btl-map-heat-scale {
    display: flex;
    justify-content: space-between;
    margin-top: 3px;
    font-size: 8px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.5px;
 }
 .btl-map-track-stats {
    position: absolute;
    right: 10px;
    bottom: 10px;
    z-index: 430;
    padding: 5px 8px;
    border-radius: 7px;
    background: rgba(0, 0, 0, 0.6);
    border: 1px solid rgba(255, 255, 255, 0.14);
    color: var(--text-secondary);
    font-size: 10px;
    font-family: var(--font-mono);
    backdrop-filter: blur(4px);
 }
 .btl-rssi-chart-container {
    height: 100px;
    background: rgba(0, 0, 0, 0.3);
    border-radius: 8px;
    border: 1px solid rgba(255, 255, 255, 0.1);
    padding: 8px;
    position: relative;
    flex-shrink: 0;
 }
 .btl-rssi-chart-container .btl-chart-label {
    position: absolute;
    top: 4px;
    left: 8px;
    font-size: 9px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 1px;
 }
 #btLocateRssiChart {
    width: 100%;
    height: 100%;
 }
 /* ============================================
   LOCATE BUTTON — Bluetooth device cards
   ============================================ */
 .bt-locate-btn {
    display: inline-flex;
    align-items: center;
    gap: 4px;
    padding: 3px 8px;
    font-size: 10px;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.5px;
    color: var(--accent-green, #00ff88);
    background: rgba(0, 255, 136, 0.1);
    border: 1px solid rgba(0, 255, 136, 0.3);
    border-radius: 3px;
    cursor: pointer;
    transition: all 0.2s;
 }
 .bt-locate-btn:hover {
    background: rgba(0, 255, 136, 0.2);
    border-color: var(--accent-green, #00ff88);
 }
 .bt-locate-btn svg {
    width: 10px;
    height: 10px;
 }
 /* ============================================
   IRK DETECT BUTTON + DEVICE PICKER
   ============================================ */
 .btl-detect-irk-btn {
    padding: 5px 10px;
    font-size: 10px;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.5px;
    color: var(--accent-cyan, #00d4ff);
    background: rgba(0, 212, 255, 0.1);
    border: 1px solid rgba(0, 212, 255, 0.3);
    border-radius: 4px;
    cursor: pointer;
    transition: all 0.2s;
    white-space: nowrap;
    flex-shrink: 0;
 }
 .btl-detect-irk-btn:hover {
    background: rgba(0, 212, 255, 0.2);
    border-color: var(--accent-cyan, #00d4ff);
 }
 .btl-detect-irk-btn:disabled {
    opacity: 0.5;
    cursor: wait;
 }
 .btl-irk-picker {
    margin-top: 6px;
    background: rgba(0, 0, 0, 0.3);
    border: 1px solid rgba(255, 255, 255, 0.1);
    border-radius: 6px;
    overflow: hidden;
 }
 .btl-irk-picker-status {
    padding: 8px 10px;
    font-size: 10px;
    color: var(--text-dim);
    text-align: center;
 }
 .btl-irk-picker-list {
    max-height: 160px;
    overflow-y: auto;
 }
 .btl-irk-picker-item {
    padding: 7px 10px;
    cursor: pointer;
    transition: background 0.15s;
    border-top: 1px solid rgba(255, 255, 255, 0.05);
 }
 .btl-irk-picker-item:first-child {
    border-top: none;
 }
 .btl-irk-picker-item:hover {
    background: rgba(0, 255, 136, 0.08);
 }
 .btl-irk-picker-name {
    font-size: 11px;
    font-weight: 600;
    color: var(--text-primary);
 }
 .btl-irk-picker-meta {
    font-size: 9px;
    font-family: var(--font-mono);
    color: var(--text-dim);
    margin-top: 1px;
 }
 /* ============================================
   RESPONSIVE — stack HUD vertically on narrow
   ============================================ */
@media (max-width: 900px) {
    .btl-hud {
        flex-wrap: wrap;
        gap: 10px;
    }
    .btl-hud-band {
        min-width: unset;
        width: 100%;
        font-size: 20px;
    }
    .btl-hud-metrics {
        width: 100%;
        justify-content: space-around;
    }
    .btl-hud-controls {
        flex-direction: row;
        width: 100%;
        justify-content: center;
        flex-wrap: wrap;
    }
    .btl-hud-export-row {
        width: 100%;
        justify-content: center;
    }
    .btl-map-overlay-controls {
        top: 8px;
        right: 8px;
        gap: 3px;
        padding: 6px 7px;
    }
    .btl-map-heat-legend {
        left: 8px;
        bottom: 8px;
    }
    .btl-map-track-stats {
        right: 8px;
        bottom: 8px;
        font-size: 9px;
    }
 }
 /* ── Crosshair sweep animation ───────────────────────────────────── */
 .btl-crosshair-overlay {
    position: absolute;
    inset: 0;
    pointer-events: none;
    overflow: hidden;
    z-index: 1200;
    --btl-crosshair-x-start: 100%;
    --btl-crosshair-y-start: 100%;
    --btl-crosshair-x-end: 50%;
    --btl-crosshair-y-end: 50%;
    --btl-crosshair-duration: 1500ms;
 }
 .btl-crosshair-line {
    position: absolute;
    opacity: 0;
    background: var(--accent-cyan);
    will-change: transform, opacity;
 }
 .btl-crosshair-vertical {
    top: 0;
    bottom: 0;
    width: 1px;
    left: 0;
    transform: translateX(var(--btl-crosshair-x-start));
 }
 .btl-crosshair-horizontal {
    left: 0;
    right: 0;
    height: 1px;
    top: 0;
    transform: translateY(var(--btl-crosshair-y-start));
 }
 .btl-crosshair-overlay.active .btl-crosshair-vertical {
    animation: btlCrosshairSweepX var(--btl-crosshair-duration) cubic-bezier(0.2, 0.85, 0.28, 1) forwards;
 }
 .btl-crosshair-overlay.active .btl-crosshair-horizontal {
    animation: btlCrosshairSweepY var(--btl-crosshair-duration) cubic-bezier(0.2, 0.85, 0.28, 1) forwards;
 }
@keyframes btlCrosshairSweepX {
    0%   { transform: translateX(var(--btl-crosshair-x-start)); opacity: 0; }
    12%  { opacity: 1; }
    85%  { opacity: 1; }
    100% { transform: translateX(var(--btl-crosshair-x-end));   opacity: 0; }
 }
@keyframes btlCrosshairSweepY {
    0%   { transform: translateY(var(--btl-crosshair-y-start)); opacity: 0; }
    12%  { opacity: 1; }
    85%  { opacity: 1; }
    100% { transform: translateY(var(--btl-crosshair-y-end));   opacity: 0; }
 }
@media (prefers-reduced-motion: reduce) {
    .btl-crosshair-overlay.active .btl-crosshair-vertical,
    .btl-crosshair-overlay.active .btl-crosshair-horizontal {
        animation-duration: 220ms;
    }
 }
@@ -0,0 +1,388 @@
 /* GPS Mode Styles */
 /* Sidebar info grid */
 .gps-info-grid {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 6px;
 }
 .gps-info-item {
    display: flex;
    flex-direction: column;
    gap: 2px;
    padding: 4px 6px;
    background: var(--bg-primary);
    border: 1px solid var(--border-color);
    border-radius: 3px;
 }
 .gps-info-label {
    font-size: 9px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.5px;
 }
 .gps-info-value {
    font-size: 12px;
    color: var(--text-primary);
    font-weight: 600;
 }
 .gps-mono {
    font-family: var(--font-mono);
 }
 /* Connection status */
 .gps-connection-status {
    display: flex;
    align-items: center;
    gap: 6px;
 }
 .gps-status-dot {
    width: 8px;
    height: 8px;
    border-radius: 50%;
    background: var(--text-dim);
    flex-shrink: 0;
 }
 .gps-status-dot.connected {
    background: #00ff88;
    box-shadow: 0 0 6px rgba(0, 255, 136, 0.4);
 }
 .gps-status-dot.waiting {
    background: #ffaa00;
    box-shadow: 0 0 6px rgba(255, 170, 0, 0.4);
 }
 .gps-status-dot.error {
    background: #ff4444;
    box-shadow: 0 0 6px rgba(255, 68, 68, 0.4);
 }
 .gps-status-text {
    font-size: 11px;
    color: var(--text-secondary);
    font-family: var(--font-mono);
 }
 /* Fix badge */
 .gps-fix-badge {
    display: inline-block;
    padding: 1px 6px;
    border-radius: 3px;
    font-size: 10px;
    font-weight: 700;
    font-family: var(--font-mono);
 }
 .gps-fix-badge.no-fix {
    background: rgba(255, 68, 68, 0.2);
    color: #ff4444;
    border: 1px solid rgba(255, 68, 68, 0.3);
 }
 .gps-fix-badge.fix-2d {
    background: rgba(255, 170, 0, 0.2);
    color: #ffaa00;
    border: 1px solid rgba(255, 170, 0, 0.3);
 }
 .gps-fix-badge.fix-3d {
    background: rgba(0, 255, 136, 0.2);
    color: #00ff88;
    border: 1px solid rgba(0, 255, 136, 0.3);
 }
 /* DOP quality indicators */
 .gps-dop-good { color: #00ff88; }
 .gps-dop-moderate { color: #ffaa00; }
 .gps-dop-poor { color: #ff4444; }
 /* ===== Visuals Panel ===== */
 .gps-visuals-container {
    display: flex;
    flex-direction: column;
    gap: 16px;
    padding: 16px;
    height: 100%;
    overflow-y: auto;
 }
 /* Top row: sky view + position info */
 .gps-visuals-top {
    display: flex;
    gap: 16px;
    flex-wrap: wrap;
 }
 /* Sky View */
 .gps-skyview-panel {
    flex: 1;
    min-width: 320px;
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 12px;
 }
 .gps-skyview-panel h4 {
    margin: 0 0 8px 0;
    font-size: 11px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.5px;
 }
 .gps-skyview-canvas-wrap {
    position: relative;
    display: block;
    width: min(100%, 430px);
    aspect-ratio: 1 / 1;
    margin: 0 auto;
    border: 1px solid var(--border-color);
    border-radius: 6px;
    background: var(--bg-primary);
    overflow: hidden;
 }
 #gpsSkyCanvas {
    display: block;
    width: 100%;
    height: 100%;
    cursor: grab;
    touch-action: none;
 }
 #gpsSkyCanvas:active {
    cursor: grabbing;
 }
 .gps-sky-overlay {
    position: absolute;
    inset: 0;
    pointer-events: none;
    font-family: var(--font-mono);
 }
 .gps-sky-label {
    position: absolute;
    transform: translate(-50%, -50%);
    font-size: 9px;
    letter-spacing: 0.2px;
    text-shadow: 0 0 6px rgba(0, 0, 0, 0.9);
    white-space: nowrap;
 }
 .gps-sky-label-cardinal {
    font-weight: 700;
    color: var(--text-secondary);
    opacity: 0.85;
 }
 .gps-sky-label-sat {
    font-weight: 600;
 }
 .gps-sky-label-sat.unused {
    opacity: 0.75;
 }
 .gps-sky-hint {
    margin-top: 8px;
    font-size: 9px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.4px;
 }
 /* Position info panel */
 .gps-position-panel {
    flex: 1;
    min-width: 280px;
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 12px;
    display: flex;
    flex-direction: column;
    gap: 12px;
 }
 .gps-position-panel h4 {
    margin: 0;
    font-size: 11px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.5px;
 }
 .gps-pos-big {
    font-family: var(--font-mono);
    font-size: 20px;
    font-weight: 700;
    color: var(--accent-cyan);
    line-height: 1.3;
 }
 .gps-pos-row {
    display: flex;
    justify-content: space-between;
    align-items: center;
    padding: 4px 0;
    border-bottom: 1px solid var(--border-color);
 }
 .gps-pos-row:last-child {
    border-bottom: none;
 }
 .gps-pos-label {
    font-size: 10px;
    color: var(--text-dim);
    text-transform: uppercase;
 }
 .gps-pos-value {
    font-family: var(--font-mono);
    font-size: 13px;
    color: var(--text-primary);
    font-weight: 600;
 }
 /* Signal Strength Bars */
 .gps-signal-panel {
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 12px;
 }
 .gps-signal-panel h4 {
    margin: 0 0 8px 0;
    font-size: 11px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.5px;
 }
 .gps-signal-bars {
    display: flex;
    align-items: flex-end;
    gap: 3px;
    height: 140px;
    padding: 0 4px;
    overflow-x: auto;
 }
 .gps-signal-bar-wrap {
    display: flex;
    flex-direction: column;
    align-items: center;
    gap: 2px;
    min-width: 18px;
    height: 100%;
    justify-content: flex-end;
 }
 .gps-signal-bar {
    width: 14px;
    border-radius: 2px 2px 0 0;
    min-height: 2px;
    transition: height 0.3s ease;
 }
 .gps-signal-bar.unused {
    opacity: 0.4;
 }
 .gps-signal-prn {
    font-size: 8px;
    font-family: var(--font-mono);
    color: var(--text-dim);
    writing-mode: horizontal-tb;
 }
 .gps-signal-snr {
    font-size: 7px;
    font-family: var(--font-mono);
    color: var(--text-secondary);
 }
 /* Constellation colors */
 .gps-const-gps { background-color: #00d4ff; }
 .gps-const-glonass { background-color: #00ff88; }
 .gps-const-galileo { background-color: #ff8800; }
 .gps-const-beidou { background-color: #ff4466; }
 .gps-const-sbas { background-color: #ffdd00; }
 .gps-const-qzss { background-color: #cc66ff; }
 /* Legend */
 .gps-legend {
    display: flex;
    gap: 12px;
    flex-wrap: wrap;
    margin-top: 8px;
    padding-top: 8px;
    border-top: 1px solid var(--border-color);
 }
 .gps-legend-item {
    display: flex;
    align-items: center;
    gap: 4px;
    font-size: 9px;
    color: var(--text-dim);
 }
 .gps-legend-dot {
    width: 8px;
    height: 8px;
    border-radius: 50%;
    flex-shrink: 0;
 }
 /* Empty state */
 .gps-empty-state {
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    gap: 12px;
    padding: 40px;
    color: var(--text-dim);
    text-align: center;
 }
 .gps-empty-state svg {
    width: 48px;
    height: 48px;
    opacity: 0.3;
 }
 .gps-empty-state p {
    font-size: 12px;
    max-width: 300px;
    line-height: 1.5;
 }
 /* Responsive */
@media (max-width: 768px) {
    .gps-visuals-top {
        flex-direction: column;
    }
    .gps-skyview-panel,
    .gps-position-panel {
        min-width: unset;
    }
    .gps-pos-big {
        font-size: 16px;
    }
 }
@@ -0,0 +1,467 @@
 /* Space Weather Mode Styles */
 /* Main container */
 .sw-visuals-container {
    display: flex;
    flex-direction: column;
    gap: 12px;
    padding: 12px;
    height: 100%;
    overflow-y: auto;
 }
 /* Header metrics strip */
 .sw-header-strip {
    display: flex;
    align-items: center;
    gap: 2px;
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 8px 12px;
    flex-wrap: wrap;
 }
 .sw-header-stat {
    display: flex;
    flex-direction: column;
    align-items: center;
    padding: 4px 12px;
    min-width: 60px;
 }
 .sw-header-stat + .sw-header-stat {
    border-left: 1px solid var(--border-color);
 }
 .sw-header-value {
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
    font-size: 18px;
    font-weight: 700;
    color: var(--text-primary);
    line-height: 1.2;
 }
 .sw-header-label {
    font-size: 9px;
    font-weight: 600;
    letter-spacing: 0.5px;
    color: var(--text-dim);
    text-transform: uppercase;
 }
 .sw-header-value.accent-cyan { color: var(--accent-cyan); }
 .sw-header-value.accent-green { color: #00ff88; }
 .sw-header-value.accent-yellow { color: #ffcc00; }
 .sw-header-value.accent-orange { color: #ff8800; }
 .sw-header-value.accent-red { color: #ff3366; }
 /* Refresh controls in strip */
 .sw-strip-controls {
    display: flex;
    align-items: center;
    gap: 8px;
    margin-left: auto;
    padding-left: 12px;
 }
 .sw-refresh-btn {
    background: transparent;
    border: 1px solid var(--border-color);
    color: var(--text-secondary);
    padding: 4px 10px;
    border-radius: 4px;
    font-size: 11px;
    cursor: pointer;
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
    transition: border-color 0.2s, color 0.2s;
 }
 .sw-refresh-btn:hover {
    border-color: var(--accent-cyan);
    color: var(--accent-cyan);
 }
 .sw-last-update {
    font-size: 10px;
    color: var(--text-dim);
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
 }
 /* NOAA G/S/R Scale cards */
 .sw-scales-row {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
    gap: 8px;
 }
 .sw-scale-card {
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 10px;
    text-align: center;
 }
 .sw-scale-label {
    font-size: 10px;
    font-weight: 600;
    letter-spacing: 0.5px;
    color: var(--text-dim);
    text-transform: uppercase;
    margin-bottom: 4px;
 }
 .sw-scale-value {
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
    font-size: 24px;
    font-weight: 700;
    line-height: 1.2;
 }
 .sw-scale-desc {
    font-size: 10px;
    color: var(--text-dim);
    margin-top: 2px;
 }
 /* Scale severity colors */
 .sw-scale-0 { color: #00ff88; border-color: #00ff8833; }
 .sw-scale-1 { color: #88ff00; border-color: #88ff0033; }
 .sw-scale-2 { color: #ffcc00; border-color: #ffcc0033; }
 .sw-scale-3 { color: #ff8800; border-color: #ff880033; }
 .sw-scale-4 { color: #ff4400; border-color: #ff440033; }
 .sw-scale-5 { color: #ff0044; border-color: #ff004433; }
 /* HF Band conditions grid */
 .sw-band-panel {
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 12px;
 }
 .sw-band-title {
    font-size: 11px;
    font-weight: 600;
    color: var(--text-secondary);
    text-transform: uppercase;
    letter-spacing: 0.5px;
    margin-bottom: 8px;
 }
 .sw-band-grid {
    display: grid;
    grid-template-columns: auto repeat(2, 1fr);
    gap: 4px 8px;
    font-size: 11px;
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
 }
 .sw-band-header {
    font-size: 10px;
    font-weight: 600;
    color: var(--text-dim);
    text-transform: uppercase;
    padding-bottom: 4px;
    border-bottom: 1px solid var(--border-color);
 }
 .sw-band-name {
    color: var(--text-secondary);
    font-weight: 500;
 }
 .sw-band-cond {
    text-align: center;
    padding: 2px 6px;
    border-radius: 3px;
    font-size: 10px;
    font-weight: 600;
 }
 .sw-band-good { color: #00ff88; background: #00ff8815; }
 .sw-band-fair { color: #ffcc00; background: #ffcc0015; }
 .sw-band-poor { color: #ff3366; background: #ff336615; }
 /* 2-column dashboard grid */
 .sw-dashboard-grid {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 10px;
 }
 /* Chart containers */
 .sw-chart-card {
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 12px;
 }
 .sw-chart-title {
    font-size: 11px;
    font-weight: 600;
    color: var(--text-secondary);
    text-transform: uppercase;
    letter-spacing: 0.5px;
    margin-bottom: 8px;
 }
 .sw-chart-wrap {
    position: relative;
    height: 180px;
 }
 .sw-chart-wrap canvas {
    width: 100% !important;
    height: 100% !important;
 }
 /* Flare probability table */
 .sw-prob-table {
    width: 100%;
    border-collapse: collapse;
    font-size: 11px;
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
 }
 .sw-prob-table th {
    font-size: 10px;
    font-weight: 600;
    color: var(--text-dim);
    text-transform: uppercase;
    text-align: left;
    padding: 4px 6px;
    border-bottom: 1px solid var(--border-color);
 }
 .sw-prob-table td {
    padding: 4px 6px;
    color: var(--text-secondary);
    border-bottom: 1px solid var(--border-color);
 }
 /* Solar image gallery */
 .sw-image-panel {
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 12px;
 }
 .sw-image-tabs {
    display: flex;
    gap: 4px;
    margin-bottom: 8px;
 }
 .sw-image-tab {
    background: transparent;
    border: 1px solid var(--border-color);
    color: var(--text-dim);
    padding: 4px 10px;
    border-radius: 4px;
    font-size: 10px;
    font-weight: 600;
    cursor: pointer;
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
    transition: all 0.2s;
 }
 .sw-image-tab:hover {
    border-color: var(--text-secondary);
    color: var(--text-secondary);
 }
 .sw-image-tab.active {
    border-color: var(--accent-cyan);
    color: var(--accent-cyan);
    background: var(--accent-cyan)10;
 }
 .sw-image-frame {
    display: flex;
    align-items: center;
    justify-content: center;
    min-height: 200px;
    background: var(--bg-primary);
    border-radius: 4px;
    overflow: hidden;
 }
 .sw-image-frame img {
    max-width: 100%;
    max-height: 400px;
    object-fit: contain;
    border-radius: 4px;
 }
 /* D-RAP frequency selector */
 .sw-drap-freqs {
    display: flex;
    gap: 4px;
    margin-bottom: 8px;
    flex-wrap: wrap;
 }
 .sw-drap-freq-btn {
    background: transparent;
    border: 1px solid var(--border-color);
    color: var(--text-dim);
    padding: 3px 8px;
    border-radius: 3px;
    font-size: 10px;
    cursor: pointer;
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
    transition: all 0.2s;
 }
 .sw-drap-freq-btn:hover {
    border-color: var(--text-secondary);
    color: var(--text-secondary);
 }
 .sw-drap-freq-btn.active {
    border-color: var(--accent-cyan);
    color: var(--accent-cyan);
 }
 /* Alerts list */
 .sw-alerts-panel {
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 12px;
    max-height: 300px;
    overflow-y: auto;
 }
 .sw-alert-item {
    padding: 8px;
    border-bottom: 1px solid var(--border-color);
    font-size: 11px;
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
 }
 .sw-alert-item:last-child {
    border-bottom: none;
 }
 .sw-alert-type {
    font-weight: 600;
    color: var(--accent-cyan);
    font-size: 10px;
    text-transform: uppercase;
    margin-bottom: 2px;
 }
 .sw-alert-time {
    font-size: 10px;
    color: var(--text-dim);
    margin-bottom: 4px;
 }
 .sw-alert-msg {
    color: var(--text-secondary);
    line-height: 1.4;
    white-space: pre-wrap;
    font-size: 10px;
 }
 /* Active regions table */
 .sw-regions-panel {
    background: var(--bg-card);
    border: 1px solid var(--border-color);
    border-radius: 6px;
    padding: 12px;
    max-height: 300px;
    overflow-y: auto;
 }
 .sw-regions-table {
    width: 100%;
    border-collapse: collapse;
    font-size: 10px;
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
 }
 .sw-regions-table th {
    font-weight: 600;
    color: var(--text-dim);
    text-transform: uppercase;
    text-align: left;
    padding: 4px 6px;
    border-bottom: 1px solid var(--border-color);
    position: sticky;
    top: 0;
    background: var(--bg-card);
 }
 .sw-regions-table td {
    padding: 4px 6px;
    color: var(--text-secondary);
    border-bottom: 1px solid var(--border-color);
 }
 /* Empty / loading states */
 .sw-empty {
    text-align: center;
    padding: 20px;
    color: var(--text-dim);
    font-size: 11px;
    font-family: var(--font-mono, 'Roboto Condensed', monospace);
 }
 .sw-loading {
    text-align: center;
    padding: 20px;
    color: var(--text-dim);
    font-size: 11px;
 }
 .sw-loading::after {
    content: '';
    display: inline-block;
    width: 12px;
    height: 12px;
    border: 2px solid var(--border-color);
    border-top-color: var(--accent-cyan);
    border-radius: 50%;
    animation: sw-spin 0.8s linear infinite;
    margin-left: 8px;
    vertical-align: middle;
 }
@keyframes sw-spin {
    to { transform: rotate(360deg); }
 }
 /* Full-width card */
 .sw-full-width {
    grid-column: 1 / -1;
 }
 /* Responsive */
@media (max-width: 768px) {
    .sw-dashboard-grid {
        grid-template-columns: 1fr;
    }
    .sw-scales-row {
        grid-template-columns: 1fr;
    }
    .sw-header-strip {
        gap: 0;
    }
    .sw-header-stat {
        padding: 4px 8px;
        min-width: 50px;
    }
    .sw-header-value {
        font-size: 14px;
    }
 }
@@ -5,7 +5,7 @@
    padding: 8px 10px;
    background: var(--bg-tertiary, #1a1f2e);
    border-radius: 4px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
 }
@@ -86,7 +86,7 @@
    border-radius: 4px;
    background: var(--bg-tertiary, #1a1f2e);
    color: var(--text-primary, #e0e0e0);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
    cursor: pointer;
    transition: background 0.15s, border-color 0.15s;
@@ -113,7 +113,7 @@
    border-bottom: 2px solid transparent;
    background: transparent;
    color: var(--text-dim, #666);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
    text-transform: uppercase;
    cursor: pointer;
@@ -153,7 +153,7 @@
    display: inline-flex;
    align-items: center;
    gap: 7px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--text-secondary, #999);
    text-transform: uppercase;
@@ -168,7 +168,7 @@
 }
 .subghz-trigger-grid label {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 9px;
    color: var(--text-dim, #666);
    text-transform: uppercase;
@@ -182,7 +182,7 @@
    border-radius: 4px;
    background: var(--bg-primary, #0d1117);
    color: var(--text-primary, #e0e0e0);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
 }
@@ -192,7 +192,7 @@
 .subghz-trigger-help {
    margin: 0;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 9px;
    color: var(--text-dim, #666);
    line-height: 1.4;
@@ -207,7 +207,7 @@
    background: var(--bg-tertiary, #1a1f2e);
    border-radius: 4px;
    margin-bottom: 10px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
 }
@@ -264,7 +264,7 @@
    border-radius: 4px;
    background: transparent;
    color: var(--text-primary, #e0e0e0);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 12px;
    cursor: pointer;
    transition: background 0.15s, border-color 0.15s;
@@ -369,7 +369,7 @@
    background: var(--bg-tertiary, #1a1f2e);
    border: 1px solid var(--border-color, #2a3040);
    border-radius: 4px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
    min-width: 0;
    transition: border-color 0.15s, box-shadow 0.15s, background 0.15s;
@@ -416,7 +416,7 @@
    display: inline-flex;
    align-items: center;
    gap: 8px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 9px;
    text-transform: uppercase;
    letter-spacing: 0.5px;
@@ -446,7 +446,7 @@
    padding: 1px 6px;
    border-radius: 999px;
    border: 1px solid var(--border-color, #2a3040);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 9px;
    letter-spacing: 0.35px;
    color: var(--text-dim, #666);
@@ -512,7 +512,7 @@
    color: var(--text-dim, #666);
    font-size: 10px;
    cursor: pointer;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .subghz-capture-actions button:hover {
@@ -554,7 +554,7 @@
    border-radius: 4px;
    color: var(--accent-red, #ff4444);
    font-size: 10px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    line-height: 1.4;
    margin-bottom: 8px;
 }
@@ -591,7 +591,7 @@
    border-radius: 6px;
    padding: 12px;
    overflow-y: auto;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 12px;
    color: var(--text-primary, #e0e0e0);
    min-height: 200px;
@@ -695,12 +695,12 @@
 .subghz-tx-modal .tx-freq {
    color: var(--accent-cyan, #00d4ff);
    font-weight: 600;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .subghz-tx-modal .tx-duration {
    color: var(--text-dim, #666);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .subghz-tx-segment-box {
@@ -742,7 +742,7 @@
    border-radius: 4px;
    background: var(--bg-primary, #0d1117);
    color: var(--text-primary, #e0e0e0);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
 }
@@ -755,7 +755,7 @@
    margin-bottom: 0 !important;
    font-size: 11px !important;
    color: var(--accent-cyan, #00d4ff) !important;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .subghz-tx-burst-assist {
@@ -768,7 +768,7 @@
 }
 .subghz-tx-burst-title {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--text-dim, #666);
    text-transform: uppercase;
@@ -805,7 +805,7 @@
 .subghz-tx-burst-range {
    margin: 0 0 8px 0;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--accent-cyan, #00d4ff);
 }
@@ -839,7 +839,7 @@
    padding: 6px;
    border: 1px dashed var(--border-color, #2a3040);
    border-radius: 4px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--text-dim, #666);
    line-height: 1.4;
@@ -854,7 +854,7 @@
    border: 1px solid var(--border-color, #2a3040);
    border-radius: 4px;
    background: rgba(0, 0, 0, 0.15);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--text-secondary, #999);
 }
@@ -865,7 +865,7 @@
    border-radius: 3px;
    background: transparent;
    color: #00d4ff;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    cursor: pointer;
 }
@@ -884,7 +884,7 @@
 .subghz-tx-modal-actions button {
    padding: 8px 20px;
    border-radius: 4px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 12px;
    cursor: pointer;
    border: 1px solid;
@@ -926,7 +926,7 @@
    color: var(--text-dim, #666);
    font-size: 12px;
    padding: 24px 12px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .subghz-captures-list-main .subghz-empty {
@@ -943,7 +943,7 @@
    border: 1px solid #2a3040;
    border-radius: 4px;
    padding: 5px 9px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
    z-index: 9999;
    display: none;
@@ -970,7 +970,7 @@
    min-width: 180px;
    padding: 4px 0;
    box-shadow: 0 6px 20px rgba(0, 0, 0, 0.6);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
 }
@@ -1029,7 +1029,7 @@
    border-radius: 3px;
    background: transparent;
    color: var(--text-primary, #e0e0e0);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    cursor: pointer;
    transition: background 0.12s, border-color 0.12s, color 0.12s;
@@ -1068,7 +1068,7 @@
    content: 'No peaks detected';
    color: var(--text-dim, #666);
    font-size: 10px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    padding: 6px 0;
    text-align: center;
 }
@@ -1082,7 +1082,7 @@
    border: 1px solid var(--border-color, #2a3040);
    border-radius: 3px;
    cursor: pointer;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    transition: border-color 0.12s;
 }
@@ -1108,7 +1108,7 @@
    border: 1px solid var(--border-color, #2a3040);
    border-radius: 6px;
    padding: 6px 12px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
    flex-shrink: 0;
    flex-wrap: wrap;
@@ -1192,7 +1192,7 @@
    border-radius: 3px;
    background: transparent;
    color: #22c55e;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    cursor: pointer;
    text-transform: uppercase;
@@ -1211,7 +1211,7 @@
    padding: 2px 8px;
    border: 1px solid var(--border-color, #2a3040);
    border-radius: 3px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--text-secondary, #999);
    letter-spacing: 0.3px;
@@ -1263,7 +1263,7 @@
    display: flex;
    align-items: center;
    gap: 6px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
 }
@@ -1300,7 +1300,7 @@
    border-radius: 999px;
    margin-left: auto;
    margin-right: 8px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--text-dim, #666);
    background: rgba(0, 0, 0, 0.15);
@@ -1365,7 +1365,7 @@
    padding: 6px 12px;
    overflow-y: auto;
    max-height: 114px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    line-height: 1.6;
 }
@@ -1402,7 +1402,7 @@
 }
 .subghz-hub-header-title {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 20px;
    font-weight: 700;
    color: var(--accent-cyan, #00d4ff);
@@ -1410,7 +1410,7 @@
 }
 .subghz-hub-header-sub {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
    color: var(--text-dim, #666);
    margin-top: 2px;
@@ -1472,14 +1472,14 @@
 }
 .subghz-hub-title {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 14px;
    font-weight: 600;
    color: var(--text-primary, #e0e0e0);
 }
 .subghz-hub-desc {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--text-dim, #666);
 }
@@ -1526,7 +1526,7 @@
 }
 .subghz-saved-selection-count {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--accent-cyan, #00d4ff);
    margin-right: 4px;
@@ -1538,7 +1538,7 @@
    border-radius: 4px;
    background: transparent;
    color: var(--text-secondary, #999);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 11px;
    cursor: pointer;
    transition: border-color 0.15s, color 0.15s;
@@ -1550,7 +1550,7 @@
 }
 .subghz-op-panel-title {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 12px;
    color: var(--text-primary, #e0e0e0);
    text-transform: uppercase;
@@ -1620,7 +1620,7 @@
    display: flex;
    align-items: center;
    gap: 8px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 14px;
    font-weight: 600;
    color: var(--accent-red, #ff4444);
@@ -1654,14 +1654,14 @@
 }
 .subghz-rx-info-label {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 9px;
    color: var(--text-dim, #666);
    letter-spacing: 0.5px;
 }
 .subghz-rx-info-value {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 16px;
    font-weight: 600;
    color: var(--text-primary, #e0e0e0);
@@ -1688,7 +1688,7 @@
    border: 1px solid var(--border-color, #2a3040);
    border-radius: 4px;
    background: rgba(0, 0, 0, 0.22);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .subghz-rx-hint-label {
@@ -1722,7 +1722,7 @@
    padding: 2px 8px;
    border: 1px solid var(--border-color, #2a3040);
    border-radius: 999px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--text-dim, #666);
    background: rgba(0, 0, 0, 0.2);
@@ -1741,7 +1741,7 @@
 }
 .subghz-rx-level-label {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 9px;
    color: var(--text-dim, #666);
    letter-spacing: 0.5px;
@@ -1772,7 +1772,7 @@
 }
 .subghz-rx-scope-label {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 9px;
    color: var(--text-dim, #666);
    letter-spacing: 0.5px;
@@ -1832,7 +1832,7 @@
    display: flex;
    align-items: center;
    gap: 6px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 9px;
    color: var(--text-dim, #666);
    letter-spacing: 0.4px;
@@ -1854,7 +1854,7 @@
    border-radius: 4px;
    background: transparent;
    color: var(--text-secondary, #999);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    cursor: pointer;
    transition: border-color 0.15s, color 0.15s, background 0.15s;
@@ -1938,7 +1938,7 @@
 }
 .subghz-tx-label {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 14px;
    font-weight: 600;
    color: var(--accent-red, #ff4444);
@@ -1958,14 +1958,14 @@
 }
 .subghz-tx-info-label {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 9px;
    color: var(--text-dim, #666);
    letter-spacing: 0.5px;
 }
 .subghz-tx-info-value {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 16px;
    font-weight: 600;
    color: var(--text-primary, #e0e0e0);
@@ -1998,7 +1998,7 @@
 }
 .subghz-sweep-peaks-title {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    color: var(--text-dim, #666);
    text-transform: uppercase;
@@ -0,0 +1,31 @@
 /* VDL2 Mode Styles */
 /* VDL2 Status Indicator */
 .vdl2-status-dot.listening {
    background: var(--accent-cyan) !important;
    animation: vdl2-pulse 1.5s ease-in-out infinite;
 }
 .vdl2-status-dot.receiving {
    background: var(--accent-green) !important;
 }
 .vdl2-status-dot.error {
    background: var(--accent-red) !important;
 }
@keyframes vdl2-pulse {
    0%, 100% { opacity: 1; box-shadow: 0 0 0 0 rgba(74, 158, 255, 0.7); }
    50% { opacity: 0.6; box-shadow: 0 0 6px 3px rgba(74, 158, 255, 0.3); }
 }
 /* VDL2 message animation */
 .vdl2-msg {
    padding: 6px 8px;
    border-bottom: 1px solid var(--border-color);
    animation: vdl2FadeIn 0.3s ease;
 }
 .vdl2-msg:hover {
    background: rgba(74, 158, 255, 0.05);
 }
@keyframes vdl2FadeIn {
    from { opacity: 0; transform: translateY(-3px); }
    to { opacity: 1; transform: translateY(0); }
 }
@@ -49,7 +49,7 @@
 .wxsat-strip-status-text {
    font-size: 12px;
    color: var(--text-secondary, #999);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .wxsat-strip-btn {
@@ -59,7 +59,7 @@
    background: transparent;
    color: var(--text-primary, #e0e0e0);
    font-size: 11px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    cursor: pointer;
    transition: all 0.2s;
 }
@@ -92,7 +92,7 @@
 .wxsat-strip-value {
    font-size: 13px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    color: var(--text-primary, #e0e0e0);
 }
@@ -114,7 +114,7 @@
    gap: 6px;
    cursor: pointer;
    font-size: 10px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    color: var(--text-dim, #666);
    text-transform: uppercase;
    letter-spacing: 0.5px;
@@ -146,7 +146,7 @@
    border-radius: 3px;
    color: var(--text-primary, #e0e0e0);
    font-size: 11px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .wxsat-loc-input:focus {
@@ -225,7 +225,7 @@
 .wxsat-cd-value {
    font-size: 16px;
    font-weight: 700;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    color: var(--text-primary, #e0e0e0);
    line-height: 1;
 }
@@ -248,13 +248,13 @@
    font-size: 12px;
    font-weight: 600;
    color: var(--accent-cyan, #00d4ff);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .wxsat-countdown-detail {
    font-size: 10px;
    color: var(--text-dim, #666);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 /* ===== Timeline ===== */
@@ -314,7 +314,7 @@
    justify-content: space-between;
    font-size: 8px;
    color: var(--text-dim, #666);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 /* ===== Pass Predictions Panel ===== */
@@ -349,7 +349,7 @@
 .wxsat-passes-count {
    font-size: 11px;
    color: var(--accent-cyan, #00d4ff);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .wxsat-passes-list {
@@ -387,7 +387,7 @@
    background: rgba(255, 187, 0, 0.15);
    color: #ffbb00;
    margin-left: 6px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    text-transform: uppercase;
    letter-spacing: 0.5px;
 }
@@ -409,7 +409,7 @@
    font-size: 10px;
    padding: 2px 6px;
    border-radius: 3px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .wxsat-pass-mode.apt {
@@ -428,7 +428,7 @@
    gap: 4px;
    font-size: 11px;
    color: var(--text-dim, #666);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .wxsat-pass-detail-label {
@@ -499,7 +499,7 @@
 .wxsat-panel-subtitle {
    font-size: 10px;
    color: var(--accent-cyan, #00d4ff);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 #wxsatPolarCanvas {
@@ -509,10 +509,95 @@
    max-height: 300px;
 }
-.wxsat-ground-map {
+.wxsat-ground-map {
-    height: 200px;
+    position: relative;
-    background: var(--bg-primary, #0d1117);
+    height: 200px;
-}
+    overflow: hidden;
    background: linear-gradient(180deg, #061329 0%, #050d1a 54%, #061325 100%);
 }
 .wxsat-ground-map .leaflet-container {
    width: 100%;
    height: 100%;
    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .leaflet-container.map-theme-cyber .leaflet-overlay-pane path.wxsat-pass-track {
    filter: drop-shadow(0 0 5px rgba(91, 240, 255, 0.35));
 }
 .leaflet-container.map-theme-cyber .leaflet-overlay-pane path.wxsat-pass-track.lrpt {
    filter: drop-shadow(0 0 6px rgba(0, 255, 190, 0.35));
 }
 .wxsat-crosshair-icon {
    background: transparent;
    border: none;
 }
 .wxsat-crosshair-marker {
    position: relative;
    width: 30px;
    height: 30px;
 }
 .wxsat-crosshair-h,
 .wxsat-crosshair-v,
 .wxsat-crosshair-ring,
 .wxsat-crosshair-dot {
    position: absolute;
    display: block;
 }
 .wxsat-crosshair-h {
    top: 50%;
    left: 2px;
    right: 2px;
    height: 1px;
    background: rgba(255, 93, 93, 0.95);
    transform: translateY(-50%);
 }
 .wxsat-crosshair-v {
    left: 50%;
    top: 2px;
    bottom: 2px;
    width: 1px;
    background: rgba(255, 93, 93, 0.95);
    transform: translateX(-50%);
 }
 .wxsat-crosshair-ring {
    inset: 6px;
    border: 1.5px solid rgba(255, 93, 93, 0.95);
    border-radius: 50%;
    box-shadow: 0 0 10px rgba(255, 93, 93, 0.55);
 }
 .wxsat-crosshair-dot {
    width: 5px;
    height: 5px;
    left: 50%;
    top: 50%;
    border-radius: 50%;
    background: #ffa0a0;
    box-shadow: 0 0 6px rgba(255, 100, 100, 0.65);
    transform: translate(-50%, -50%);
 }
 .wxsat-map-tooltip {
    background: rgba(5, 15, 32, 0.92);
    border: 1px solid rgba(102, 229, 255, 0.65);
    border-radius: 4px;
    color: #8fe8ff;
    box-shadow: 0 0 12px rgba(0, 210, 255, 0.24);
    font-size: 10px;
    letter-spacing: 0.25px;
 }
 .wxsat-map-tooltip.leaflet-tooltip-top:before {
    border-top-color: rgba(102, 229, 255, 0.65);
 }
 /* ===== Image Gallery Panel ===== */
 .wxsat-gallery-panel {
@@ -547,7 +632,7 @@
 .wxsat-gallery-count {
    font-size: 11px;
    color: var(--accent-cyan, #00d4ff);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .wxsat-gallery-grid {
@@ -636,7 +721,7 @@
 .wxsat-image-product {
    font-size: 10px;
    color: var(--accent-cyan, #00d4ff);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .wxsat-image-timestamp {
@@ -649,7 +734,7 @@
 .wxsat-date-header {
    grid-column: 1 / -1;
    font-size: 11px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    color: var(--text-dim, #666);
    text-transform: uppercase;
    letter-spacing: 0.5px;
@@ -708,7 +793,7 @@
 .wxsat-capture-message {
    font-size: 11px;
    color: var(--text-secondary, #999);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    overflow: hidden;
    text-overflow: ellipsis;
    white-space: nowrap;
@@ -719,7 +804,7 @@
 .wxsat-capture-elapsed {
    font-size: 11px;
    color: var(--text-dim, #666);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    flex-shrink: 0;
 }
@@ -785,7 +870,7 @@
    border-radius: 4px;
    color: var(--text-secondary, #999);
    font-size: 12px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    text-align: center;
 }
@@ -941,7 +1026,7 @@
    display: flex;
    align-items: center;
    gap: 4px;
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
 }
 .wxsat-phase-step {
@@ -1012,7 +1097,7 @@
    max-height: 160px;
    padding: 6px 12px;
    background: var(--bg-primary, #0d1117);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'Roboto Condensed', 'Arial Narrow', sans-serif;
    font-size: 10px;
    line-height: 1.6;
 }
@@ -428,7 +428,7 @@
    /* Visual panels should be scrollable, not clipped */
    .wifi-visuals,
-    .bt-visuals {
+    .bt-visuals-column {
        max-height: none !important;
        overflow: visible !important;
        margin-bottom: 15px;
@@ -444,7 +444,7 @@
    /* Visual panels should stack in single column on mobile when visible */
    .wifi-visuals,
-    .bt-visuals {
+    .bt-visuals-column {
        display: flex;
        flex-direction: column;
        gap: 10px;
@@ -465,6 +465,34 @@
    .wifi-visual-panel {
        grid-column: auto !important;
    }
    .bt-main-area {
        flex-direction: column !important;
        min-height: auto !important;
    }
    .bt-side-panels {
        width: 100% !important;
        flex-direction: column !important;
    }
    .bt-detail-grid {
        grid-template-columns: repeat(2, minmax(0, 1fr)) !important;
    }
    .bt-row-secondary {
        padding-left: 0 !important;
        white-space: normal !important;
    }
    .bt-row-actions {
        padding-left: 0 !important;
        justify-content: flex-start !important;
    }
    .bt-list-summary {
        grid-template-columns: repeat(2, minmax(0, 1fr)) !important;
    }
 }
 /* ============== MOBILE MAP FIXES ============== */
@@ -5,8 +5,8 @@
 }
 :root {
-    --font-sans: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-sans: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
-    --font-mono: 'IBM Plex Mono', 'Space Mono', ui-monospace, 'SF Mono', 'Consolas', 'Menlo', monospace;
+    --font-mono: 'Roboto Condensed', 'Arial Narrow', Roboto, 'Helvetica Neue', Arial, sans-serif;
    --bg-dark: #0b1118;
    --bg-panel: #101823;
    --bg-card: #151f2b;
@@ -479,6 +479,54 @@
    filter: sepia(0.35) hue-rotate(185deg) saturate(1.75) brightness(1.06) contrast(1.05);
 }
 /* Global Leaflet map theme: cyber overlay */
 .leaflet-container.map-theme-cyber {
    position: relative;
    background: #020813;
    isolation: isolate;
 }
 .leaflet-container.map-theme-cyber .leaflet-tile-pane {
    filter: sepia(0.74) hue-rotate(176deg) saturate(1.72) brightness(1.05) contrast(1.08);
    opacity: 1;
 }
 /* Hard global fallback: enforce cyber tint on all Leaflet tile images */
 html.map-cyber-enabled .leaflet-container .leaflet-tile {
    filter: sepia(0.74) hue-rotate(176deg) saturate(1.72) brightness(1.05) contrast(1.08) !important;
 }
 /* Hard global fallback: cyber glow + grid overlay */
 html.map-cyber-enabled .leaflet-container {
    position: relative;
    isolation: isolate;
 }
 html.map-cyber-enabled .leaflet-container::before {
    content: '';
    position: absolute;
    inset: 0;
    pointer-events: none;
    z-index: 620;
    background:
        radial-gradient(95% 78% at 50% 44%, rgba(18, 170, 255, 0.17), rgba(18, 170, 255, 0) 64%),
        linear-gradient(180deg, rgba(24, 118, 255, 0.045), rgba(24, 118, 255, 0));
 }
 html.map-cyber-enabled .leaflet-container::after {
    content: '';
    position: absolute;
    inset: 0;
    pointer-events: none;
    z-index: 621;
    opacity: 0.42;
    mix-blend-mode: screen;
    background-image:
        linear-gradient(rgba(78, 188, 255, 0.14) 1px, transparent 1px),
        linear-gradient(90deg, rgba(78, 188, 255, 0.14) 1px, transparent 1px);
    background-size: 52px 52px, 52px 52px;
 }
 /* Responsive */
@media (max-width: 960px) {
    .settings-tabs {
@@ -0,0 +1,20 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
  <!-- Background -->
  <rect width="100" height="100" fill="#0a0a0f"/>
  <!-- Signal brackets - left side -->
  <path d="M15 30 Q5 50, 15 70" stroke="#00d4ff" stroke-width="4" fill="none" stroke-linecap="round" opacity="0.5"/>
  <path d="M22 35 Q14 50, 22 65" stroke="#00d4ff" stroke-width="3.5" fill="none" stroke-linecap="round" opacity="0.7"/>
  <path d="M29 40 Q23 50, 29 60" stroke="#00d4ff" stroke-width="3" fill="none" stroke-linecap="round"/>
  <!-- Signal brackets - right side -->
  <path d="M85 30 Q95 50, 85 70" stroke="#00d4ff" stroke-width="4" fill="none" stroke-linecap="round" opacity="0.5"/>
  <path d="M78 35 Q86 50, 78 65" stroke="#00d4ff" stroke-width="3.5" fill="none" stroke-linecap="round" opacity="0.7"/>
  <path d="M71 40 Q77 50, 71 60" stroke="#00d4ff" stroke-width="3" fill="none" stroke-linecap="round"/>
  <!-- The 'i' letter -->
  <circle cx="50" cy="22" r="7" fill="#00ff88"/>
  <rect x="43" y="35" width="14" height="45" rx="2" fill="#00d4ff"/>
  <rect x="36" y="35" width="28" height="5" rx="1" fill="#00d4ff"/>
  <rect x="36" y="75" width="28" height="5" rx="1" fill="#00d4ff"/>
 </svg>
@@ -1,7 +1,7 @@
 /**
 * Activity Timeline Component
 * Reusable, configuration-driven timeline visualization for time-based metadata
- * Supports multiple modes: TSCM, Listening Post, Bluetooth, WiFi, Monitoring
+ * Supports multiple modes: TSCM, RF Receiver, Bluetooth, WiFi, Monitoring
 */
 const ActivityTimeline = (function() {
@@ -176,7 +176,7 @@ const ActivityTimeline = (function() {
     */
    function categorizeById(id, mode) {
        // RF frequency categorization
-        if (mode === 'rf' || mode === 'tscm' || mode === 'listening-post') {
+        if (mode === 'rf' || mode === 'tscm' || mode === 'waterfall') {
            const f = parseFloat(id);
            if (!isNaN(f)) {
                if (f >= 2400 && f <= 2500) return '2.4 GHz wireless band';
@@ -33,8 +33,6 @@ const ProximityRadar = (function() {
    let activeFilter = null;
    let onDeviceClick = null;
    let selectedDeviceKey = null;
    let isHovered = false;
    let renderPending = false;
    let renderTimer = null;
    /**
@@ -119,6 +117,18 @@ const ProximityRadar = (function() {
        svg = container.querySelector('svg');
        // Event delegation on the devices group (survives innerHTML rebuilds)
        const devicesGroup = svg.querySelector('.radar-devices');
        devicesGroup.addEventListener('click', (e) => {
            const deviceEl = e.target.closest('.radar-device');
            if (!deviceEl) return;
            const deviceKey = deviceEl.getAttribute('data-device-key');
            if (onDeviceClick && deviceKey) {
                onDeviceClick(deviceKey);
            }
        });
        // Add sweep animation
        animateSweep();
    }
@@ -160,17 +170,10 @@ const ProximityRadar = (function() {
    function updateDevices(deviceList) {
        if (isPaused) return;
        // Update device map
        deviceList.forEach(device => {
            devices.set(device.device_key, device);
        });
        // Defer render while user is hovering to prevent DOM rebuild flicker
        if (isHovered) {
            renderPending = true;
            return;
        }
        // Debounce rapid updates (e.g. per-device SSE events)
        if (renderTimer) clearTimeout(renderTimer);
        renderTimer = setTimeout(() => {
@@ -180,7 +183,9 @@ const ProximityRadar = (function() {
    }
    /**
-     * Render device dots on the radar
+     * Render device dots on the radar using in-place DOM updates.
     * Elements are never destroyed and recreated — only their attributes and
     * transforms are mutated — so hover state is never disturbed by a render.
     */
    function renderDevices() {
        const devicesGroup = svg.querySelector('.radar-devices');
@@ -188,6 +193,7 @@ const ProximityRadar = (function() {
        const center = CONFIG.size / 2;
        const maxRadius = center - CONFIG.padding;
        const ns = 'http://www.w3.org/2000/svg';
        // Filter devices
        let visibleDevices = Array.from(devices.values());
@@ -203,87 +209,195 @@ const ProximityRadar = (function() {
            visibleDevices = visibleDevices.filter(d => !d.in_baseline);
        }
-        // Build SVG for each device
+        const visibleKeys = new Set(visibleDevices.map(d => d.device_key));
        const dots = visibleDevices.map(device => {
            // Calculate position
            const { x, y, radius } = calculateDevicePosition(device, center, maxRadius);
-            // Calculate dot size based on confidence
+        // Remove elements for devices no longer in the visible set
        devicesGroup.querySelectorAll('.radar-device-wrapper').forEach(el => {
            if (!visibleKeys.has(el.getAttribute('data-device-key'))) {
                el.remove();
            }
        });
        // Sort weakest signal first so strongest renders on top (SVG z-order)
        visibleDevices.sort((a, b) => (a.rssi_current || -100) - (b.rssi_current || -100));
        // Compute all positions upfront so we can spread overlapping dots
        const posMap = new Map();
        visibleDevices.forEach(device => {
            posMap.set(device.device_key, calculateDevicePosition(device, center, maxRadius));
        });
        // Spread dots that land too close together within the same band.
        // minGapPx = diameter of largest possible hit area + 2px breathing room.
        const maxHitArea = CONFIG.dotMaxSize + 4;
        spreadOverlappingDots(Array.from(posMap.values()), center, maxHitArea * 2 + 2);
        visibleDevices.forEach(device => {
            const { x, y } = posMap.get(device.device_key);
            const confidence = device.distance_confidence || 0.5;
            const dotSize = CONFIG.dotMinSize + (CONFIG.dotMaxSize - CONFIG.dotMinSize) * confidence;
            // Get color based on proximity band
            const color = getBandColor(device.proximity_band);
            // Check if newly seen (pulse animation)
            const isNew = device.age_seconds < 5;
-            const pulseClass = isNew ? 'radar-dot-pulse' : '';
+            const isSelected = !!(selectedDeviceKey && device.device_key === selectedDeviceKey);
-            const isSelected = selectedDeviceKey && device.device_key === selectedDeviceKey;
+            const hitAreaSize = dotSize + 4;
            const key = device.device_key;
-            // Hit area size (prevents hover flicker when scaling)
+            const existing = devicesGroup.querySelector(
-            const hitAreaSize = Math.max(dotSize * 2, 15);
+                `.radar-device-wrapper[data-device-key="${CSS.escape(key)}"]`
            );
-            return `
+            if (existing) {
-                <g transform="translate(${x}, ${y})">
+                // ── In-place update: mutate attributes, never recreate ──
-                    <g class="radar-device ${pulseClass}${isSelected ? ' selected' : ''}" data-device-key="${escapeAttr(device.device_key)}"
+                existing.setAttribute('transform', `translate(${x}, ${y})`);
                       style="cursor: pointer;">
                        <!-- Invisible hit area to prevent hover flicker -->
                        <circle class="radar-device-hitarea" r="${hitAreaSize}" fill="transparent" />
                        ${isSelected ? `<circle r="${dotSize + 8}" fill="none" stroke="#00d4ff" stroke-width="2" stroke-opacity="0.8">
                            <animate attributeName="r" values="${dotSize + 6};${dotSize + 10};${dotSize + 6}" dur="1.5s" repeatCount="indefinite"/>
                            <animate attributeName="stroke-opacity" values="0.8;0.4;0.8" dur="1.5s" repeatCount="indefinite"/>
                        </circle>` : ''}
                        <circle r="${dotSize}" fill="${color}"
                                fill-opacity="${isSelected ? 1 : 0.4 + confidence * 0.5}"
                                stroke="${isSelected ? '#00d4ff' : color}" stroke-width="${isSelected ? 2 : 1}" />
                        ${device.is_new && !isSelected ? `<circle r="${dotSize + 3}" fill="none" stroke="#3b82f6" stroke-width="1" stroke-dasharray="2,2" />` : ''}
                        <title>${escapeHtml(device.name || device.address)} (${device.rssi_current || '--'} dBm)</title>
                    </g>
                </g>
            `;
        }).join('');
-        devicesGroup.innerHTML = dots;
+                const innerG = existing.querySelector('.radar-device');
                if (innerG) {
                    innerG.className.baseVal =
                        `radar-device${isNew ? ' radar-dot-pulse' : ''}${isSelected ? ' selected' : ''}`;
-        // Attach event handlers
+                    const hitArea = innerG.querySelector('.radar-device-hitarea');
-        devicesGroup.querySelectorAll('.radar-device').forEach(el => {
+                    if (hitArea) hitArea.setAttribute('r', hitAreaSize);
-            el.addEventListener('click', (e) => {
+
-                const deviceKey = el.getAttribute('data-device-key');
+                    const dot = innerG.querySelector('.radar-dot');
-                if (onDeviceClick && deviceKey) {
+                    if (dot) {
-                    onDeviceClick(deviceKey);
+                        dot.setAttribute('r', dotSize);
                        dot.setAttribute('fill', color);
                        dot.setAttribute('fill-opacity', isSelected ? 1 : 0.4 + confidence * 0.5);
                        dot.setAttribute('stroke', isSelected ? '#00d4ff' : color);
                        dot.setAttribute('stroke-width', isSelected ? 2 : 1);
                    }
                    const title = innerG.querySelector('title');
                    if (title) {
                        title.textContent =
                            `${escapeHtml(device.name || device.address)} (${device.rssi_current || '--'} dBm)`;
                    }
                    // Selection ring: add if newly selected, remove if deselected
                    let ring = innerG.querySelector('.radar-select-ring');
                    if (isSelected && !ring) {
                        ring = buildSelectRing(ns, dotSize);
                        const hitAreaEl = innerG.querySelector('.radar-device-hitarea');
                        innerG.insertBefore(ring, hitAreaEl ? hitAreaEl.nextSibling : innerG.firstChild);
                    } else if (!isSelected && ring) {
                        ring.remove();
                    }
                    // New-device indicator ring
                    let newRing = innerG.querySelector('.radar-new-ring');
                    if (device.is_new && !isSelected) {
                        if (!newRing) {
                            newRing = document.createElementNS(ns, 'circle');
                            newRing.classList.add('radar-new-ring');
                            newRing.setAttribute('fill', 'none');
                            newRing.setAttribute('stroke', '#3b82f6');
                            newRing.setAttribute('stroke-width', '1');
                            newRing.setAttribute('stroke-dasharray', '2,2');
                            innerG.appendChild(newRing);
                        }
                        newRing.setAttribute('r', dotSize + 3);
                    } else if (newRing) {
                        newRing.remove();
                    }
                }
-            });
+            } else {
-            el.addEventListener('mouseenter', () => { isHovered = true; });
+                // ── Create new element ──
-            el.addEventListener('mouseleave', () => {
+                const wrapperG = document.createElementNS(ns, 'g');
-                isHovered = false;
+                wrapperG.classList.add('radar-device-wrapper');
-                if (renderPending) {
+                wrapperG.setAttribute('data-device-key', key);
-                    renderPending = false;
+                wrapperG.setAttribute('transform', `translate(${x}, ${y})`);
-                    renderDevices();
+
                const innerG = document.createElementNS(ns, 'g');
                innerG.classList.add('radar-device');
                if (isNew) innerG.classList.add('radar-dot-pulse');
                if (isSelected) innerG.classList.add('selected');
                innerG.setAttribute('data-device-key', escapeAttr(key));
                innerG.style.cursor = 'pointer';
                const hitArea = document.createElementNS(ns, 'circle');
                hitArea.classList.add('radar-device-hitarea');
                hitArea.setAttribute('r', hitAreaSize);
                hitArea.setAttribute('fill', 'transparent');
                innerG.appendChild(hitArea);
                if (isSelected) {
                    innerG.appendChild(buildSelectRing(ns, dotSize));
                }
-            });
+
                const dot = document.createElementNS(ns, 'circle');
                dot.classList.add('radar-dot');
                dot.setAttribute('r', dotSize);
                dot.setAttribute('fill', color);
                dot.setAttribute('fill-opacity', isSelected ? 1 : 0.4 + confidence * 0.5);
                dot.setAttribute('stroke', isSelected ? '#00d4ff' : color);
                dot.setAttribute('stroke-width', isSelected ? 2 : 1);
                innerG.appendChild(dot);
                if (device.is_new && !isSelected) {
                    const newRing = document.createElementNS(ns, 'circle');
                    newRing.classList.add('radar-new-ring');
                    newRing.setAttribute('r', dotSize + 3);
                    newRing.setAttribute('fill', 'none');
                    newRing.setAttribute('stroke', '#3b82f6');
                    newRing.setAttribute('stroke-width', '1');
                    newRing.setAttribute('stroke-dasharray', '2,2');
                    innerG.appendChild(newRing);
                }
                const title = document.createElementNS(ns, 'title');
                title.textContent =
                    `${escapeHtml(device.name || device.address)} (${device.rssi_current || '--'} dBm)`;
                innerG.appendChild(title);
                wrapperG.appendChild(innerG);
                devicesGroup.appendChild(wrapperG);
            }
        });
    }
    /**
     * Build an animated SVG selection ring element
     */
    function buildSelectRing(ns, dotSize) {
        const ring = document.createElementNS(ns, 'circle');
        ring.classList.add('radar-select-ring');
        ring.setAttribute('r', dotSize + 8);
        ring.setAttribute('fill', 'none');
        ring.setAttribute('stroke', '#00d4ff');
        ring.setAttribute('stroke-width', '2');
        ring.setAttribute('stroke-opacity', '0.8');
        const animR = document.createElementNS(ns, 'animate');
        animR.setAttribute('attributeName', 'r');
        animR.setAttribute('values', `${dotSize + 6};${dotSize + 10};${dotSize + 6}`);
        animR.setAttribute('dur', '1.5s');
        animR.setAttribute('repeatCount', 'indefinite');
        ring.appendChild(animR);
        const animO = document.createElementNS(ns, 'animate');
        animO.setAttribute('attributeName', 'stroke-opacity');
        animO.setAttribute('values', '0.8;0.4;0.8');
        animO.setAttribute('dur', '1.5s');
        animO.setAttribute('repeatCount', 'indefinite');
        ring.appendChild(animO);
        return ring;
    }
    /**
     * Calculate device position on radar
     */
    function calculateDevicePosition(device, center, maxRadius) {
-        // Calculate radius based on proximity band/distance
+        // Position is band-only — the band is computed server-side from rssi_ema
        // (already smoothed), so it changes infrequently and never jitters.
        // Using raw estimated_distance_m caused constant micro-movement as RSSI
        // fluctuated on every update cycle.
        let radiusRatio;
-        const band = device.proximity_band || 'unknown';
+        switch (device.proximity_band || 'unknown') {
-
+            case 'immediate': radiusRatio = 0.15; break;
-        if (device.estimated_distance_m != null) {
+            case 'near':      radiusRatio = 0.40; break;
-            // Use actual distance (log scale)
+            case 'far':       radiusRatio = 0.70; break;
-            const maxDistance = 15;
+            default:          radiusRatio = 0.90; break;
            radiusRatio = Math.min(1, Math.log10(device.estimated_distance_m + 1) / Math.log10(maxDistance + 1));
        } else {
            // Use band-based positioning
            switch (band) {
                case 'immediate': radiusRatio = 0.15; break;
                case 'near': radiusRatio = 0.4; break;
                case 'far': radiusRatio = 0.7; break;
                default: radiusRatio = 0.9; break;
            }
        }
        // Calculate angle based on device key hash (stable positioning)
@@ -293,7 +407,53 @@ const ProximityRadar = (function() {
        const x = center + Math.sin(angle) * radius;
        const y = center - Math.cos(angle) * radius;
-        return { x, y, radius };
+        return { x, y, angle, radius };
    }
    /**
     * Spread dots within the same band that land too close together.
     * Groups entries by radius, sorts by angle, then nudges neighbours
     * apart until the arc gap between any two dots is at least minGapPx.
     * Positions are updated in-place on the entry objects.
     */
    function spreadOverlappingDots(entries, center, minGapPx) {
        const groups = new Map();
        entries.forEach(e => {
            const key = Math.round(e.radius);
            if (!groups.has(key)) groups.set(key, []);
            groups.get(key).push(e);
        });
        groups.forEach((group, r) => {
            if (group.length < 2 || r < 1) return;
            const minSep = minGapPx / r; // radians
            group.sort((a, b) => a.angle - b.angle);
            // Iterative push-apart (up to 8 passes)
            for (let iter = 0; iter < 8; iter++) {
                let moved = false;
                for (let i = 0; i < group.length; i++) {
                    const j = (i + 1) % group.length;
                    let gap = group[j].angle - group[i].angle;
                    if (gap < 0) gap += 2 * Math.PI;
                    if (gap < minSep) {
                        const push = (minSep - gap) / 2;
                        group[i].angle -= push;
                        group[j].angle += push;
                        moved = true;
                    }
                }
                if (!moved) break;
            }
            // Normalise angles back to [0, 2π) and recompute x/y
            group.forEach(e => {
                e.angle = ((e.angle % (2 * Math.PI)) + 2 * Math.PI) % (2 * Math.PI);
                e.x = center + Math.sin(e.angle) * r;
                e.y = center - Math.cos(e.angle) * r;
            });
        });
    }
    /**
@@ -345,19 +505,125 @@ const ProximityRadar = (function() {
    }
    /**
-     * Highlight a specific device on the radar
+     * Highlight a specific device on the radar (in-place update, no full re-render)
     */
    function highlightDevice(deviceKey) {
        const prev = selectedDeviceKey;
        selectedDeviceKey = deviceKey;
-        renderDevices();
+
        if (!svg) { return; }
        const devicesGroup = svg.querySelector('.radar-devices');
        if (!devicesGroup) { return; }
        // Remove highlight from previously selected node
        if (prev && prev !== deviceKey) {
            const oldEl = devicesGroup.querySelector(`.radar-device[data-device-key="${CSS.escape(prev)}"]`);
            if (oldEl) {
                oldEl.classList.remove('selected');
                // Remove animated selection ring
                const ring = oldEl.querySelector('.radar-select-ring');
                if (ring) ring.remove();
                // Restore dot opacity
                const dot = oldEl.querySelector('circle:not(.radar-device-hitarea):not(.radar-select-ring)');
                if (dot && dot.getAttribute('fill') !== 'none' && dot.getAttribute('fill') !== 'transparent') {
                    const device = devices.get(prev);
                    const confidence = device ? (device.distance_confidence || 0.5) : 0.5;
                    dot.setAttribute('fill-opacity', 0.4 + confidence * 0.5);
                    dot.setAttribute('stroke', dot.getAttribute('fill'));
                    dot.setAttribute('stroke-width', '1');
                }
            }
        }
        // Add highlight to newly selected node
        if (deviceKey) {
            const newEl = devicesGroup.querySelector(`.radar-device[data-device-key="${CSS.escape(deviceKey)}"]`);
            if (newEl) {
                applySelectionToElement(newEl, deviceKey);
            } else {
                // Node not in DOM yet; full render needed on next cycle
                renderDevices();
            }
        }
    }
    /**
-     * Clear device highlighting
+     * Apply selection styling to a radar device element in-place
     */
    function applySelectionToElement(el, deviceKey) {
        el.classList.add('selected');
        const device = devices.get(deviceKey);
        const confidence = device ? (device.distance_confidence || 0.5) : 0.5;
        const dotSize = CONFIG.dotMinSize + (CONFIG.dotMaxSize - CONFIG.dotMinSize) * confidence;
        // Update dot styling
        const dot = el.querySelector('circle:not(.radar-device-hitarea):not(.radar-select-ring)');
        if (dot && dot.getAttribute('fill') !== 'none' && dot.getAttribute('fill') !== 'transparent') {
            dot.setAttribute('fill-opacity', '1');
            dot.setAttribute('stroke', '#00d4ff');
            dot.setAttribute('stroke-width', '2');
        }
        // Add animated selection ring if not already present
        if (!el.querySelector('.radar-select-ring')) {
            const ns = 'http://www.w3.org/2000/svg';
            const ring = document.createElementNS(ns, 'circle');
            ring.classList.add('radar-select-ring');
            ring.setAttribute('r', dotSize + 8);
            ring.setAttribute('fill', 'none');
            ring.setAttribute('stroke', '#00d4ff');
            ring.setAttribute('stroke-width', '2');
            ring.setAttribute('stroke-opacity', '0.8');
            const animR = document.createElementNS(ns, 'animate');
            animR.setAttribute('attributeName', 'r');
            animR.setAttribute('values', `${dotSize + 6};${dotSize + 10};${dotSize + 6}`);
            animR.setAttribute('dur', '1.5s');
            animR.setAttribute('repeatCount', 'indefinite');
            ring.appendChild(animR);
            const animO = document.createElementNS(ns, 'animate');
            animO.setAttribute('attributeName', 'stroke-opacity');
            animO.setAttribute('values', '0.8;0.4;0.8');
            animO.setAttribute('dur', '1.5s');
            animO.setAttribute('repeatCount', 'indefinite');
            ring.appendChild(animO);
            // Insert after the hit area
            const hitArea = el.querySelector('.radar-device-hitarea');
            if (hitArea && hitArea.nextSibling) {
                el.insertBefore(ring, hitArea.nextSibling);
            } else {
                el.insertBefore(ring, el.firstChild);
            }
        }
    }
    /**
     * Clear device highlighting (in-place update, no full re-render)
     */
    function clearHighlight() {
        const prev = selectedDeviceKey;
        selectedDeviceKey = null;
-        renderDevices();
+
        if (!svg || !prev) { return; }
        const devicesGroup = svg.querySelector('.radar-devices');
        if (!devicesGroup) { return; }
        const oldEl = devicesGroup.querySelector(`.radar-device[data-device-key="${CSS.escape(prev)}"]`);
        if (oldEl) {
            oldEl.classList.remove('selected');
            const ring = oldEl.querySelector('.radar-select-ring');
            if (ring) ring.remove();
            const dot = oldEl.querySelector('circle:not(.radar-device-hitarea):not(.radar-select-ring)');
            if (dot && dot.getAttribute('fill') !== 'none' && dot.getAttribute('fill') !== 'transparent') {
                const device = devices.get(prev);
                const confidence = device ? (device.distance_confidence || 0.5) : 0.5;
                dot.setAttribute('fill-opacity', 0.4 + confidence * 0.5);
                dot.setAttribute('stroke', dot.getAttribute('fill'));
                dot.setAttribute('stroke-width', '1');
            }
        }
    }
    /**
@@ -302,7 +302,13 @@ const SignalCards = (function() {
     */
    function formatRelativeTime(timestamp) {
        if (!timestamp) return '';
-        const date = new Date(timestamp);
+        let date = new Date(timestamp);
        // Handle time-only strings like "HH:MM:SS" (from pager/sensor backends)
        if (isNaN(date.getTime()) && /^\d{1,2}:\d{2}(:\d{2})?$/.test(timestamp)) {
            const today = new Date();
            date = new Date(today.toDateString() + ' ' + timestamp);
        }
        if (isNaN(date.getTime())) return timestamp;
        const now = new Date();
        const diff = Math.floor((now - date) / 1000);
@@ -289,23 +289,10 @@ const SignalGuess = (function() {
            regions: ['GLOBAL']
        },
-        // LoRaWAN
+        // Key Fob
-        {
+        {
-            label: 'LoRaWAN / LoRa Device',
+            label: 'Remote Control / Key Fob',
-            tags: ['iot', 'lora', 'lpwan', 'telemetry'],
+            tags: ['remote', 'keyfob', 'automotive', 'burst', 'ism'],
            description: 'LoRa long-range IoT device',
            frequencyRanges: [[863000000, 870000000], [902000000, 928000000]],
            modulationHints: ['LoRa', 'CSS', 'FSK'],
            bandwidthRange: [125000, 500000],
            baseScore: 11,
            isBurstType: true,
            regions: ['UK/EU', 'US']
        },
        // Key Fob
        {
            label: 'Remote Control / Key Fob',
            tags: ['remote', 'keyfob', 'automotive', 'burst', 'ism'],
            description: 'Wireless remote control or vehicle key fob',
            frequencyRanges: [[314900000, 315100000], [433050000, 434790000], [867000000, 869000000]],
            modulationHints: ['OOK', 'ASK', 'FSK', 'rolling'],
@@ -1,8 +1,8 @@
-/**
+/**
- * RF Signal Timeline Adapter
+ * RF Signal Timeline Adapter
- * Normalizes RF signal data for the Activity Timeline component
+ * Normalizes RF signal data for the Activity Timeline component
- * Used by: Listening Post, TSCM
+ * Used by: Spectrum Waterfall, TSCM
- */
+ */
 const RFTimelineAdapter = (function() {
    'use strict';
@@ -157,16 +157,16 @@ const RFTimelineAdapter = (function() {
        return signals.map(normalizer);
    }
-    /**
+    /**
-     * Create timeline configuration for Listening Post mode
+     * Create timeline configuration for spectrum waterfall mode.
-     */
+     */
-    function getListeningPostConfig() {
+    function getWaterfallConfig() {
-        return {
+        return {
-            title: 'Signal Activity',
+            title: 'Spectrum Activity',
-            mode: 'listening-post',
+            mode: 'waterfall',
-            visualMode: 'enriched',
+            visualMode: 'enriched',
-            collapsed: false,
+            collapsed: false,
-            showAnnotations: true,
+            showAnnotations: true,
            showLegend: true,
            defaultWindow: '15m',
            availableWindows: ['5m', '15m', '30m', '1h'],
@@ -184,9 +184,14 @@ const RFTimelineAdapter = (function() {
                }
            ],
            maxItems: 50,
-            maxDisplayedLanes: 12
+            maxDisplayedLanes: 12
-        };
+        };
-    }
+    }
    // Backward compatibility alias for legacy callers.
    function getListeningPostConfig() {
        return getWaterfallConfig();
    }
    /**
     * Create timeline configuration for TSCM mode
@@ -224,8 +229,9 @@ const RFTimelineAdapter = (function() {
        categorizeFrequency: categorizeFrequency,
        // Configuration presets
-        getListeningPostConfig: getListeningPostConfig,
+        getWaterfallConfig: getWaterfallConfig,
-        getTscmConfig: getTscmConfig,
+        getListeningPostConfig: getListeningPostConfig,
        getTscmConfig: getTscmConfig,
        // Constants
        RSSI_THRESHOLDS: RSSI_THRESHOLDS,
@@ -423,7 +423,7 @@ async function syncAgentModeStates(agentId) {
                });
                // Also check modes that might need to be marked as stopped
-                const allModes = ['sensor', 'pager', 'adsb', 'wifi', 'bluetooth', 'ais', 'dsc', 'acars', 'aprs', 'rtlamr', 'tscm', 'satellite', 'listening_post'];
+                const allModes = ['sensor', 'pager', 'adsb', 'wifi', 'bluetooth', 'ais', 'dsc', 'acars', 'vdl2', 'aprs', 'rtlamr', 'tscm', 'satellite', 'listening_post'];
                allModes.forEach(mode => {
                    if (!agentRunningModes.includes(mode)) {
                        syncModeUI(mode, false, agentId);
@@ -485,7 +485,7 @@ async function syncLocalModeStates() {
 */
 function showAgentModeWarnings(runningModes, modesDetail = {}) {
    // SDR modes that can't run simultaneously on same device
-    const sdrModes = ['sensor', 'pager', 'adsb', 'ais', 'acars', 'aprs', 'rtlamr', 'listening_post', 'tscm', 'dsc'];
+    const sdrModes = ['sensor', 'pager', 'adsb', 'ais', 'acars', 'vdl2', 'aprs', 'rtlamr', 'listening_post', 'tscm', 'dsc'];
    const runningSdrModes = runningModes.filter(m => sdrModes.includes(m));
    let warning = document.getElementById('agentModeWarning');
@@ -621,7 +621,7 @@ function checkAgentModeConflict(modeToStart, deviceToUse = null) {
        return false;
    }
-    const sdrModes = ['sensor', 'pager', 'adsb', 'ais', 'acars', 'aprs', 'rtlamr', 'listening_post', 'tscm', 'dsc'];
+    const sdrModes = ['sensor', 'pager', 'adsb', 'ais', 'acars', 'vdl2', 'aprs', 'rtlamr', 'listening_post', 'tscm', 'dsc'];
    // If we're trying to start an SDR mode
    if (sdrModes.includes(modeToStart)) {
@@ -704,6 +704,7 @@ function syncModeUI(mode, isRunning, agentId = null) {
        'wifi': 'setWiFiRunning',
        'bluetooth': 'setBluetoothRunning',
        'acars': 'setAcarsRunning',
        'vdl2': 'setVdl2Running',
        'listening_post': 'setListeningPostRunning'
    };
@@ -865,12 +866,12 @@ function connectAgentStream(mode, onMessage) {
    }
    let streamUrl;
-    if (currentAgent === 'local') {
+    if (currentAgent === 'local') {
-        streamUrl = `/${mode}/stream`;
+        streamUrl = `/${mode}/stream`;
-    } else {
+    } else {
-        // For remote agents, proxy SSE through controller
+        // For remote agents, proxy SSE through controller
-        streamUrl = `/controller/agents/${currentAgent}/${mode}/stream`;
+        streamUrl = `/controller/agents/${currentAgent}/${mode}/stream`;
-    }
+    }
    agentEventSource = new EventSource(streamUrl);
@@ -878,7 +879,7 @@ function connectAgentStream(mode, onMessage) {
        try {
            const data = JSON.parse(event.data);
-            onMessage(data);
+            onMessage(data);
        } catch (e) {
            console.error('Error parsing SSE message:', e);
        }
@@ -1,11 +1,12 @@
 const AlertCenter = (function() {
    'use strict';
    const TRACKER_RULE_NAME = 'Tracker Detected';
    let alerts = [];
    let rules = [];
    let eventSource = null;
-
+    let reconnectTimer = null;
    const TRACKER_RULE_NAME = 'Tracker Detected';
    function init() {
        loadRules();
@@ -17,6 +18,7 @@ const AlertCenter = (function() {
        if (eventSource) {
            eventSource.close();
        }
        eventSource = new EventSource('/alerts/stream');
        eventSource.onmessage = function(e) {
            try {
@@ -27,21 +29,26 @@ const AlertCenter = (function() {
                console.error('[Alerts] SSE parse error', err);
            }
        };
        eventSource.onerror = function() {
            console.warn('[Alerts] SSE connection error');
            if (reconnectTimer) clearTimeout(reconnectTimer);
            reconnectTimer = setTimeout(connect, 2500);
        };
    }
    function handleAlert(alert) {
        alerts.unshift(alert);
-        alerts = alerts.slice(0, 50);
+        alerts = alerts.slice(0, 60);
        updateFeedUI();
-        if (typeof showNotification === 'function') {
+        const severity = String(alert.severity || '').toLowerCase();
-            const severity = (alert.severity || '').toLowerCase();
+        if (typeof showNotification === 'function' && ['high', 'critical'].includes(severity)) {
-            if (['high', 'critical'].includes(severity)) {
+            showNotification(alert.title || 'Alert', alert.message || 'Alert triggered');
-                showNotification(alert.title || 'Alert', alert.message || 'Alert triggered');
+        }
-            }
+
        if (typeof showAppToast === 'function' && ['high', 'critical'].includes(severity)) {
            showAppToast(alert.title || 'Alert', alert.message || 'Alert triggered', 'warning');
        }
    }
@@ -56,7 +63,7 @@ const AlertCenter = (function() {
            return;
        }
-        list.innerHTML = alerts.map(alert => {
+        list.innerHTML = alerts.map((alert) => {
            const title = escapeHtml(alert.title || 'Alert');
            const message = escapeHtml(alert.message || '');
            const severity = escapeHtml(alert.severity || 'medium');
@@ -74,27 +81,218 @@ const AlertCenter = (function() {
        }).join('');
    }
    function renderRulesUI() {
        const list = document.getElementById('alertsRulesList');
        if (!list) return;
        if (!rules.length) {
            list.innerHTML = '<div class="settings-feed-empty">No rules yet</div>';
            return;
        }
        list.innerHTML = rules.map((rule) => {
            const enabled = Boolean(rule.enabled);
            const mode = rule.mode || 'all';
            const eventType = rule.event_type || 'any';
            const severity = (rule.severity || 'medium').toUpperCase();
            const match = formatMatch(rule.match);
            const statusText = enabled ? 'ENABLED' : 'DISABLED';
            return `
                <div class="settings-feed-item" style="border-left: 2px solid ${enabled ? 'var(--accent-green)' : 'var(--text-dim)'};">
                    <div class="settings-feed-title" style="display:flex; gap:8px; align-items:center; justify-content:space-between;">
                        <span>${escapeHtml(rule.name || 'Rule')}</span>
                        <span style="color: var(--text-dim); font-size: 10px;">${statusText}</span>
                    </div>
                    <div class="settings-feed-meta">Mode: ${escapeHtml(mode)} | Event: ${escapeHtml(eventType)} | Severity: ${escapeHtml(severity)}</div>
                    <div class="settings-feed-meta">Match: ${escapeHtml(match)}</div>
                    <div style="display:flex; gap:8px; margin-top: 8px;">
                        <button class="preset-btn" style="font-size: 10px; padding: 3px 8px;" onclick="AlertCenter.editRule(${Number(rule.id)})">Edit</button>
                        <button class="preset-btn" style="font-size: 10px; padding: 3px 8px;" onclick="AlertCenter.toggleRule(${Number(rule.id)}, ${enabled ? 'false' : 'true'})">${enabled ? 'Disable' : 'Enable'}</button>
                        <button class="preset-btn" style="font-size: 10px; padding: 3px 8px; border-color: var(--accent-red); color: var(--accent-red);" onclick="AlertCenter.deleteRule(${Number(rule.id)})">Delete</button>
                    </div>
                </div>
            `;
        }).join('');
    }
    function formatMatch(match) {
        if (!match || typeof match !== 'object' || !Object.keys(match).length) {
            return 'none';
        }
        const [k, v] = Object.entries(match)[0];
        return `${k}=${v}`;
    }
    function loadFeed() {
-        fetch('/alerts/events?limit=20')
+        fetch('/alerts/events?limit=30')
-            .then(r => r.json())
+            .then((r) => r.json())
-            .then(data => {
+            .then((data) => {
                if (data.status === 'success') {
                    alerts = data.events || [];
                    updateFeedUI();
                }
            })
-            .catch(err => console.error('[Alerts] Load feed failed', err));
+            .catch((err) => console.error('[Alerts] Load feed failed', err));
    }
    function loadRules() {
-        fetch('/alerts/rules?all=1')
+        return fetch('/alerts/rules?all=1')
-            .then(r => r.json())
+            .then((r) => r.json())
-            .then(data => {
+            .then((data) => {
                if (data.status === 'success') {
                    rules = data.rules || [];
                    renderRulesUI();
                }
            })
-            .catch(err => console.error('[Alerts] Load rules failed', err));
+            .catch((err) => {
                console.error('[Alerts] Load rules failed', err);
                if (typeof reportActionableError === 'function') {
                    reportActionableError('Alert Rules', err, { onRetry: loadRules });
                }
            });
    }
    function saveRule() {
        const editingId = getEditingRuleId();
        const payload = buildRulePayload();
        if (!payload.name) {
            payload.name = payload.mode ? `${payload.mode} alert` : 'Alert Rule';
        }
        const url = editingId ? `/alerts/rules/${editingId}` : '/alerts/rules';
        const method = editingId ? 'PATCH' : 'POST';
        fetch(url, {
            method,
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify(payload),
        })
            .then((r) => r.json())
            .then((data) => {
                if (data.status !== 'success') {
                    throw new Error(data.message || 'Failed to save rule');
                }
                clearRuleForm();
                return loadRules();
            })
            .then(() => {
                if (typeof showAppToast === 'function') {
                    showAppToast('Alerts', editingId ? 'Rule updated' : 'Rule created', 'info');
                }
            })
            .catch((err) => {
                if (typeof reportActionableError === 'function') {
                    reportActionableError('Save Alert Rule', err);
                }
            });
    }
    function buildRulePayload() {
        const nameEl = document.getElementById('alertsRuleName');
        const modeEl = document.getElementById('alertsRuleMode');
        const eventTypeEl = document.getElementById('alertsRuleEventType');
        const keyEl = document.getElementById('alertsRuleMatchKey');
        const valueEl = document.getElementById('alertsRuleMatchValue');
        const severityEl = document.getElementById('alertsRuleSeverity');
        const match = {};
        const key = keyEl ? String(keyEl.value || '').trim() : '';
        const value = valueEl ? String(valueEl.value || '').trim() : '';
        if (key && value) {
            match[key] = value;
        }
        return {
            name: nameEl ? String(nameEl.value || '').trim() : 'Alert Rule',
            mode: modeEl ? String(modeEl.value || '').trim() || null : null,
            event_type: eventTypeEl ? String(eventTypeEl.value || '').trim() || null : null,
            match,
            severity: severityEl ? String(severityEl.value || 'medium') : 'medium',
            enabled: true,
            notify: { webhook: true },
        };
    }
    function clearRuleForm() {
        setField('alertsRuleName', '');
        setField('alertsRuleMode', '');
        setField('alertsRuleEventType', '');
        setField('alertsRuleMatchKey', '');
        setField('alertsRuleMatchValue', '');
        setField('alertsRuleSeverity', 'medium');
        setField('alertsRuleEditingId', '');
    }
    function editRule(ruleId) {
        const rule = rules.find((r) => Number(r.id) === Number(ruleId));
        if (!rule) return;
        const matchEntries = Object.entries(rule.match || {});
        const firstMatch = matchEntries.length ? matchEntries[0] : ['', ''];
        setField('alertsRuleName', rule.name || '');
        setField('alertsRuleMode', rule.mode || '');
        setField('alertsRuleEventType', rule.event_type || '');
        setField('alertsRuleMatchKey', firstMatch[0] || '');
        setField('alertsRuleMatchValue', firstMatch[1] == null ? '' : String(firstMatch[1]));
        setField('alertsRuleSeverity', rule.severity || 'medium');
        setField('alertsRuleEditingId', String(rule.id));
    }
    function toggleRule(ruleId, enabled) {
        fetch(`/alerts/rules/${ruleId}`, {
            method: 'PATCH',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ enabled: Boolean(enabled) }),
        })
            .then((r) => r.json())
            .then((data) => {
                if (data.status !== 'success') {
                    throw new Error(data.message || 'Failed to update rule');
                }
                return loadRules();
            })
            .catch((err) => {
                if (typeof reportActionableError === 'function') {
                    reportActionableError('Toggle Alert Rule', err);
                }
            });
    }
    function deleteRule(ruleId) {
        if (!confirm('Delete this alert rule?')) return;
        fetch(`/alerts/rules/${ruleId}`, { method: 'DELETE' })
            .then((r) => r.json())
            .then((data) => {
                if (data.status !== 'success') {
                    throw new Error(data.message || 'Failed to delete rule');
                }
                if (Number(getEditingRuleId()) === Number(ruleId)) {
                    clearRuleForm();
                }
                return loadRules();
            })
            .catch((err) => {
                if (typeof reportActionableError === 'function') {
                    reportActionableError('Delete Alert Rule', err);
                }
            });
    }
    function getEditingRuleId() {
        const el = document.getElementById('alertsRuleEditingId');
        if (!el || !el.value) return null;
        const parsed = Number(el.value);
        return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
    }
    function setField(id, value) {
        const el = document.getElementById(id);
        if (!el) return;
        el.value = value;
    }
    function enableTrackerAlerts() {
@@ -106,17 +304,18 @@ const AlertCenter = (function() {
    }
    function ensureTrackerRule(enabled) {
-        loadRules();
+        loadRules().then(() => {
-        setTimeout(() => {
+            const existing = rules.find((r) => r.name === TRACKER_RULE_NAME);
            const existing = rules.find(r => r.name === TRACKER_RULE_NAME);
            if (existing) {
-                fetch(`/alerts/rules/${existing.id}`, {
+                return fetch(`/alerts/rules/${existing.id}`, {
                    method: 'PATCH',
                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ enabled })
+                    body: JSON.stringify({ enabled }),
                }).then(() => loadRules());
-            } else if (enabled) {
+            }
-                fetch('/alerts/rules', {
+
            if (enabled) {
                return fetch('/alerts/rules', {
                    method: 'POST',
                    headers: { 'Content-Type': 'application/json' },
                    body: JSON.stringify({
@@ -126,44 +325,49 @@ const AlertCenter = (function() {
                        match: { is_tracker: true },
                        severity: 'high',
                        enabled: true,
-                        notify: { webhook: true }
+                        notify: { webhook: true },
-                    })
+                    }),
                }).then(() => loadRules());
            }
-        }, 150);
+            return null;
        });
    }
    function addBluetoothWatchlist(address, name) {
        if (!address) return;
-        const existing = rules.find(r => r.mode === 'bluetooth' && r.match && r.match.address === address);
+        const upper = String(address).toUpperCase();
-        if (existing) {
+        const existing = rules.find((r) => r.mode === 'bluetooth' && r.match && String(r.match.address || '').toUpperCase() === upper);
-            return;
+        if (existing) return;
-        }
+
        fetch('/alerts/rules', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
-                name: name ? `Watchlist ${name}` : `Watchlist ${address}`,
+                name: name ? `Watchlist ${name}` : `Watchlist ${upper}`,
                mode: 'bluetooth',
                event_type: 'device_update',
-                match: { address: address },
+                match: { address: upper },
                severity: 'medium',
                enabled: true,
-                notify: { webhook: true }
+                notify: { webhook: true },
-            })
+            }),
        }).then(() => loadRules());
    }
    function removeBluetoothWatchlist(address) {
        if (!address) return;
-        const existing = rules.find(r => r.mode === 'bluetooth' && r.match && r.match.address === address);
+        const upper = String(address).toUpperCase();
        const existing = rules.find((r) => r.mode === 'bluetooth' && r.match && String(r.match.address || '').toUpperCase() === upper);
        if (!existing) return;
        fetch(`/alerts/rules/${existing.id}`, { method: 'DELETE' })
            .then(() => loadRules());
    }
    function isWatchlisted(address) {
-        return rules.some(r => r.mode === 'bluetooth' && r.match && r.match.address === address && r.enabled);
+        if (!address) return false;
        const upper = String(address).toUpperCase();
        return rules.some((r) => r.mode === 'bluetooth' && r.match && String(r.match.address || '').toUpperCase() === upper && r.enabled);
    }
    function escapeHtml(str) {
@@ -179,6 +383,12 @@ const AlertCenter = (function() {
    return {
        init,
        loadFeed,
        loadRules,
        saveRule,
        clearRuleForm,
        editRule,
        toggleRule,
        deleteRule,
        enableTrackerAlerts,
        disableTrackerAlerts,
        addBluetoothWatchlist,
@@ -36,12 +36,12 @@ let observerLocation = (function() {
        return ObserverLocation.getForModule('observerLocation');
    }
    const saved = localStorage.getItem('observerLocation');
-    if (saved) {
+            if (saved) {
-        try {
+                try {
-            const parsed = JSON.parse(saved);
+                    const parsed = JSON.parse(saved);
-            if (parsed.lat && parsed.lon) return parsed;
+                    if (parsed.lat !== undefined && parsed.lat !== null && parsed.lon !== undefined && parsed.lon !== null) return parsed;
-        } catch (e) {}
+                } catch (e) {}
-    }
+            }
    return { lat: 51.5074, lon: -0.1278 };
 })();
@@ -98,7 +98,7 @@ function switchMode(mode) {
    const modeMap = {
        'pager': 'pager', 'sensor': '433', 'aircraft': 'aircraft',
        'satellite': 'satellite', 'wifi': 'wifi', 'bluetooth': 'bluetooth',
-        'listening': 'listening', 'meshtastic': 'meshtastic'
+        'meshtastic': 'meshtastic'
    };
    document.querySelectorAll('.mode-nav-btn').forEach(btn => {
        const label = btn.querySelector('.nav-label');
@@ -114,7 +114,6 @@ function switchMode(mode) {
    document.getElementById('satelliteMode').classList.toggle('active', mode === 'satellite');
    document.getElementById('wifiMode').classList.toggle('active', mode === 'wifi');
    document.getElementById('bluetoothMode').classList.toggle('active', mode === 'bluetooth');
    document.getElementById('listeningPostMode').classList.toggle('active', mode === 'listening');
    document.getElementById('aprsMode')?.classList.toggle('active', mode === 'aprs');
    document.getElementById('tscmMode')?.classList.toggle('active', mode === 'tscm');
    document.getElementById('rtlamrMode')?.classList.toggle('active', mode === 'rtlamr');
@@ -143,7 +142,6 @@ function switchMode(mode) {
        'satellite': 'SATELLITE',
        'wifi': 'WIFI',
        'bluetooth': 'BLUETOOTH',
        'listening': 'LISTENING POST',
        'tscm': 'TSCM',
        'aprs': 'APRS',
        'meshtastic': 'MESHTASTIC'
@@ -166,7 +164,6 @@ function switchMode(mode) {
    const showRadar = document.getElementById('adsbEnableMap')?.checked;
    document.getElementById('aircraftVisuals').style.display = (mode === 'aircraft' && showRadar) ? 'grid' : 'none';
    document.getElementById('satelliteVisuals').style.display = mode === 'satellite' ? 'block' : 'none';
    document.getElementById('listeningPostVisuals').style.display = mode === 'listening' ? 'grid' : 'none';
    // Update output panel title based on mode
    const titles = {
@@ -176,7 +173,6 @@ function switchMode(mode) {
        'satellite': 'Satellite Monitor',
        'wifi': 'WiFi Scanner',
        'bluetooth': 'Bluetooth Scanner',
        'listening': 'Listening Post',
        'meshtastic': 'Meshtastic Mesh Monitor'
    };
    document.getElementById('outputTitle').textContent = titles[mode] || 'Signal Monitor';
@@ -184,7 +180,7 @@ function switchMode(mode) {
    // Show/hide Device Intelligence for modes that use it
    const reconBtn = document.getElementById('reconBtn');
    const intelBtn = document.querySelector('[onclick="exportDeviceDB()"]');
-    if (mode === 'satellite' || mode === 'aircraft' || mode === 'listening') {
+    if (mode === 'satellite' || mode === 'aircraft') {
        document.getElementById('reconPanel').style.display = 'none';
        if (reconBtn) reconBtn.style.display = 'none';
        if (intelBtn) intelBtn.style.display = 'none';
@@ -198,7 +194,7 @@ function switchMode(mode) {
    // Show RTL-SDR device section for modes that use it
    document.getElementById('rtlDeviceSection').style.display =
-        (mode === 'pager' || mode === 'sensor' || mode === 'aircraft' || mode === 'listening') ? 'block' : 'none';
+        (mode === 'pager' || mode === 'sensor' || mode === 'aircraft') ? 'block' : 'none';
    // Toggle mode-specific tool status displays
    document.getElementById('toolStatusPager').style.display = (mode === 'pager') ? 'grid' : 'none';
@@ -207,7 +203,7 @@ function switchMode(mode) {
    // Hide waterfall and output console for modes with their own visualizations
    document.querySelector('.waterfall-container').style.display =
-        (mode === 'satellite' || mode === 'listening' || mode === 'aircraft' || mode === 'wifi' || mode === 'bluetooth' || mode === 'meshtastic' || mode === 'aprs' || mode === 'tscm' || mode === 'spystations') ? 'none' : 'block';
+        (mode === 'satellite' || mode === 'aircraft' || mode === 'wifi' || mode === 'bluetooth' || mode === 'meshtastic' || mode === 'aprs' || mode === 'tscm' || mode === 'spystations') ? 'none' : 'block';
    document.getElementById('output').style.display =
        (mode === 'satellite' || mode === 'aircraft' || mode === 'wifi' || mode === 'bluetooth' || mode === 'meshtastic' || mode === 'aprs' || mode === 'tscm' || mode === 'spystations') ? 'none' : 'block';
    document.querySelector('.status-bar').style.display = (mode === 'satellite' || mode === 'tscm' || mode === 'meshtastic' || mode === 'aprs' || mode === 'spystations') ? 'none' : 'flex';
@@ -226,11 +222,6 @@ function switchMode(mode) {
    } else if (mode === 'satellite') {
        if (typeof initPolarPlot === 'function') initPolarPlot();
        if (typeof initSatelliteList === 'function') initSatelliteList();
    } else if (mode === 'listening') {
        if (typeof checkScannerTools === 'function') checkScannerTools();
        if (typeof checkAudioTools === 'function') checkAudioTools();
        if (typeof populateScannerDeviceSelect === 'function') populateScannerDeviceSelect();
        if (typeof populateAudioDeviceSelect === 'function') populateAudioDeviceSelect();
    } else if (mode === 'meshtastic') {
        if (typeof Meshtastic !== 'undefined' && Meshtastic.init) Meshtastic.init();
    }
@@ -373,7 +364,7 @@ function showInfo(text) {
    const infoEl = document.createElement('div');
    infoEl.className = 'info-msg';
-    infoEl.style.cssText = 'padding: 12px 15px; margin-bottom: 8px; background: #0a0a0a; border: 1px solid #1a1a1a; border-left: 2px solid #00d4ff; font-family: "Space Mono", monospace; font-size: 11px; color: #888; word-break: break-all;';
+    infoEl.style.cssText = 'padding: 12px 15px; margin-bottom: 8px; background: #0a0a0a; border: 1px solid #1a1a1a; border-left: 2px solid #00d4ff; font-family: "Roboto Condensed", "Arial Narrow", sans-serif; font-size: 11px; color: #888; word-break: break-all;';
    infoEl.textContent = text;
    output.insertBefore(infoEl, output.firstChild);
 }
@@ -387,7 +378,7 @@ function showError(text) {
    const errorEl = document.createElement('div');
    errorEl.className = 'error-msg';
-    errorEl.style.cssText = 'padding: 12px 15px; margin-bottom: 8px; background: #1a0a0a; border: 1px solid #2a1a1a; border-left: 2px solid #ff3366; font-family: "Space Mono", monospace; font-size: 11px; color: #ff6688; word-break: break-all;';
+    errorEl.style.cssText = 'padding: 12px 15px; margin-bottom: 8px; background: #1a0a0a; border: 1px solid #2a1a1a; border-left: 2px solid #ff3366; font-family: "Roboto Condensed", "Arial Narrow", sans-serif; font-size: 11px; color: #ff6688; word-break: break-all;';
    errorEl.textContent = '⚠ ' + text;
    output.insertBefore(errorEl, output.firstChild);
 }
@@ -0,0 +1,74 @@
 /* INTERCEPT Per-Mode Cheat Sheets */
 const CheatSheets = (function () {
    'use strict';
    const CONTENT = {
        pager:       { title: 'Pager Decoder',           icon: '📟', hardware: 'RTL-SDR dongle',                          description: 'Decodes POCSAG and FLEX pager protocols via rtl_fm + multimon-ng.',          whatToExpect: 'Numeric and alphanumeric pager messages with address codes.',   tips: ['Try frequencies 152.240, 157.450, 462.9625 MHz', 'Gain 38–45 dB works well for most dongles', 'POCSAG 512/1200/2400 baud are common'] },
        sensor:      { title: '433MHz Sensors',          icon: '🌡️', hardware: 'RTL-SDR dongle',                          description: 'Decodes 433MHz IoT sensors via rtl_433.',                                   whatToExpect: 'JSON events from weather stations, door sensors, car key fobs.', tips: ['Leave gain on AUTO', 'Walk around to discover hidden sensors', 'Protocol filter narrows false positives'] },
        wifi:        { title: 'WiFi Scanner',            icon: '📡', hardware: 'WiFi adapter (monitor mode)',              description: 'Scans WiFi networks and clients via airodump-ng or nmcli.',                 whatToExpect: 'SSIDs, BSSIDs, channel, signal strength, encryption type.',    tips: ['Run airmon-ng check kill before monitoring', 'Proximity radar shows signal strength', 'TSCM baseline detects rogue APs'] },
        bluetooth:   { title: 'Bluetooth Scanner',       icon: '🔵', hardware: 'Built-in or USB Bluetooth adapter',        description: 'Scans BLE and classic Bluetooth devices. Identifies trackers.',              whatToExpect: 'Device names, MACs, RSSI, manufacturer, tracker type.',        tips: ['Proximity radar shows device distance', 'Known tracker DB has 47K+ fingerprints', 'Use BT Locate to physically find a tracker'] },
        bt_locate:   { title: 'BT Locate (SAR)',         icon: '🎯', hardware: 'Bluetooth adapter + optional GPS',         description: 'SAR Bluetooth locator. Tracks RSSI over time to triangulate position.', whatToExpect: 'RSSI chart, proximity band (IMMEDIATE/NEAR/FAR), GPS trail.',   tips: ['Handoff from Bluetooth mode to lock onto a device', 'Indoor n=3.0 gives better distance estimates', 'Follow the heat trail toward stronger signal'] },
        meshtastic:  { title: 'Meshtastic',              icon: '🕸️', hardware: 'Meshtastic LoRa node (USB)',               description: 'Monitors Meshtastic LoRa mesh network messages and positions.',             whatToExpect: 'Text messages, node map, telemetry.',                          tips: ['Default channel must match your mesh', 'Long-Fast has best range', 'GPS nodes appear on map automatically'] },
        adsb:        { title: 'ADS-B Aircraft',          icon: '✈️', hardware: 'RTL-SDR + 1090MHz antenna',               description: 'Tracks aircraft via ADS-B Mode S transponders using dump1090.',             whatToExpect: 'Flight numbers, positions, altitude, speed, squawk codes.',     tips: ['1090MHz — use a dedicated antenna', 'Emergency squawks: 7500 hijack, 7600 radio fail, 7700 emergency', 'Full Dashboard shows map view'] },
        ais:         { title: 'AIS Vessels',             icon: '🚢', hardware: 'RTL-SDR + VHF antenna (162 MHz)',          description: 'Tracks marine vessels via AIS using AIS-catcher.',                         whatToExpect: 'MMSI, vessel names, positions, speed, heading, cargo type.',    tips: ['VHF antenna centered at 162MHz works best', 'DSC distress alerts appear in red', 'Coastline range ~40 nautical miles'] },
        aprs:        { title: 'APRS',                    icon: '📻', hardware: 'RTL-SDR + VHF + direwolf',                description: 'Decodes APRS amateur packet radio via direwolf TNC modem.',                whatToExpect: 'Station positions, weather reports, messages, telemetry.',      tips: ['Primary APRS frequency: 144.390 MHz (North America)', 'direwolf must be running', 'Positions appear on the map'] },
        satellite:   { title: 'Satellite Tracker',       icon: '🛰️', hardware: 'None (pass prediction only)',              description: 'Predicts satellite pass times using TLE data from CelesTrak.',              whatToExpect: 'Pass windows with AOS/LOS times, max elevation, bearing.',      tips: ['Set observer location in Settings', 'Plan ISS SSTV using pass times', 'TLEs auto-update every 24 hours'] },
        sstv:        { title: 'ISS SSTV',                icon: '🖼️', hardware: 'RTL-SDR + 145MHz antenna',               description: 'Receives ISS SSTV images via slowrx.',                                    whatToExpect: 'Color images during ISS SSTV events (PD180 mode).',             tips: ['ISS SSTV: 145.800 MHz', 'Check ARISS for active event dates', 'ISS must be overhead — check pass times'] },
        weathersat:  { title: 'Weather Satellites',      icon: '🌤️', hardware: 'RTL-SDR + 137MHz turnstile/QFH antenna',  description: 'Decodes NOAA APT and Meteor LRPT weather imagery via SatDump.',          whatToExpect: 'Infrared/visible cloud imagery.',                              tips: ['NOAA 15/18/19: 137.1–137.9 MHz APT', 'Meteor M2-3: 137.9 MHz LRPT', 'Use circular polarized antenna (QFH or turnstile)'] },
        sstv_general:{ title: 'HF SSTV',                 icon: '📷', hardware: 'RTL-SDR + HF upconverter',                description: 'Receives HF SSTV transmissions.',                                          whatToExpect: 'Amateur radio images on 14.230 MHz (USB mode).',                tips: ['14.230 MHz USB is primary HF SSTV frequency', 'Scottie 1 and Martin 1 most common', 'Best during daylight hours'] },
        gps:         { title: 'GPS Receiver',            icon: '🗺️', hardware: 'USB GPS receiver (NMEA)',                 description: 'Streams GPS position and feeds location to other modes.',                  whatToExpect: 'Lat/lon, altitude, speed, heading, satellite count.',          tips: ['BT Locate uses GPS for trail logging', 'Set observer location for satellite prediction', 'Verify a 3D fix before relying on altitude'] },
        spaceweather:{ title: 'Space Weather',           icon: '☀️', hardware: 'None (NOAA/SpaceWeatherLive data)',        description: 'Monitors solar activity and geomagnetic storm indices.',                   whatToExpect: 'Kp index, solar flux, X-ray flare alerts, CME tracking.',      tips: ['High Kp (≥5) = geomagnetic storm', 'X-class flares cause HF radio blackouts', 'Check before HF or satellite operations'] },
        tscm:        { title: 'TSCM Counter-Surveillance', icon: '🔍', hardware: 'WiFi + Bluetooth adapters',             description: 'Technical Surveillance Countermeasures — detects hidden devices.',        whatToExpect: 'RF baseline comparison, rogue device alerts, tracker detection.', tips: ['Take baseline in a known-clean environment', 'New strong signals = potential bug', 'Correlate WiFi + Bluetooth observations'] },
        spystations: { title: 'Spy Stations',            icon: '🕵️', hardware: 'RTL-SDR + HF antenna',                   description: 'Database of known number stations, military, and diplomatic HF signals.', whatToExpect: 'Scheduled broadcasts, frequency database, tune-to links.',    tips: ['Numbers stations often broadcast on the hour', 'Use Spectrum Waterfall to tune directly', 'STANAG and HF mil signals are common'] },
        websdr:      { title: 'WebSDR',                  icon: '🌐', hardware: 'None (uses remote SDR servers)',           description: 'Access remote WebSDR receivers worldwide for HF shortwave listening.', whatToExpect: 'Live audio from global HF receivers, waterfall display.',      tips: ['websdr.org lists available servers', 'Good for HF when local antenna is lacking', 'Use in-app player for seamless experience'] },
        subghz:      { title: 'SubGHz Transceiver',      icon: '📡', hardware: 'HackRF One',                             description: 'Transmit and receive sub-GHz RF signals for IoT and industrial protocols.', whatToExpect: 'Raw signal capture, replay, and protocol analysis.',        tips: ['Only use on licensed frequencies', 'Capture mode records raw IQ for replay', 'Common: garage doors, keyfobs, 315/433/868/915 MHz'] },
        rtlamr:      { title: 'Utility Meter Reader',    icon: '⚡', hardware: 'RTL-SDR dongle',                          description: 'Reads AMI/AMR smart utility meter broadcasts via rtlamr.',                whatToExpect: 'Meter IDs, consumption readings, interval data.',               tips: ['Most meters broadcast on 915 MHz', 'MSG types 5, 7, 13, 21 most common', 'Consumption data is read-only public broadcast'] },
        waterfall:   { title: 'Spectrum Waterfall',      icon: '🌊', hardware: 'RTL-SDR or HackRF (WebSocket)',           description: 'Full-screen real-time FFT spectrum waterfall display.',                  whatToExpect: 'Color-coded signal intensity scrolling over time.',             tips: ['Turbo palette has best contrast for weak signals', 'Peak hold shows max power in red', 'Hover over waterfall to see frequency'] },
    };
    function show(mode) {
        const data    = CONTENT[mode];
        const modal   = document.getElementById('cheatSheetModal');
        const content = document.getElementById('cheatSheetContent');
        if (!modal || !content) return;
        if (!data) {
            content.innerHTML = `<p style="color:var(--text-dim); font-family:var(--font-mono);">No cheat sheet for: ${mode}</p>`;
        } else {
            content.innerHTML = `
 <div style="font-family:var(--font-mono, monospace);">
  <div style="font-size:24px; margin-bottom:4px;">${data.icon}</div>
  <h2 style="margin:0 0 8px; font-size:16px; color:var(--accent-cyan, #4aa3ff);">${data.title}</h2>
  <div style="font-size:11px; color:var(--text-dim); margin-bottom:12px; border-bottom:1px solid rgba(255,255,255,0.08); padding-bottom:8px;">
    Hardware: <span style="color:var(--text-secondary);">${data.hardware}</span>
  </div>
  <p style="font-size:12px; color:var(--text-secondary); margin:0 0 12px;">${data.description}</p>
  <div style="margin-bottom:12px;">
    <div style="font-size:10px; font-weight:700; text-transform:uppercase; letter-spacing:0.08em; color:var(--text-dim); margin-bottom:4px;">What to expect</div>
    <p style="font-size:12px; color:var(--text-secondary); margin:0;">${data.whatToExpect}</p>
  </div>
  <div>
    <div style="font-size:10px; font-weight:700; text-transform:uppercase; letter-spacing:0.08em; color:var(--text-dim); margin-bottom:6px;">Tips</div>
    <ul style="margin:0; padding-left:16px; display:flex; flex-direction:column; gap:4px;">
      ${data.tips.map(t => `<li style="font-size:11px; color:var(--text-secondary);">${t}</li>`).join('')}
    </ul>
  </div>
 </div>`;
        }
        modal.style.display = 'flex';
    }
    function hide() {
        const modal = document.getElementById('cheatSheetModal');
        if (modal) modal.style.display = 'none';
    }
    function showForCurrentMode() {
        const mode = document.body.getAttribute('data-mode');
        if (mode) show(mode);
    }
    return { show, hide, showForCurrentMode };
 })();
 window.CheatSheets = CheatSheets;
@@ -0,0 +1,378 @@
 const CommandPalette = (function() {
    'use strict';
    let overlayEl = null;
    let inputEl = null;
    let listEl = null;
    let isOpen = false;
    let activeIndex = 0;
    let filteredItems = [];
    const fallbackModeCommands = [
        { mode: 'pager', label: 'Pager' },
        { mode: 'sensor', label: '433MHz Sensors' },
        { mode: 'rtlamr', label: 'Meters' },
        { mode: 'subghz', label: 'SubGHz' },
        { mode: 'waterfall', label: 'Spectrum Waterfall' },
        { mode: 'aprs', label: 'APRS' },
        { mode: 'wifi', label: 'WiFi Scanner' },
        { mode: 'bluetooth', label: 'Bluetooth Scanner' },
        { mode: 'bt_locate', label: 'BT Locate' },
        { mode: 'satellite', label: 'Satellite' },
        { mode: 'sstv', label: 'ISS SSTV' },
        { mode: 'weathersat', label: 'Weather Sat' },
        { mode: 'sstv_general', label: 'HF SSTV' },
        { mode: 'gps', label: 'GPS' },
        { mode: 'meshtastic', label: 'Meshtastic' },
        { mode: 'websdr', label: 'WebSDR' },
        { mode: 'spaceweather', label: 'Space Weather' },
    ];
    function getModeCommands() {
        const commands = [];
        const seenModes = new Set();
        const catalog = window.interceptModeCatalog;
        if (catalog && typeof catalog === 'object') {
            for (const [mode, meta] of Object.entries(catalog)) {
                if (!mode || seenModes.has(mode)) continue;
                const label = String((meta && meta.label) || mode).trim();
                commands.push({ mode, label });
                seenModes.add(mode);
            }
            if (commands.length > 0) return commands;
        }
        const navNodes = document.querySelectorAll('.mode-nav-btn[data-mode], .mobile-nav-btn[data-mode]');
        navNodes.forEach((node) => {
            if (node.tagName === 'A') {
                const href = String(node.getAttribute('href') || '');
                if (href.includes('/dashboard')) return;
            }
            const mode = String(node.dataset.mode || '').trim();
            if (!mode || seenModes.has(mode)) return;
            const label = String(node.dataset.modeLabel || node.textContent || mode).trim();
            commands.push({ mode, label });
            seenModes.add(mode);
        });
        if (commands.length > 0) return commands;
        return fallbackModeCommands.slice();
    }
    function init() {
        buildDOM();
        registerHotkeys();
        renderItems('');
    }
    function buildDOM() {
        overlayEl = document.createElement('div');
        overlayEl.className = 'command-palette-overlay';
        overlayEl.id = 'commandPaletteOverlay';
        overlayEl.addEventListener('click', (event) => {
            if (event.target === overlayEl) close();
        });
        const palette = document.createElement('div');
        palette.className = 'command-palette';
        const header = document.createElement('div');
        header.className = 'command-palette-header';
        inputEl = document.createElement('input');
        inputEl.className = 'command-palette-input';
        inputEl.type = 'text';
        inputEl.autocomplete = 'off';
        inputEl.placeholder = 'Search commands and modes...';
        inputEl.setAttribute('aria-label', 'Command Palette Search');
        inputEl.addEventListener('input', () => {
            renderItems(inputEl.value || '');
        });
        inputEl.addEventListener('keydown', onInputKeyDown);
        const hint = document.createElement('span');
        hint.className = 'command-palette-hint';
        hint.textContent = 'Esc close';
        header.appendChild(inputEl);
        header.appendChild(hint);
        listEl = document.createElement('div');
        listEl.className = 'command-palette-list';
        listEl.id = 'commandPaletteList';
        palette.appendChild(header);
        palette.appendChild(listEl);
        overlayEl.appendChild(palette);
        document.body.appendChild(overlayEl);
    }
    function registerHotkeys() {
        document.addEventListener('keydown', (event) => {
            const cmdK = (event.key.toLowerCase() === 'k') && (event.ctrlKey || event.metaKey);
            if (cmdK) {
                event.preventDefault();
                if (isOpen) {
                    close();
                } else {
                    open();
                }
                return;
            }
            if (!isOpen) return;
            if (event.key === 'Escape') {
                event.preventDefault();
                close();
            }
        });
    }
    function onInputKeyDown(event) {
        if (event.key === 'ArrowDown') {
            event.preventDefault();
            activeIndex = Math.min(activeIndex + 1, Math.max(filteredItems.length - 1, 0));
            renderSelection();
            return;
        }
        if (event.key === 'ArrowUp') {
            event.preventDefault();
            activeIndex = Math.max(activeIndex - 1, 0);
            renderSelection();
            return;
        }
        if (event.key === 'Enter') {
            event.preventDefault();
            const item = filteredItems[activeIndex];
            if (item && typeof item.run === 'function') {
                item.run();
            }
            close();
        }
    }
    function getCommands() {
        const commands = [
            {
                title: 'Open Settings',
                description: 'Open global settings panel',
                keyword: 'settings configure tools',
                shortcut: 'S',
                run: () => {
                    if (typeof showSettings === 'function') showSettings();
                }
            },
            {
                title: 'Settings: Alerts',
                description: 'Open alert rules and feed',
                keyword: 'settings alerts rule',
                run: () => openSettingsTab('alerts')
            },
            {
                title: 'Settings: Recording',
                description: 'Open recording manager',
                keyword: 'settings recording replay',
                run: () => openSettingsTab('recording')
            },
            {
                title: 'Settings: Location',
                description: 'Configure observer location',
                keyword: 'settings location gps lat lon',
                run: () => openSettingsTab('location')
            },
            {
                title: 'View Aircraft Dashboard',
                description: 'Open dedicated ADS-B dashboard page',
                keyword: 'aircraft adsb dashboard',
                run: () => {
                    if (window.InterceptNavPerf && typeof window.InterceptNavPerf.markStart === 'function') {
                        window.InterceptNavPerf.markStart({
                            targetPath: '/adsb/dashboard',
                            trigger: 'command-palette',
                            sourceMode: (typeof currentMode === 'string' && currentMode) ? currentMode : null,
                            activeScans: (typeof getActiveScanSummary === 'function') ? getActiveScanSummary() : null,
                        });
                    }
                    if (typeof stopActiveLocalScansForNavigation === 'function') {
                        stopActiveLocalScansForNavigation();
                    }
                    window.location.href = '/adsb/dashboard';
                }
            },
            {
                title: 'View Vessel Dashboard',
                description: 'Open dedicated AIS dashboard page',
                keyword: 'vessel ais dashboard',
                run: () => {
                    if (window.InterceptNavPerf && typeof window.InterceptNavPerf.markStart === 'function') {
                        window.InterceptNavPerf.markStart({
                            targetPath: '/ais/dashboard',
                            trigger: 'command-palette',
                            sourceMode: (typeof currentMode === 'string' && currentMode) ? currentMode : null,
                            activeScans: (typeof getActiveScanSummary === 'function') ? getActiveScanSummary() : null,
                        });
                    }
                    if (typeof stopActiveLocalScansForNavigation === 'function') {
                        stopActiveLocalScansForNavigation();
                    }
                    window.location.href = '/ais/dashboard';
                }
            },
            {
                title: 'Kill All Running Processes',
                description: 'Stop all decoders and scans',
                keyword: 'kill stop processes emergency',
                run: () => {
                    if (typeof killAll === 'function') {
                        killAll();
                    } else if (typeof fetch === 'function') {
                        fetch('/killall', { method: 'POST' });
                    }
                }
            },
            {
                title: 'Toggle Sidebar Width',
                description: 'Collapse or expand the left sidebar',
                keyword: 'sidebar collapse layout',
                run: () => {
                    if (typeof toggleMainSidebarCollapse === 'function') {
                        toggleMainSidebarCollapse();
                    }
                }
            },
        ];
        for (const modeEntry of getModeCommands()) {
            commands.push({
                title: `Switch Mode: ${modeEntry.label}`,
                description: 'Navigate directly to mode',
                keyword: `mode ${modeEntry.mode} ${modeEntry.label.toLowerCase()}`,
                run: () => goToMode(modeEntry.mode),
            });
        }
        return commands;
    }
    function renderItems(query) {
        const q = String(query || '').trim().toLowerCase();
        const allItems = getCommands();
        filteredItems = allItems.filter((item) => {
            if (!q) return true;
            const haystack = `${item.title} ${item.description || ''} ${item.keyword || ''}`.toLowerCase();
            return haystack.includes(q);
        }).slice(0, 80);
        activeIndex = 0;
        listEl.innerHTML = '';
        if (filteredItems.length === 0) {
            const empty = document.createElement('div');
            empty.className = 'command-palette-empty';
            empty.textContent = 'No matching commands';
            listEl.appendChild(empty);
            return;
        }
        filteredItems.forEach((item, idx) => {
            const row = document.createElement('button');
            row.type = 'button';
            row.className = 'command-palette-item';
            row.dataset.index = String(idx);
            row.addEventListener('click', () => {
                item.run();
                close();
            });
            const meta = document.createElement('span');
            meta.className = 'meta';
            const title = document.createElement('span');
            title.className = 'title';
            title.textContent = item.title;
            meta.appendChild(title);
            const desc = document.createElement('span');
            desc.className = 'desc';
            desc.textContent = item.description || '';
            meta.appendChild(desc);
            row.appendChild(meta);
            if (item.shortcut) {
                const kbd = document.createElement('span');
                kbd.className = 'kbd';
                kbd.textContent = item.shortcut;
                row.appendChild(kbd);
            }
            listEl.appendChild(row);
        });
        renderSelection();
    }
    function renderSelection() {
        const rows = listEl.querySelectorAll('.command-palette-item');
        rows.forEach((row) => {
            const idx = Number(row.dataset.index || 0);
            row.classList.toggle('active', idx === activeIndex);
        });
        const activeRow = listEl.querySelector(`.command-palette-item[data-index="${activeIndex}"]`);
        if (activeRow) {
            activeRow.scrollIntoView({ block: 'nearest' });
        }
    }
    function goToMode(mode) {
        const welcome = document.getElementById('welcomePage');
        if (welcome && getComputedStyle(welcome).display !== 'none') {
            welcome.style.display = 'none';
        }
        if (typeof switchMode === 'function') {
            switchMode(mode, { updateUrl: true });
        }
    }
    function openSettingsTab(tab) {
        if (typeof showSettings === 'function') {
            showSettings();
        }
        if (typeof switchSettingsTab === 'function') {
            switchSettingsTab(tab);
        }
    }
    function open() {
        if (!overlayEl) return;
        isOpen = true;
        overlayEl.classList.add('open');
        renderItems('');
        inputEl.value = '';
        requestAnimationFrame(() => {
            inputEl.focus();
        });
    }
    function close() {
        if (!overlayEl) return;
        isOpen = false;
        overlayEl.classList.remove('open');
    }
    return {
        init,
        open,
        close,
    };
 })();
 document.addEventListener('DOMContentLoaded', () => {
    CommandPalette.init();
 });
@@ -0,0 +1,376 @@
 const FirstRunSetup = (function() {
    'use strict';
    const COMPLETE_KEY = 'intercept.setup.complete.v1';
    const DEFAULT_MODE_KEY = 'intercept.default_mode';
    let overlayEl = null;
    let depsStatusEl = null;
    let locationStatusEl = null;
    let notifyStatusEl = null;
    let modeStatusEl = null;
    let modeSelectEl = null;
    let dependencyReady = null;
    function init() {
        buildDOM();
        maybeShow();
    }
    function maybeShow() {
        if (localStorage.getItem(COMPLETE_KEY) === 'true') return;
        if (localStorage.getItem('disclaimerAccepted') === 'true') {
            open();
            refreshStatuses();
            return;
        }
        let attempts = 0;
        const waitTimer = setInterval(() => {
            attempts += 1;
            if (localStorage.getItem(COMPLETE_KEY) === 'true') {
                clearInterval(waitTimer);
                return;
            }
            if (localStorage.getItem('disclaimerAccepted') === 'true') {
                clearInterval(waitTimer);
                open();
                refreshStatuses();
            }
            if (attempts > 30) {
                clearInterval(waitTimer);
            }
        }, 1000);
    }
    function buildDOM() {
        overlayEl = document.createElement('div');
        overlayEl.id = 'firstRunSetupOverlay';
        overlayEl.className = 'setup-overlay';
        const modal = document.createElement('div');
        modal.className = 'setup-modal';
        const header = document.createElement('div');
        header.className = 'setup-header';
        const headingWrap = document.createElement('div');
        const title = document.createElement('h2');
        title.className = 'setup-title';
        title.textContent = 'Quick Setup';
        headingWrap.appendChild(title);
        const subtitle = document.createElement('p');
        subtitle.className = 'setup-subtitle';
        subtitle.textContent = 'Complete these checks once so all modes work reliably.';
        headingWrap.appendChild(subtitle);
        const closeBtn = document.createElement('button');
        closeBtn.type = 'button';
        closeBtn.className = 'setup-close';
        closeBtn.textContent = '×';
        closeBtn.setAttribute('aria-label', 'Close setup assistant');
        closeBtn.addEventListener('click', close);
        header.appendChild(headingWrap);
        header.appendChild(closeBtn);
        const content = document.createElement('div');
        content.className = 'setup-content';
        const depsStep = createStep(
            'Dependencies',
            'Verify required tools are installed for enabled modes.',
            (statusEl, actionsEl) => {
                depsStatusEl = statusEl;
                const checkBtn = buildButton('Recheck', () => checkDependencies());
                const openToolsBtn = buildButton('Open Tools', () => {
                    if (typeof showSettings === 'function') showSettings();
                    if (typeof switchSettingsTab === 'function') switchSettingsTab('tools');
                });
                actionsEl.appendChild(checkBtn);
                actionsEl.appendChild(openToolsBtn);
            }
        );
        const locationStep = createStep(
            'Observer Location',
            'Set latitude/longitude for pass prediction and mapping features.',
            (statusEl, actionsEl) => {
                locationStatusEl = statusEl;
                actionsEl.appendChild(buildButton('Open Location', () => {
                    if (typeof showSettings === 'function') showSettings();
                    if (typeof switchSettingsTab === 'function') switchSettingsTab('location');
                }));
                actionsEl.appendChild(buildButton('Recheck', refreshStatuses));
            }
        );
        const notifyStep = createStep(
            'Desktop Alerts',
            'Allow notifications so high-priority alerts are visible when the tab is hidden.',
            (statusEl, actionsEl) => {
                notifyStatusEl = statusEl;
                actionsEl.appendChild(buildButton('Enable Notifications', requestNotifications));
            }
        );
        const modeStep = createStep(
            'Default Start Mode',
            'Choose which mode should be selected by default.',
            (statusEl, actionsEl) => {
                modeStatusEl = statusEl;
                modeSelectEl = document.createElement('select');
                modeSelectEl.className = 'setup-btn';
                const modes = [
                    ['pager', 'Pager'],
                    ['sensor', '433MHz'],
                    ['rtlamr', 'Meters'],
                    ['waterfall', 'Waterfall'],
                    ['wifi', 'WiFi'],
                    ['bluetooth', 'Bluetooth'],
                    ['bt_locate', 'BT Locate'],
                    ['aprs', 'APRS'],
                    ['satellite', 'Satellite'],
                    ['sstv', 'ISS SSTV'],
                    ['weathersat', 'Weather Sat'],
                    ['sstv_general', 'HF SSTV'],
                ];
                for (const [value, label] of modes) {
                    const opt = document.createElement('option');
                    opt.value = value;
                    opt.textContent = label;
                    modeSelectEl.appendChild(opt);
                }
                const savedDefaultMode = localStorage.getItem(DEFAULT_MODE_KEY);
                if (savedDefaultMode) {
                    const normalizedMode = savedDefaultMode === 'listening' ? 'waterfall' : savedDefaultMode;
                    modeSelectEl.value = normalizedMode;
                    if (normalizedMode !== savedDefaultMode) {
                        localStorage.setItem(DEFAULT_MODE_KEY, normalizedMode);
                    }
                }
                actionsEl.appendChild(modeSelectEl);
                actionsEl.appendChild(buildButton('Save', () => {
                    const selected = modeSelectEl.value || 'pager';
                    localStorage.setItem(DEFAULT_MODE_KEY, selected);
                    refreshStatuses();
                    if (typeof showAppToast === 'function') {
                        showAppToast('Default Mode Saved', `New sessions will default to ${selected}.`, 'info');
                    }
                }));
            }
        );
        content.appendChild(depsStep);
        content.appendChild(locationStep);
        content.appendChild(notifyStep);
        content.appendChild(modeStep);
        const footer = document.createElement('div');
        footer.className = 'setup-footer';
        const note = document.createElement('span');
        note.className = 'setup-footer-note';
        note.textContent = 'You can reopen these options anytime in Settings.';
        const footerActions = document.createElement('div');
        footerActions.style.display = 'inline-flex';
        footerActions.style.gap = '8px';
        const laterBtn = buildButton('Remind Me Later', close);
        const completeBtn = buildButton('Mark Setup Complete', completeSetup, true);
        completeBtn.id = 'setupCompleteBtn';
        footerActions.appendChild(laterBtn);
        footerActions.appendChild(completeBtn);
        footer.appendChild(note);
        footer.appendChild(footerActions);
        modal.appendChild(header);
        modal.appendChild(content);
        modal.appendChild(footer);
        overlayEl.appendChild(modal);
        document.body.appendChild(overlayEl);
    }
    function createStep(title, description, initActions) {
        const root = document.createElement('div');
        root.className = 'setup-step';
        const header = document.createElement('div');
        header.className = 'setup-step-header';
        const titleEl = document.createElement('span');
        titleEl.className = 'setup-step-title';
        titleEl.textContent = title;
        const statusEl = document.createElement('span');
        statusEl.className = 'setup-step-status';
        statusEl.textContent = 'Pending';
        header.appendChild(titleEl);
        header.appendChild(statusEl);
        const descEl = document.createElement('p');
        descEl.className = 'setup-step-desc';
        descEl.textContent = description;
        const actionsEl = document.createElement('div');
        actionsEl.className = 'setup-step-actions';
        if (typeof initActions === 'function') {
            initActions(statusEl, actionsEl);
        }
        root.appendChild(header);
        root.appendChild(descEl);
        root.appendChild(actionsEl);
        return root;
    }
    function buildButton(label, onClick, primary) {
        const btn = document.createElement('button');
        btn.type = 'button';
        btn.className = `setup-btn${primary ? ' primary' : ''}`;
        btn.textContent = label;
        btn.addEventListener('click', onClick);
        return btn;
    }
    async function checkDependencies() {
        if (depsStatusEl) depsStatusEl.textContent = 'Checking...';
        try {
            const response = await fetch('/dependencies');
            const data = await response.json();
            if (data.status !== 'success') {
                dependencyReady = false;
            } else {
                const modes = Object.values(data.modes || {});
                dependencyReady = modes.every((modeInfo) => Boolean(modeInfo.ready));
            }
        } catch (err) {
            dependencyReady = false;
            if (typeof reportActionableError === 'function') {
                reportActionableError('Dependency Check', err, {
                    onRetry: checkDependencies,
                });
            }
        }
        refreshStatuses();
    }
    function refreshStatuses() {
        const hasLocation = hasValidLocation();
        const notifications = notificationStatus();
        const hasDefaultMode = Boolean(localStorage.getItem(DEFAULT_MODE_KEY));
        setStatus(locationStatusEl, hasLocation, hasLocation ? 'Configured' : 'Not set');
        setStatus(notifyStatusEl, notifications.ready, notifications.label);
        setStatus(modeStatusEl, hasDefaultMode, hasDefaultMode ? localStorage.getItem(DEFAULT_MODE_KEY) : 'Not set');
        if (dependencyReady === null) {
            checkDependencies();
            return;
        }
        setStatus(depsStatusEl, dependencyReady, dependencyReady ? 'Ready' : 'Missing tools');
        const doneCount = Number(dependencyReady) + Number(hasLocation) + Number(notifications.ready) + Number(hasDefaultMode);
        const completeBtn = document.getElementById('setupCompleteBtn');
        if (completeBtn) {
            completeBtn.textContent = doneCount >= 3 ? 'Mark Setup Complete' : 'Complete Anyway';
        }
    }
    function setStatus(el, done, label) {
        if (!el) return;
        el.classList.toggle('done', Boolean(done));
        el.textContent = String(label || (done ? 'Done' : 'Pending'));
    }
    function hasValidLocation() {
        const rawLat = localStorage.getItem('observerLat');
        const rawLon = localStorage.getItem('observerLon');
        if (rawLat === null || rawLon === null || rawLat === '' || rawLon === '') {
            return false;
        }
        const lat = Number(rawLat);
        const lon = Number(rawLon);
        if (!Number.isFinite(lat) || !Number.isFinite(lon)) return false;
        return lat >= -90 && lat <= 90 && lon >= -180 && lon <= 180;
    }
    function notificationStatus() {
        if (!('Notification' in window)) {
            return { ready: true, label: 'Unsupported (optional)' };
        }
        if (Notification.permission === 'granted') {
            return { ready: true, label: 'Enabled' };
        }
        if (Notification.permission === 'denied') {
            return { ready: false, label: 'Blocked in browser' };
        }
        return { ready: false, label: 'Permission needed' };
    }
    async function requestNotifications() {
        if (!('Notification' in window)) {
            refreshStatuses();
            return;
        }
        try {
            await Notification.requestPermission();
        } catch (err) {
            if (typeof reportActionableError === 'function') {
                reportActionableError('Notifications', err);
            }
        }
        refreshStatuses();
    }
    function completeSetup() {
        localStorage.setItem(COMPLETE_KEY, 'true');
        close();
        if (typeof showAppToast === 'function') {
            showAppToast('Setup Complete', 'You can revisit these options in Settings.', 'info');
        }
    }
    function open() {
        if (!overlayEl) return;
        overlayEl.classList.add('open');
    }
    function close() {
        if (!overlayEl) return;
        overlayEl.classList.remove('open');
    }
    return {
        init,
        open,
        close,
        refreshStatuses,
        completeSetup,
    };
 })();
 document.addEventListener('DOMContentLoaded', () => {
    FirstRunSetup.init();
 });
@@ -18,6 +18,18 @@
        if (menuLink) {
            event.preventDefault();
            event.stopPropagation();
            try {
                const target = new URL(menuLink.href, window.location.href);
                if (window.InterceptNavPerf && typeof window.InterceptNavPerf.markStart === 'function') {
                    window.InterceptNavPerf.markStart({
                        targetPath: target.pathname,
                        trigger: 'global-nav',
                        sourceMode: document.body?.getAttribute('data-mode') || null,
                    });
                }
            } catch (_) {
                // Ignore malformed link targets.
            }
            window.location.href = menuLink.href;
            return;
        }
@@ -0,0 +1,72 @@
 /* INTERCEPT Keyboard Shortcuts — global hotkey handler + help modal */
 const KeyboardShortcuts = (function () {
    'use strict';
    const GUARD_SELECTOR = 'input, textarea, select, [contenteditable], .CodeMirror *';
    let _handler = null;
    function _handle(e) {
        if (e.target.matches(GUARD_SELECTOR)) return;
        if (e.altKey) {
            switch (e.code) {
                case 'KeyW': e.preventDefault(); window.switchMode && switchMode('waterfall');    break;
                case 'KeyM': e.preventDefault(); window.VoiceAlerts && VoiceAlerts.toggleMute(); break;
                case 'KeyS': e.preventDefault(); _toggleSidebar();                                break;
                case 'KeyK': e.preventDefault(); showHelp();                                      break;
                case 'KeyC': e.preventDefault(); window.CheatSheets && CheatSheets.showForCurrentMode(); break;
                default:
                    if (e.code >= 'Digit1' && e.code <= 'Digit9') {
                        e.preventDefault();
                        _switchToNthMode(parseInt(e.code.replace('Digit', '')) - 1);
                    }
            }
        } else if (!e.ctrlKey && !e.metaKey) {
            if (e.key === '?') { showHelp(); }
            if (e.key === 'Escape') {
                const kbModal = document.getElementById('kbShortcutsModal');
                if (kbModal && kbModal.style.display !== 'none') { hideHelp(); return; }
                const csModal = document.getElementById('cheatSheetModal');
                if (csModal && csModal.style.display !== 'none') {
                    window.CheatSheets && CheatSheets.hide(); return;
                }
            }
        }
    }
    function _toggleSidebar() {
        const mc = document.querySelector('.main-content');
        if (mc) mc.classList.toggle('sidebar-collapsed');
    }
    function _switchToNthMode(n) {
        if (!window.interceptModeCatalog) return;
        const mode = document.body.getAttribute('data-mode');
        if (!mode) return;
        const catalog = window.interceptModeCatalog;
        const entry = catalog[mode];
        if (!entry) return;
        const groupModes = Object.keys(catalog).filter(k => catalog[k].group === entry.group);
        if (groupModes[n]) window.switchMode && switchMode(groupModes[n]);
    }
    function showHelp() {
        const modal = document.getElementById('kbShortcutsModal');
        if (modal) modal.style.display = 'flex';
    }
    function hideHelp() {
        const modal = document.getElementById('kbShortcutsModal');
        if (modal) modal.style.display = 'none';
    }
    function init() {
        if (_handler) document.removeEventListener('keydown', _handler);
        _handler = _handle;
        document.addEventListener('keydown', _handler);
    }
    return { init, showHelp, hideHelp };
 })();
 window.KeyboardShortcuts = KeyboardShortcuts;
--- a/Show More
+++ b/Show More