DX Cluster
Map view from 1.53.0
Under Logbook → DXClusters → Map, choose Classic or MapLibre · Prototype. In MapLibre, Basemap selects the offline world map or the street map. The latter loads tiles from OpenFreeMap and requires internet access, but no API key. Loading failures show the offline world map with Retry. Source attribution remains visible on the map.
QTH, world view, globe, time filter, grayline and CQ/ITU boundaries are available. Click a spot group to select a station; selection is shared with the classic view. Map clicks do not transmit or change the radio frequency. Locator grids, spotter lines and zone numbers currently remain in the classic view. Satellite imagery is not included.
Both views draw a dashed great-circle line from your QTH to the selected spot in the mode colour, with the distance at the midpoint; the info bar shows distance and bearing. Both are approximations to the centre of the DX country and therefore marked with «~»; only POTA spots carry real coordinates. Without a QTH locator in Settings, no line is drawn.
At app start HAM-Tools connects to its own DXSpider cluster dxspider.funkwelt.net:7300 and augments the Telnet spots with program-specific live feeds:
- POTA spots from
api.pota.app/spot/activator(every 60 s) - SOTA spots from
api2.sota.org.uk(every 60 s) - WWFF spots from the cluster stream (pattern match on
XXFF-NNNN) - BOTA spots from
api.wwbota.org/spots/(every 60 s) from 1.56, plus from the cluster stream as before (pattern + DB match). QRT reports are not shown as spots; the BOTA checkbox in the source bar hides the source.
Which feed is visible in the lower tab depends on the active log: standard log → classic DX cluster, POTA log → POTA feed, SOTA log → SOTA feed, and so on.
Logbook controls from 1.52.0
Open Logbook → DXClusters. The former standalone module has been removed; this page describes the cluster features that remain available. Separate windows are available from the Window menu.
DXClusters has the sub-tabs Spots, Map, Bandmap and Spot statistics, plus DXpeditions in the standard DX log from 1.55. All of them show the same filtered spots — in a contest only contest bands and modes. The former main tabs “Map” and “Bands” no longer exist. In the bandmap, spots without a free label row keep just their dot; the axis line gives their number, and a selected spot shows its callsign. The legend sits in the info bar.
The logbook provides node selection, an alert counter with acknowledgement, and Clear with confirmation. Band follows TRX in the band menu enables automatic band selection and disables manual selection while active. 6 m and 4 m remain selectable without spots.
The spotter radius filters by the location of the spotter, not the DX station: whoever hears a station within the radius around your locator (log locator, otherwise Settings → Station) can probably be heard by you too. Choose All, 500/1000/2500/5000 km, or a positive whole number of kilometres. The spotter position is the country centre derived from the callsign – 500 km around JN47 roughly means "spotters in DL, HB9, OE or F", not exactly 500 km. Spots whose spotter cannot be resolved are hidden while a radius is active; without a valid QTH, a warning is shown and the radius has no effect. Reset also clears the radius and follow-radio setting. The filter bar scrolls horizontally in narrow windows.
Spot statistics counts all received spots regardless of filters and is also available in the contest cluster. QSO statistics continues to describe your logged QSOs. Propagation indicators are always active in the standard DX log; contest markings remain unchanged. They only count spots from the last 15 minutes and each spotter once: green needs at least two different spotters in your region (under 1000 km) who heard the station, a single nearby spotter gives yellow at most. If the reports are older, the indicator shows no rating and the tooltip gives the age of the last report. from 1.58
The info icon beside FreeDV shows and controls connection and spot forwarding. The source checkbox alone does not connect the reporter. New FreeDV spots use DIGITALVOICE, so an SSB-only filter can hide them. The POTA checkbox is disabled when its source is off; enable it in Settings → Cluster. No matching spots indicates filtering, while No spots yet indicates an empty source list.
ATNO Live Marking 🆕
New in 1.8.9
For each spot in the DX cluster, a colored pill right to the left of the call shows whether the DXCC country/band/mode is still interesting for you:
- 🔴 ATNO — All Time New One: DXCC country never worked
- 🟠 NEW BAND — country already worked, but not on this band
- 🟡 NEW MODE — country+band already, but not in this mode
- no pill — already fully worked
The worked sets are derived live from the DXCCAccumulator that runs per log anyway — no extra scan, the lookup is O(1) per spot. The update happens immediately after every logged QSO. The comparison uses the DXCC entity (ADIF code resolved from the callsign via the AD1C country file), not the country name: "Germany" from QRZ and "Fed. Rep. of Germany" from a spot are the same entity. Countries and spotter positions come from the same country file; country names in the cluster follow its spelling.
Standard DX log only
ATNO is active in the standard DX log and in the DX cluster pop-up. In a contest, dupe/mult coloring dominates (red = dupe, green = new multiplier). In the outdoor programs, the respective spots tab shows its own ref-match logic (P2P/S2S/R2R/B2B).
DXpedition Alerts 🆕
New in 1.12.1
The DXpeditions tab in the DX cluster shows the NG3K ADXO list (Announced DX Operations) with around 40 active and planned DXpeditions — call, DXCC, time window, bands, source.
- Enable per entry: a toggle in the list — only monitored expeditions trigger alerts
- macOS notification as soon as a monitored DXpedition is spotted on the cluster within its QRV window
- ✈ marking: spots of monitored DXpeditions get a cyan airplane symbol in the spot list and in the logbook DX tab — you see at a glance that an expedition is on the band right now
- Prefix matching:
5Z4also catches5Z4/MM0ZBHor5Z4VJ— operator variants aren't lost. A complete call in the list (e.g.H49A) only matches exactly or portable (H49A/P), no longerH49ABCfrom 1.57 - If the feed returns an error page or incomplete XML, the last valid list is kept and the tab shows the error from 1.57
- Cooldown against pile-up spam: the same expedition doesn't trigger a notification again on every one of the dozens of follow-up spots
DX Assistant from 1.59
The Assistant sub-view of the cluster tab (standard DX log only) answers "what should I work right now?": one row per callsign, band and mode class (CW / phone / digital), ranked by its value for your own log and backed by what spotters are hearing at this moment.
- Need: ATNO (100), NEW BAND (50), NEW MODE (30) from the logbook; DXpedition (DXPED) and watchlist (WATCH) as their own need or as an extra chip. Without a resolved country there is no logbook need.
- Evidence: "heard by HB9XYZ (26 km) + DL1ABC (62 km)" — the nearest spotters of the last 15 minutes with their distance from your QTH. Weak evidence is said plainly ("only 1 station", "location unknown").
- Tier: from the same assessment as the propagation light. Now = green (at least two different near spotters, fresh), Watch = yellow. What the light shows grey does not appear. From 6 m up the near radius is 250 km and a single spotter never turns it green — sporadic-E clouds are small.
- ▶ or double-click: the same path as in the spot list — QSY via CAT (including split from the comment) and a prefilled QSO form. Nothing happens at the rig without a click.
- Filters: needs on/off, "Only Now". The cluster's band and mode filters apply as well.
- Alert (off by default): sound and macOS notification for new "Now" opportunities with ATNO or NEW BAND (selectable under Settings → Alerts). The alert cooldown applies per callsign, band and mode class.
- Window: "Open as window" or ⇧⌘A for a second monitor.
Band Plan Live Awareness in QSO Forms 🆕
New in 1.8.9
In all six QSO forms (DX, Contest, POTA, SOTA, WWFF, BOTA) a pill in the status bar tells you the moment you log whether frequency + mode are IARU R1 compliant.
- 🟢 in band — sub-segment fits the mode (e.g. SSB in the SSB area)
- 🟠 wrong sub-segment — e.g. SSB in the CW area, FT8 outside the digi sub-segment
- 🔴 outside amateur band — frequency lies completely outside all known bands
The data source is the bundled bandplan.json (22 bands + sub-segments). The mode-compatibility table is tolerant — "all modes" sub-segments let everything through. Reacts live to CAT frequency changes.
Columns & Filters
The spot table shows by default: ATNO pill · spotter · call · frequency · band · mode · comment · age. Columns are reorderable and hideable via header right-click or the "Columns" button in the toolbar (with reset).
Filters:
- Watchlist: preferred calls are marked yellow and can optionally be pinned to the top
- Award modes: shows only spots in modes you have active in the Award settings (e.g. only CW + Digi)
- Contest mode: with a contest log the spot list is automatically restricted to contest bands + mode category
- Band follows TRX (band filter menu, opt-in): the band filter automatically follows the frequency of the radio. A band change — even via WSJT-X over a shared
rigctld(see CAT → CAT Sharing) — pulls the spot list, world map, and logbook filter along. While active, manual band selection is locked and an antenna symbol indicates TRX mode.
Actions Per Spot
- Single click → marks the spot on the world map: when you switch to the map tab it's highlighted and centered. The selection is shared with the logbook and bidirectional — a click on a pin in the map conversely marks the row in the list.
- Double click → call + frequency + mode into the logbook entry panel, CAT follows (if connected)
- Right click → context menu with "Add to Logbook" / "Add to Watchlist" / "Open QRZ.com"
- ★ before the call → spot is on the watchlist
- The list holds still while the mouse is over it from 1.59: new spots no longer push the rows away under the pointer; they collect in an orange pill "n new spots" at the top edge. Click the pill or move the mouse out of the list → the new spots are inserted. In a contest your click now hits the station you meant.
A spot click does not force a switch from the DXClusters tab into the log sub-tab — you stay where you are (fix from 1.8.4).
The World Map: Own Atlas with Ham Overlays 🆕
New in 1.32 / 1.32.1
HAM-Tools draws the DX world map (and the grayline map) itself — Apple MapKit can never show the whole world by design.
- Full-world zoom: zoom out until the whole world is in view — scroll wheel, pinch or the “World” button in the map toolbar. The map wraps seamlessly across the date line.
- Atlas look in three detail levels: world view with slim country outlines; zooming in brings 242 countries with borders, lakes and rivers, including the Swiss lakes; cities appear by rank as you zoom (capitals first). Map data: Natural Earth (public domain).
- Ham overlays via the Overlays menu in the toolbar:
- Maidenhead locator grid in three levels matching the zoom — fields (
JN), squares (JN47) and, zoomed in deep, subsquares (JN47pn). Labels sit as a subtle watermark behind the spots. - CQ zones (40, orange) and ITU zones (90, cyan) with border lines and zone numbers.
- Maidenhead locator grid in three levels matching the zoom — fields (
- Grayline: the day/night boundary with the sun position — the classic view for greyline DX, as a map overlay and in the grayline map.
- Spot callsigns keep priority: map labels move out of the way instead of overprinting them.
Status in the Top Bar 🆕
New in 1.10.9
Next to the battery symbol in the logbook top bar, two pills show the connection status: an internet pill (WLAN / LAN / Cellular / Offline) and a cluster pill (green = connected, yellow = connecting, red = error, gray = disconnected; tooltip with pool count "N/M"). If the Mac is offline, the cluster pill is grayed out.
Map Window from 1.57
The cluster map is also available as a separate window — for a second monitor while the logbook stays in the main window. Open it via Window → DX Map Window (⇧⌘M) or the Open as Window button at the top of the map tab. The window shows the same spots as the DX cluster window, shares the selection with the spot list and the renderer switch (Classic / MapLibre) with the map tab. There is only one instance; opening it again brings it to the front.
Bandmap Pop-up
For each band you can open a separate bandmap as a pop-up window (new in 1.8.5). Several in parallel on a second monitor are possible — ideal during a contest or in DX pile-ups, where you want to keep an eye on 20 m and 40 m at the same time. Window → New bandmap and the quick selector offer all 14 bands up to 70 cm.
Configuration
Settings → Cluster:
- Multi-node setup (several DX cluster connections in parallel; a maximum of three active at the same time — spots from all active sources are deduplicated and merged into one list)
- Add your own cluster URLs (hostname:port + login call). The port must be a whole number from 1 to 65535, otherwise “Save” stays disabled; spaces around the host are removed.
- Cluster commands and your own spots go to a connected active node. Sending a spot validates the frequency (positive number in kHz).
- Status display + reconnect button per node
- External spot sources: toggles for SOTA/POTA/WWFF/BOTA fetching — switched off means nothing is polled at all (saves battery in the field)