Propagation

DX Monitor calculates a propagation score for every qualifying spot before firing a Telegram alert. The score is computed locally using real-time space weather data fetched from NOAA and hamqsl.

Data sources

Both are fetched in the background and cached for 15 minutes. If either fetch fails, the score is marked as Fail and the spot is not filtered out.

Score calculation

A score 0–99% is computed for both Short Path (SP) and Long Path (LP). The model factors in: estimated MUF from SFI, geomagnetic attenuation from Kp, solar hour at the path midpoint, high-latitude penalty (|lat| > 60°), and night enhancement for low bands (≤ 7 MHz). Both SP and LP are calculated independently using their respective midpoint coordinates.

In Telegram alerts

The score appears at the end of every alert message:

Propagation filter (dashboard slider)

The Alert Filters section of the dashboard includes a 📶 Min. propagation slider (0–99%). When set above 0, a spot is discarded if max(SP, LP) < prop_min. At 0 (default) no propagation filtering is applied.

Propagación

DX Monitor calcula un score de propagación para cada spot que pasa los filtros, antes de enviar la alerta Telegram. El cálculo es local, usando datos de tiempo espacial obtenidos en tiempo real de NOAA y hamqsl.

Fuentes de datos

Ambos se obtienen en segundo plano y se cachean 15 minutos. Si alguna descarga falla, el score aparece como Fail y el spot no se descarta.

Cálculo del score

Se calcula un score 0–99% para Vía Corta (SP) y Vía Larga (LP) independientemente. El modelo tiene en cuenta: MUF estimada a partir del SFI, atenuación geomagnética por Kp, hora solar en el punto medio del trayecto, penalización por latitudes altas (|lat| > 60°), y mejora nocturna en bandas bajas (≤ 7 MHz).

En las alertas Telegram

El score aparece al final de cada mensaje de alerta:

Filtro de propagación (slider del dashboard)

La sección de filtros del dashboard incluye un slider 📶 Propagación mín. (0–99%). Si se establece por encima de 0, un spot se descarta si max(SP, LP) < prop_min. En 0 (valor por defecto) no hay filtrado por propagación.

Telegram Alerts

DX Monitor sends formatted Telegram messages via the Bot API using your personal bot token and chat ID. All alert parameters are configured from the dashboard — no manual file editing.

Alert types

Alert content

Each alert includes: DX callsign and entity, frequency, band, mode, spotter, azimuth Short Path / Long Path (degrees), distance (km), propagation score SP/LP, and timestamp in local or UTC time.

Telegram alert example

Mode inference logic

Mode is determined in this order:

1. Spot comment explicitly mentions CW / SSB / RTTY / FT8 / FT4 → use that mode
2. No mode in comment + frequency matches FT8 or FT4 nominal (±1 kHz) → infer FT8 / FT4
3. No mode, not FT8/FT4 → infer CW or SSB by band plan. Never RTTY.
4. Frequency in exclusive CW segment → force CW regardless of comment

Language & time

Alert messages are sent in Spanish or English (alert_lang). Timestamps use the configured timezone (40+ grouped zones + manual IANA entry) in local or UTC mode (time_mode).

Alertas Telegram

DX Monitor envía mensajes Telegram formateados via Bot API usando tu token de bot personal y tu chat ID. Todos los parámetros se configuran desde el dashboard, sin editar ficheros.

Tipos de alerta

Contenido de la alerta

Cada alerta incluye: indicativo y entidad DX, frecuencia, banda, modo, spotter, azimut vía corta / vía larga (grados), distancia (km), score de propagación SP/LP y timestamp en hora local o UTC.

Ejemplo de alerta Telegram

Lógica de inferencia de modo

El modo se determina en este orden:

1. El comentario del spot menciona explícitamente CW / SSB / RTTY / FT8 / FT4 → se usa ese modo
2. Sin modo en el comentario + frecuencia coincide con nominal FT8 o FT4 (±1 kHz) → se infiere FT8 / FT4
3. Sin modo, no FT8/FT4 → se infiere CW o SSB por band plan. Nunca RTTY.
4. Frecuencia en segmento exclusivo CW → se fuerza CW independientemente del comentario

Idioma y hora

Los mensajes se envían en español o inglés (alert_lang). Los timestamps usan la zona horaria configurada (40+ zonas agrupadas + campo IANA manual) en modo local o UTC (time_mode).

Log Sources

DX Monitor reads your logbook to know which DXCCs, bands and modes you have already worked. Four formats are supported and selected from the dashboard.

Reload interval

Configurable in minutes from the dashboard. The log thread wakes at each interval, reads the source, and updates the in-memory DXCC/band/mode database used by the alert engine.

Docker path handling

Inside the container, the host filesystem is mounted read-only at /hostfs. The function host_path() transparently converts host paths entered in the dashboard to their /hostfs-prefixed equivalents. The directory browser (📂) navigates /hostfs and displays the real host paths.

Fuentes de log

DX Monitor lee tu libro de QSO para saber qué DXCCs, bandas y modos ya tienes trabajados. Se soportan cuatro formatos, seleccionables desde el dashboard.

Intervalo de recarga

Configurable en minutos desde el dashboard. El hilo de log se activa en cada intervalo, lee la fuente y actualiza la base de datos en memoria de DXCC/banda/modo que usa el motor de alertas.

Paths en Docker

Dentro del contenedor, el filesystem del host se monta en solo lectura en /hostfs. La función host_path() convierte de forma transparente los paths del host introducidos en el dashboard a sus equivalentes prefijados con /hostfs. El explorador de directorios (📂) navega /hostfs y muestra los paths reales del host.

Real-time Log & Alerts

The bottom of the dashboard shows two live panels updated by SSE — no page refresh, no polling.

How SSE works

