Skip to content

Contest ​

Export checks from 1.54.0 ​

Cabrillo reports missing received exchanges before export. EDI warns when the selected export band differs from the QSO bands. Review the affected contacts before submitting your log. Contest templates remain available; outdated dates have been removed from their descriptions.

Operators from 1.53.0 ​

In the active contest log, Manage operators next to the operator selector opens the callsign list (one callsign per line). The list belongs to that log; an empty list means single-operator operation. Editing the list preserves existing QSO assignments.

To correct assignments, select the relevant QSOs in the table and use Assign operator. Choices include the operator list, previously used operators and No operator to clear an assignment. Only selected QSOs are changed. Check the selection before applying; a reported partial failure means that not all changes were saved.

Single QSOs are corrected from 1.59 in the QSO editor (double-click the row): the contest block has an Operator field with the log's OP list; empty means no operator.

Full contest logger with 40 templates, live score, dupe marking and Cabrillo V3 export.

Start a Contest ​

  1. Top bar → Logs → New Log → Contest card → opens the wizard
  2. Step 1: Choose a template — list of all 40 bundled contests with search:
    • HB / national: Helvetia (H26), USKA Field Day SSB/CW, USKA 50 MHz, NMD, Christmas Contest, Swiss Emergency Contest
    • CQ family: CQ-WW CW/SSB/RTTY, CQ-WPX CW/SSB/RTTY
    • HF DX: ARRL DX CW/SSB, ARRL RTTY Roundup, IARU-HF, WAE-DX CW/SSB, DARC-WAG, DARC 10m, RUS-DX, All Asian DX CW/SSB, JIDX CW/SSB, EU-HF-Champ, REF CW/SSB, SAC CW/SSB, EUCW/UFT
    • VHF/UHF: IARU R1 VHF & UHF, DARC-UKW, Helvetia-VHF, Marconi (144 MHz CW), AGCW VHF/UHF, Alpe-Adria VHF & UHF
  3. Step 2: Cabrillo categories — Operator (Single-Op, Multi-Two, …), Power (High/Low/QRP), Band (ALL / 160M / …), Mode (important!), Station (Fixed/Portable), Assisted, Time
  4. Create → the contest log is created and becomes active

Important: mode selection in the wizard

If you pick e.g. Mode: PH (= SSB) in the wizard, the app automatically filters the mode picker in the contest form, the DX cluster and the stats panel to SSB. With MIXED, all modes are allowed.

Contest Form ​

The entry panel in a contest is kept lean — no generic DX fields, only the fields from the template's Cabrillo exchange schema:

  • Call (with dupe detection — call+band+mode already logged → red border + toast; SSB, USB and LSB count as one mode from 1.57)
  • Band/Mode (band from CAT, mode restricted to allowed values)
  • Sent: dynamic fields from the template (e.g. RST + serial, or RST + canton)
  • Recv: dynamic fields (auto-selected based on the received call: HB → canton, DX → serial)
  • Run / S&P toggle (saved per QSO in the contestIsRun flag)

Helvetia Special Case ​

In Helvetia the Recv field changes live as you type the call:

  • HB9XX → Recv field shows canton (e.g. ZH)
  • DL1ABC → Recv field shows serial number (e.g. 001)

Sent is always your own canton (from Settings → Station).

Stats Panel (right) ​

In contest mode the right side panel shows live score instead of propagation:

  • Score summary: X pts × Y mult = Z total, centered
  • Rate meter: QSOs/h computed for the last 10 and 60 minutes
  • Score matrix (table): per band → multiplier count, CW/data/SSB QSOs, total
    • Columns depend on the template (Helvetia → "Kant", CQ-WW → "Zone", CQ-WPX → "Pfx", standard → "DXCC")
    • Only contest bands shown (160/80/40/20/15/10m at ALL)
  • Band Activity Heatmap: from DX cluster spots, filtered to contest bands
  • Op statistics (Multi-Op only, since 1.10.7): QSO count and percentage share per operator — see also Tutorial: Multi-Op Contest

DX Cluster in a Contest ​

The DXClusters tab at the bottom is filtered in a contest:

  • Only spots in the correct mode (PH contest → SSB spots only)
  • Only spots on contest bands

Plus color marking per spot:

  • 🔴 Red — already logged (call+band+mode match in your log)
  • 🟢 Green — likely a new multiplier (new country per band, new prefix for WPX)
  • Normal — neither dupe nor mult

Double-click a spot → call and frequency land in the contest form, CAT jumps along.

Contest Map ​

A dedicated sub-tab Contest Map (visible only for contest logs):

  • QTH-centered on your locator from the Station settings
  • Lines from your QTH to each geo-mapped QSO, switchable with the “QSO lines” toggle (on by default). With very many QSOs a note names the limit instead of silently omitting lines; without your own locator it shows “No own locator — no lines”
  • Band filter for quick drill-down (case-insensitive)
  • Empty state instead of a blank world map when the log has no QSOs with a position yet from 1.55
  • "QTH" button to re-center

Serial Counter ​

  • Per log (default) — for CQ-WW, CQ-WPX Single-Op, ARRL-DX, IARU
  • Per band — automatic for CQ-WPX Multi-Two / Multi-Unlimited / Multi-Distributed (CQ rule)

