Home Assistant integration for ClubLog, the amateur radio community's premier DX logging and analysis platform. Track your DXCC progress across bands and modes, monitor propagation conditions, follow active DXpeditions, and automatically generate "still needed" watchlists that feed into pskr-ha-bridge and wspr-ha-bridge for real-time spot alerting.
Data provided by ClubLog. ClubLog is created and maintained by Michael Wells, G7VJR. If you find ClubLog valuable, please consider supporting the project.
Disclaimer: This project is independently developed and is not affiliated with, endorsed by, or connected to ClubLog or its maintainer. "ClubLog" is a service created by Michael Wells (G7VJR).
- DXCC Progress Tracking — Worked, confirmed, and verified entity counts
- DXCC Wanted List — Computes "still needed" DXCC/band pairs for pskr-ha-bridge and wspr-ha-bridge
- Most Wanted Rankings — Global most wanted DXCC entity list with top 10 in attributes
- Active Expeditions — Track current DXpeditions with QSO counts
- Callsign Monitor — Activity summary (total QSOs, expedition status, OQRS, last upload)
- Livestreams — Active ClubLog livestreams with callsigns and URLs
- Band Activity — Propagation data based on actual logged QSOs
- Options Flow — Configure confirmation threshold and tracked bands via HA UI
- API Health — Connectivity binary sensor with per-endpoint error tracking
- Install HACS if not already installed
- Add this repository as a custom repository in HACS
- Install "ClubLog HA Bridge"
- Restart Home Assistant
- Go to Settings > Devices & Services > Add Integration > ClubLog
git clone https://github.com/pentafive/clublog-ha-bridge.git
cd clublog-ha-bridge
cp .env.example .env
# Edit .env with your ClubLog credentials and MQTT broker
docker compose up -d| Setting | Description |
|---|---|
| Callsign | Your amateur radio callsign |
| API Key | ClubLog API key (request here) |
| Email associated with your ClubLog account | |
| Application Password | Generated in ClubLog Settings > Application Passwords (not your main login password) |
| Endpoint | Default | Notes |
|---|---|---|
| DXCC Matrix | 60 min | Server caches for 60 minutes |
| Watch/Monitor | 10 min | Callsign activity summary |
| Most Wanted | Weekly | Updated infrequently (per G7VJR) |
| Activity Data | Daily | Updated only a few times per year |
| Expeditions | 60 min | Active DXpedition list |
| Livestreams | 10 min | Active livestream list |
All intervals include ±10% jitter to avoid synchronized polling bursts.
| Sensor | Description |
|---|---|
sensor.clublog_dxcc_worked |
Total DXCC entities worked |
sensor.clublog_dxcc_confirmed |
Total DXCC entities confirmed |
sensor.clublog_dxcc_verified |
Total DXCC entities verified (LoTW) |
sensor.clublog_dxcc_needed |
DXCC entities with at least one needed band |
sensor.clublog_dxcc_needed_bands |
Total DXCC/band slots still needed (wanted list in attributes) |
| Sensor | Description |
|---|---|
sensor.clublog_active_expeditions |
Count of active DXpeditions (details in attributes) |
sensor.clublog_active_livestreams |
Count of active livestreams (details in attributes) |
sensor.clublog_most_wanted_count |
Total most wanted entities (top 10 in attributes) |
| Sensor | Description |
|---|---|
sensor.clublog_watch_total_qsos |
Total QSOs uploaded to ClubLog |
sensor.clublog_watch_is_expedition |
Whether callsign is flagged as expedition |
sensor.clublog_watch_has_oqrs |
Whether OQRS is enabled |
sensor.clublog_watch_last_upload |
Timestamp of last log upload |
| Sensor | Description |
|---|---|
sensor.clublog_band_activity |
Number of active bands (per-band totals in attributes) |
| Sensor | Description |
|---|---|
binary_sensor.clublog_api_status |
API connectivity (on = at least one endpoint succeeded recently) |
sensor.clublog_api_consecutive_errors |
Total consecutive API errors (disabled by default) |
| Project | Description |
|---|---|
| pskr-ha-bridge | PSKReporter spots > Home Assistant |
| wspr-ha-bridge | WSPR propagation data > Home Assistant |
| 8311-ha-bridge | AT&T ONT monitoring > Home Assistant |
| web888-ha-bridge | KiwiSDR Web-888 > Home Assistant |
| ntopng-ha-bridge | ntopng network monitoring > Home Assistant |
If you find this integration useful:
- Buy Me a Coffee — Support development of this and other HA integrations
- Support ClubLog — ClubLog is a free service maintained by G7VJR
This project is independently developed and is not affiliated with, endorsed by, or connected to ClubLog or its maintainer. All ClubLog data is provided by the ClubLog API and remains the property of ClubLog.
MIT License - see LICENSE for details.