No watcher thread. _escribir_status() writes status.json atomically with os.replace and calls sse_push() directly — zero latency between event and browser update. If the connection drops, the dashboard reconnects automatically after 5 seconds.

Live DX alerts panel

Each incoming alert that passes all filters appears instantly: callsign, entity, frequency, band, mode, azimuth SP/LP, distance, spotter, and timestamp. Anti-duplicate window (10 min) prevents repeated entries for the same spot.

System log panel

Last 40 lines of dx_monitor.log, color-coded by level:

Log lines are translated to the dashboard language (ES/EN), including internal key names like pais_nuevo, modo_sin_qsl, etc. Log timestamps respect the timezone configured in config.json.

Log y alertas en tiempo real

La parte inferior del dashboard muestra dos paneles en vivo actualizados por SSE — sin recarga de página, sin polling.

Cómo funciona SSE

Sin hilo vigilante. _escribir_status() escribe status.json atómicamente con os.replace y llama a sse_push() directamente — latencia cero entre evento y actualización en el navegador. Si se pierde la conexión, el dashboard reconecta automáticamente tras 5 segundos.

Panel de alertas DX en vivo

Cada alerta entrante que pasa todos los filtros aparece al instante: indicativo, entidad, frecuencia, banda, modo, azimut SP/LP, distancia, spotter y timestamp. La ventana antiduplicados (10 min) evita entradas repetidas para el mismo spot.

Panel de log del sistema

Últimas 40 líneas de dx_monitor.log, coloreadas por nivel:

Las líneas del log se traducen al idioma del dashboard (ES/EN), incluidas las claves internas como pais_nuevo, modo_sin_qsl, etc. Los timestamps respetan la zona horaria configurada en config.json.

Dashboard

The web dashboard at http://<nas-ip>:8765 is the single interface for all configuration and monitoring. No file editing required. Language (ES/EN) and theme (dark/light) are stored in localStorage.

Sections

Config persistence

All fields save on blur via POST /api/config. Filter toggles and the propagation slider save with 300 ms debounce via POST /api/flags. Config and flags are loaded once at startup (loadInitialData()) — polling never overwrites user edits in progress.

SSE connection

The dashboard opens a persistent EventSource to /api/alerts/stream. If the connection drops it reconnects automatically after 5 seconds. Current alerts are pushed immediately on connect — no separate polling needed.

Dashboard

El dashboard web en http://<ip-del-nas>:8765 es la interfaz única para toda la configuración y monitorización. Sin edición de ficheros. El idioma (ES/EN) y el tema (dark/light) se guardan en localStorage.

Secciones

Persistencia de configuración

Todos los campos se guardan al perder el foco (blur) via POST /api/config. Los toggles de filtros y el slider de propagación se guardan con debounce de 300 ms via POST /api/flags. Config y flags se cargan una sola vez al inicio (loadInitialData()) — el polling nunca sobreescribe ediciones en curso.

Conexión SSE

El dashboard abre un EventSource persistente a /api/alerts/stream. Si se pierde la conexión, reconecta automáticamente tras 5 segundos. Las alertas actuales se envían de inmediato al conectar — sin polling adicional.

Docker Installation

Quick start

Create a docker-compose.yml:

services:
  dxmonitor:
    image: ea3tb/dx-monitor:latest
    container_name: dx_monitor_docker
    restart: unless-stopped
    ports:
      - "8765:8765"
    volumes:
      - /:/hostfs:ro
      - dx_docker_data:/opt/dx_monitor_docker
    networks:
      - dx_net

volumes:
  dx_docker_data:
    driver: local

networks:
  dx_net:
    driver: bridge

# Deploy
docker compose up -d

# Open dashboard
http://<nas-ip>:8765

Useful commands

# Real-time logs
docker logs -f dx_monitor_docker

# Status
docker compose ps

# Stop / restart
docker compose down
docker compose up -d

# Shell access
docker exec -it dx_monitor_docker bash

# View active config
docker exec dx_monitor_docker cat /opt/dx_monitor_docker/config.json

Update to latest image

# Pull new image and redeploy
docker compose pull
docker compose up -d

Instalación Docker

Inicio rápido

Crea un docker-compose.yml:

services:
  dxmonitor:
    image: ea3tb/dx-monitor:latest
    container_name: dx_monitor_docker
    restart: unless-stopped
    ports:
      - "8765:8765"
    volumes:
      - /:/hostfs:ro
      - dx_docker_data:/opt/dx_monitor_docker
    networks:
      - dx_net

volumes:
  dx_docker_data:
    driver: local

networks:
  dx_net:
    driver: bridge

# Desplegar
docker compose up -d

# Abrir dashboard
http://<ip-del-nas>:8765

Comandos útiles

# Logs en tiempo real
docker logs -f dx_monitor_docker

# Estado
docker compose ps

# Parar / reiniciar
docker compose down
docker compose up -d

# Acceso al shell
docker exec -it dx_monitor_docker bash

# Ver config activa
docker exec dx_monitor_docker cat /opt/dx_monitor_docker/config.json

Actualizar a la última imagen

# Descargar nueva imagen y redesplegar
docker compose pull
docker compose up -d

Configuration

All settings are stored in /opt/dx_monitor_docker/config.json and edited from the dashboard. Fields save automatically on blur.

Configuración

Todos los ajustes se guardan en /opt/dx_monitor_docker/config.json y se editan desde el dashboard. Los campos se guardan automáticamente al perder el foco.

Alert Filters

Stored in flags.json. All toggles are available from the dashboard and take effect immediately without restarting.

Filtros de alerta

Guardados en flags.json. Todos los toggles están disponibles desde el dashboard y surten efecto inmediatamente sin reiniciar.

File Structure

Estructura de ficheros