The serial number is auto-generated at log time (highest assigned + 1). On undo/delete the number is reused. Imported QSOs count as well, even if the band is spelled differently ("20M" from the ADIF import and "20m" from the entry form are one band) from 1.57.

Scoring ​

All 40 templates have their own rule-compliant scoring (shared with MacADIF via the ADIFCore library). The live score in the stats panel and the score matrix compute, depending on the contest:

  • Points per QSO — fixed (e.g. 1 pt), relationship-based (same country / same zone / same vs. different continent) or band-dependent.
  • Multipliers — DXCC countries, CQ/ITU zones, prefixes (WPX), cantons, oblasts, US states/provinces, prefectures … depending on the rules, sometimes per band.
  • VHF/UHF — distance scoring (km from locators, 1 point/km); for pure-distance contests (Marconi, AGCW, Alpe-Adria) without multiplier.

Scoring is still being validated

The engine hasn't yet been cross-checked against official result lists for every contest — verify the final score before submitting. ARRL RTTY Roundup, Russian DX, All Asian DX and JIDX are built against the official rules but still lack a comparison log.

from 1.56 CQ WW DX has been checked against six public logs from CQ WW SSB 2024 (HB9, CT, W0, JA, VK, PY; 215 to 1218 QSOs): five logger scores matched exactly, and for the sixth the official adjudication confirms the engine's multiplier count. Countries follow the "DXCC + WAE" list (Sicily, European Turkey, Shetland etc. count separately), the former approximation is gone. Based on the AD1C country files (cty.csv, September 2026). For the IARU-HF scoring ("same ITU zone" = 1 point), your own CQ/ITU zone must be set in Settings → Station.from 1.56 The ITU zone logged in the exchange now feeds the IARU scoring directly (previously only the callbook zone counted, and QSOs without a callbook hit dropped out of the score). If an HQ station sends its society abbreviation ("USKA", "DARC") instead of a zone, the callbook zone is kept. Your own CQ/ITU zone from Settings → Station pre-fills the sent field for CQ WW and IARU.

Cabrillo Export ​

Contest log toolbar → Cabrillo… → a sheet opens with all header tags pre-filled from the wizard:

  • CONTEST, CALLSIGN, OPERATORS
  • CALLSIGN is the log's call (club/portable call from the wizard, otherwise Settings → Station), OPERATORS the log's multi-op list; the same applies to EDI (PCall), where RCall stays the responsible operator from 1.57
  • Imported QSOs with a bare serial number (ADIF STX) keep their number per QSO line; the EDI distance is computed from the exported locator, not from a cached home-QTH value from 1.57
  • All CATEGORY-* tags
  • Sent exchange as the default value (per-QSO values from the log override it)
  • Claimed score, club, soapbox

The file lands under ~/Documents/HAM-Tools/Exports/. The format is Cabrillo V3 — accepted by ARRL/CQ/DARC/USKA.

Tips ​

  • Quick-toggle DX ↔ Contest: the top tab bar in the QSO entry panel — a click switches directly to the most recently opened log of that type
  • Multiple contests in parallel are possible (e.g. CQ-WPX on Saturday, a local HB contest afterwards). Switch via the Logs popover at the top
  • Set up a tester before the contest — the wizard's Cabrillo category choice can't be changed afterwards (delete + recreate would be the way)

Macros & Super Check Partial ​

  • F1–F8 macros are built in — CW via Hamlib (send_morse), SSB via your own voice recordings, plus ICOM/Yaesu voice-keyer slots. F1–F8 and Esc as keys, free-text CW field in CW mode. Guide: Tutorial: Contest with Macros.
  • SCP (Super Check Partial) is built in — suggestions from a master call DB as you type the call in the contest form.

Custom Templates ​

If a contest is missing, define it yourself: JSON files in the Contests folder of the data folder (~/Documents/HAM-Tools/Contests/*.json). Settings → Data → Contest Templates shows how many custom templates are loaded, opens the example file with every field in a text editor, opens the folder and reloads. Flow: open the example → save under a new name and adjust → “Reload”. Broken entries are reported individually there; the remaining templates stay usable.

  • Structure: a file holds an array of templates (or a single one). Required are id, name and exchangeFields; every field needs key, kind and role.
  • Field kinds kind: rst, serial, canton, zone, ituZone, grid, state, district, freeText. role: sent or recv. Optional visibility (always, onlyIfRecvIsHB, onlyIfRecvIsDX), autoFill (rstFromMode, serialNext, myCanton, myGrid, myZone, myItuZone), placeholder, width.
  • Scoring: scoringLike with the ID of a bundled template (e.g. "HELVETIA", "CQ-WW-CW") takes over its points, multipliers, stats columns and spot evaluation. Without scoringLike every QSO counts one point without multipliers.
  • Same ID as a bundled template replaces it — that is how you fix an exchange format without waiting for a release.
  • Unknown values are handled tolerantly (kind → free text, unknown autoFill is ignored); the template stays usable. In the New Contest sheet custom templates carry the “Eigene” (custom) badge.

Known Limitations ​

  • WAE QTC block not yet supported (coming in stage 3)
  • Custom scoring rules exist only via scoringLike; freely defined scoring inside a template is not possible yet

HAM-Tools © HB9HJI · Funkwelt