ham-radio-dx

# Ham Radio DX Monitor 📻

Monitor DX clusters in real-time, get notified of rare DX stations, and track active DX expeditions. Perfect for ham radio operators who want to catch rare contacts!

## Features

📡 **Live DX Spots** - Connect to global DX cluster network  
🌍 **Rare DX Alerts** - Notify when rare stations appear  
📊 **Daily Digest** - Band activity summary  
🗺️ **DX Expeditions** - Track active expeditions  
⏰ **Automated Monitoring** - Run via cron for alerts  

## Quick Start

### Watch Live Spots

```bash
# Get latest DX spots
python3 dx-monitor.py watch

# Specific cluster node
python3 dx-monitor.py watch --cluster ea7jxh

# Use your callsign
python3 dx-monitor.py watch --callsign KN4XYZ

# Only show NEW spots (filters duplicates)
python3 dx-monitor.py watch --new-only
```

**Output:**
```
📡 Latest DX Spots from EA7JXH

   20m   SSB      14.195   K1ABC        - CQ Contest
   40m   CW        7.015   VP8/G3XYZ    - Falklands
   15m   FT8      21.074   ZL2ABC       - New Zealand
```

### Daily Digest

```bash
python3 dx-monitor.py digest
```

**Output:**
```
# 📡 DX Digest - 2026-01-27

## Band Activity (last 100 spots)

   20m   ████████████ 24
   40m   ████████ 16
   15m   ██████ 12
   10m   ████ 8

## Rare DX Spotted

   🌍 VP8/G3XYZ    40m      7.015 - Falklands Expedition
   🌍 ZL2ABC       15m     21.074 - New Zealand
```

## DX Cluster Nodes

Available clusters:
- **ea7jxh** - dx.ea7jxh.eu:7373 (Europe)
- **om0rx** - cluster.om0rx.com:7300 (Europe)
- **oh2aq** - oh2aq.kolumbus.fi:7373 (Finland)
- **ab5k** - ab5k.net:7373 (USA)
- **w6rk** - telnet.w6rk.com:7373 (USA West Coast)

## Automated Monitoring

### Using OpenClaw Cron (Recommended)

Use the OpenClaw cron tool to set up monitoring:

```bash
# Create a cron job for DX alerts (every 5 minutes)
cron add --name "DX Monitor" --schedule "*/5 * * * *" --payload 'systemEvent:Check DX cluster for rare spots' --sessionTarget main
```

### Manual Cron (Alternative)

If using system cron, run as a...

# Ham Radio DX Monitor - Quick Start

Monitor DX clusters for rare station spots and get daily digests.

## Installation

No installation needed - this is an OpenClaw skill. Just load it and use.

## Manual Usage

```bash
# Watch latest spots
python3 dx-monitor.py watch --callsign YOUR_CALL

# Only NEW spots (filters duplicates)
python3 dx-monitor.py watch --new-only --callsign YOUR_CALL

# Daily digest
python3 dx-monitor.py digest --callsign YOUR_CALL
```

## Automated Monitoring

Use OpenClaw cron for automated monitoring:

```bash
# Add DX monitor job (every 5 minutes)
cron add --name "DX Watch" --schedule "*/5 * * * *" --sessionTarget main --payload 'systemEvent:Check DX cluster'
```

Or add to your crontab (as non-root user):

```bash
crontab -e
# Add: */5 * * * * /path/to/dx-monitor.py watch --new-only --callsign YOUR_CALL >> ~/dx.log 2>&1
```

## Configuration

Create a config file or pass arguments:

```bash
python3 dx-monitor.py watch --callsign KN4XYZ --cluster ea7jxh
```

## Output

The monitor outputs DX spots in readable format:

```
📡 Latest DX Spots from EA7JXH

   20m   SSB      14.195   K1ABC        - CQ Contest
   40m   CW        7.015   VP8/G3XYZ    - Falklands
```