Skip to content

Home

Jump to bottom
Pentafive edited this page Jan 25, 2026 · 4 revisions

WSPR HA Bridge

Welcome to the WSPR HA Bridge wiki!

Quick Links

Getting Started

Installation

  1. HACS (Recommended)

    • Add https://github.com/pentafive/wspr-ha-bridge as a custom repository
    • Install "WSPR HA Bridge"
    • Restart Home Assistant
    • Add via Settings > Devices & Services

  2. Docker

    git clone https://github.com/pentafive/wspr-ha-bridge.git
cp .env.example .env
docker compose up -d

Monitor Modes

Mode Direction Use Case
RX You transmit Track who received your WSPR signal
TX You receive Track who you decoded
Dual Both Monitor both directions

Sensors Overview

v1.0.0 Features (95+ sensors)

Activity Sensors:

  • Total Spots, Unique Stations, Spots/hour, Spots (1h)
  • Most Active Band, Most Active Mode
  • Min/Avg/Max Distance, Min/Avg/Max SNR
  • Farthest Station, DX Ratio, Propagation Score
  • Average TX Power (dBm and Watts)

Global Network Sensors:

  • Global Spots (15 min), Global Max/Avg Distance
  • Unique Transmitters, Unique Receivers
  • Network-wide Most Active Band/Mode

Per-Band Sensors (11 bands × 5 metrics):

  • 160m, 80m, 60m, 40m, 30m, 20m, 17m, 15m, 12m, 10m, 6m
  • Each band: Spots, Avg SNR, Max Distance, Unique Stations, Avg Power

Health Sensors:

  • Feed Status (healthy/low_activity/stale)
  • Feed Latency, Total Fetches, Fetch Errors

Architecture

              ┌──────────────────┐
              │   WSPR.live      │
              │ (ClickHouse DB)  │
              │  2.7B+ spots     │
              └────────┬─────────┘
                       │ HTTP Poll (150s)
                       ▼
              ┌──────────────────┐
              │ wspr-ha-bridge   │
              │  • Polling       │
              │  • Deduplication │
              │  • Enrichment    │
              │  • Statistics    │
              └────────┬─────────┘
                       │
                       ▼
              ┌──────────────────┐
              │  Home Assistant  │
              │  • 95+ Sensors   │
              │  • Dashboards    │
              │  • Automations   │
              └──────────────────┘

Key Differences from pskr-ha-bridge

Aspect pskr-ha-bridge wspr-ha-bridge
Data Source mqtt.pskreporter.info db1.wspr.live
Model Push (MQTT subscription) Pull (HTTP polling)
Latency Sub-second 2-3 minutes
Update Cycle Event-driven Timer-driven (150s)
Modes FT8, FT4, CW, etc. WSPR, FST4W
Extra Data — Power (dBm/W), drift

Configuration Options

Filtering

  • Distance: Min/max distance in km
  • Bands: Select specific bands to monitor
  • Callsigns: Allow/block specific callsigns
  • Countries: Allow/block specific DXCC entities

Feature Toggles

  • Global Stats: Enable/disable network-wide statistics

Support

Clone this wiki locally