Skip to content

v2.0.0 - HACS Integration with Global Monitor

Choose a tag to compare

@pentafive pentafive released this 04 Jan 17:23

PSKReporter HA Bridge v2.0.0

Complete modernization with dual deployment architecture (HACS + Docker).

Features

  • HACS Integration - Native Home Assistant custom component with ConfigFlow UI
  • Personal Monitor - Track spots for your callsign (RX, TX, or both directions)
  • Global Monitor - PSKReporter-wide statistics without requiring a callsign
  • Per-Band Activity - 10 sensors tracking propagation on 160m through 6m
  • Feed Health Monitoring - Real-time MQTT connection and data flow status
  • Count-Only Mode - Memory-efficient option for low-end hardware
  • Rate Limiting - Configurable message sampling (1:N) for global mode
  • Docker/MQTT Bridge - Alternative deployment for container environments

Documentation

Sensors

Personal Monitor

  • Total Spots, Unique Stations, Spots per Minute
  • Most Active Band/Mode, Maximum Distance, Average SNR
  • Connection Status, Feed Health, Message Rate

Global Monitor

  • Global Spots, Global Unique Stations
  • Most Active Band/Mode (Global)
  • Per-band activity (160m, 80m, 40m, 30m, 20m, 17m, 15m, 12m, 10m, 6m)
  • Health diagnostics (same as personal)

Installation

HACS (Recommended)

  1. Add https://github.com/pentafive/pskr-ha-bridge as a custom repository
  2. Install "PSKReporter Monitor"
  3. Restart Home Assistant
  4. Add integration via Settings > Devices & Services

Docker

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

Requirements

  • Home Assistant 2024.1.0+
  • Internet connection for PSKReporter MQTT feed
  • Optional: Amateur radio callsign (for personal monitoring)

Acknowledgements

  • Philip Gladstone, N1DQ - PSKReporter.info
  • Tom, M0LTE - Public MQTT feed