PSKReporter Monitor - Track amateur radio propagation in Home Assistant

Share your Projects! Custom Integrations
, ,
1

pskr-ha-bridge logo
pskr-ha-bridge logo672×256 129 KB

What is PSKReporter Monitor?

PSKReporter Monitor brings real-time amateur radio digital mode propagation data from PSKReporter.info into Home Assistant. Track FT8, FT4, WSPR, and other digital modes with live statistics, per-band activity, and feed health monitoring.

Features

  • Personal Callsign Monitoring - Track spots for your specific callsign (RX, TX, or both)
  • Global Propagation Monitor - PSKReporter-wide statistics without requiring a callsign
  • Per-Band Activity - Monitor propagation on 160m through 6m bands
  • Feed Health Monitoring - Real-time MQTT connection and data flow status
  • Distance & SNR Filtering - Focus on DX or local propagation
  • Low-Resource Mode - Count-only option for memory-constrained devices
  • Two Deployment Options - Native HACS integration or Docker/MQTT bridge

Monitor Modes

Mode Callsign Required Use Case
Personal Yes Track who’s hearing your signal, monitor your band conditions
Global No Network-wide propagation, great for non-hams

Sensors

Category Sensors
Activity Total Spots, Unique Stations, Spots/min, Last Spot Time
Propagation Most Active Band, Most Active Mode, Max Distance, Avg SNR
Per-Band 160m, 80m, 40m, 30m, 20m, 17m, 15m, 12m, 10m, 6m Activity
Health Feed Status, Connection Uptime, Message Rate, Latency

Installation (HACS)

  1. Open HACS in Home Assistant
  2. Click the three dots menu → Custom repositories
  3. Add https://github.com/pentafive/pskr-ha-bridge as Integration
  4. Search for PSKReporter Monitor and install
  5. Restart Home Assistant
  6. Go to Settings → Devices & Services → Add Integration
  7. Search for PSKReporter Monitor and configure

Deployment Options

Method Best For
HACS Integration Most users, native HA experience
Docker/MQTT Container deployments, MQTT-based setups

Links

Credits

  • Philip Gladstone, N1DQ - PSKReporter.info creator
  • Tom, M0LTE - Public MQTT feed at mqtt.pskreporter.info

Feedback

Questions or feature requests? Reply here or open an issue on GitHub.

73!

1 Like
2

Update: v2.3.0 – v2.4.0

Three releases since the original post — here’s what’s new.

v2.4.0 — Band Filter & DXCC Wanted List

Band Filter — Limit processing to specific bands (e.g., 20m, 40m, 6m). Multi-select in HACS options or SPOT_BAND_FILTER env var for Docker.

DXCC/Band Wanted List — Define DXCC/band combos you’re chasing (e.g., 339:20m,150:40m). When a matching spot arrives, pskr-ha-bridge fires a pskr_wanted_spot event (HACS) or publishes MQTT sensors (Docker). This is a detector — all spots still flow normally; wanted matches trigger additional alerts. Thanks to Graham VK3GA for suggesting this feature.

  • Direction-aware: RX checks sender DXCC, TX checks receiver DXCC, Dual checks both
  • New sensors: wanted_match (binary), wanted_match_count, wanted_list_size

Example automation:

automation:
  - alias: "Wanted DXCC Spot Alert"
    trigger:
      - platform: event
        event_type: pskr_wanted_spot
    action:
      - service: notify.mobile_app
        data:
          title: "Wanted DXCC Spotted!"
          message: >
            {{ trigger.event.data.sender_callsign }} on
            {{ trigger.event.data.band }} — DXCC
            {{ trigger.event.data.matched_dxcc }} |
            SNR {{ trigger.event.data.snr }} dB

v2.3.1 — Dashboard Generator

New web-based dashboard generator that builds ready-to-use Lovelace YAML for your pskr-ha-bridge sensors. Also available as a CLI tool.

Try it: Dashboard Generator

v2.3.0 — Per-Band Sensors & Extended Stats

50 new per-band sensors covering 10 amateur bands — each band gets unique countries, spot count, SNR average, best SNR, and farthest station. Plus new aggregate sensors:

  • DX Ratio — percentage of spots from outside your own DXCC entity
  • Propagation Score — composite 0–100 score based on band activity, unique countries, and distance
  • Farthest Station — callsign, distance, and bearing of the most distant spot

The integration now provides 78 sensors + 2 binary sensors in personal mode.

GitHub: GitHub - pentafive/pskr-ha-bridge: This script runs to produce a bridge for stats based on a call sign's reports with in PSKReporter.info's MQTT feed and then post them to Home Assistant via MQTT Discovery. · GitHub
Full changelog: CHANGELOG.md

73!