Awards - magicbug/Cloudlog GitHub Wiki

This guide explains every section available under the Awards menu in Cloudlog's top navigation bar.

The Awards menu tracks your progress towards amateur radio operating awards by cross-referencing your logbook against the entities, references, or locations each award requires. Only awards you have enabled in Award Settings appear in the menu.

What the Awards Menu Contains

The Awards dropdown can include:

  • CQ Magazine (WAZ)
  • DOK
  • DXCC
  • FFMA
  • GMDX Summer Challenge
  • Gridmaster (sub-menu: DL, LX, JA, US, UK)
  • IOTA
  • POTA
  • SIG
  • SOTA
  • US Counties
  • VUCC
  • WAB
  • WAJA
  • WAS
  • WWFF
  • Award Settings

Common Controls

Most award pages share the same set of controls:

  • Band β€” filter results to a single band or view all bands together. Defaults to all bands you have worked on.
  • Mode β€” filter results to a single mode or all modes.
  • Confirmation checkboxes β€” tick one or more of QSL, LoTW, and eQSL to count only contacts confirmed by those methods.
  • Show toggles β€” choose which rows are visible: Worked (contact logged), Confirmed (confirmation received), and/or Not Worked (entity not yet in your log). This lets you quickly focus on gaps in your awards progress.
  • Info button β€” displays a short description of the award.

Clicking any row in an award table opens a detailed QSO list for that entity, island, summit, park, or reference, filtered to the same band, mode, and confirmation settings you applied to the table.

CQ Magazine (WAZ)

URL: awards/cq

Worked All Zones (WAZ) is a CQ Magazine award for contacting all 40 CQ zones around the world.

What it Shows

A table listing all 40 CQ zones with their worked and confirmed status. Each row shows the zone number, zone name, and whether you have a QSL, LoTW, or eQSL confirmation.

Filters

Band, mode, confirmation type (QSL / LoTW / eQSL), show Worked / Confirmed / Not Worked.

Use Cases

  • Check how many of the 40 zones you have worked towards a WAZ certificate.
  • Spot unworked zones to prioritise in your DX chasing.

DOK

URL: awards/dok

Diplom OrtsverbΓ€nde Kennung (DOK) is a German amateur radio award for working contacts with German amateur radio club districts. Each district has a unique identifier (the DOK).

What it Shows

A table of German club districts with worked and confirmed status. A summary card at the top shows your total worked and confirmed count.

Filters

Band, mode, confirmation type (QSL / LoTW / eQSL), show Worked / Confirmed / Not Worked.

Use Cases

  • Track progress towards the DOK award issued by the DARC (Deutscher Amateur-Radio-Club).
  • Find specific districts you still need to contact.

DXCC

URL: awards/dxcc

The DX Century Club (DXCC) is the ARRL's flagship country-hunting award, requiring confirmed contacts with 100 or more DXCC entities.

What it Shows

  • An interactive world map with countries colour-coded by status: worked, confirmed (QSL / LoTW / eQSL), or not yet worked.
  • A summary card showing totals worked and confirmed overall.
  • Milestone progress bars showing your progress towards common DXCC thresholds (100, 200, 300, and Mixed totals).
  • A continent breakdown card with per-continent worked and confirmed totals.
  • A full sortable table of all DXCC entities with individual confirmation status.

Filters

Band, mode, confirmation type (QSL / LoTW / eQSL), show Worked / Confirmed / Not Worked, continent checkboxes (AF / AS / EU / NA / SA / OC / AN), and an Include Deleted Entities toggle.

Use Cases

  • See your current DXCC total at a glance.
  • Use the continent filter to focus on a specific region.
  • Enable "Not Worked" and filter by a continent to find remaining needed entities.
  • Use the map view to get a quick geographic overview of your coverage.

FFMA

URL: awards/ffma

The Fred Fish Memorial Award (FFMA) is a North American VHF award for working contacts from all 488 four-character Maidenhead gridsquares that cover the contiguous United States.

What it Shows

An interactive Leaflet map of the contiguous USA with a Maidenhead grid overlay. Each 4-character grid cell is colour-coded:

  • Worked β€” contact logged with a station in that grid
  • LoTW confirmed β€” contact confirmed via LoTW
  • Paper/eQSL confirmed β€” contact confirmed via QSL card or eQSL

A summary card shows the number of grids worked and confirmed out of 488 total.

Filters

Hover or click individual grid squares on the map to see QSO details.

Use Cases

  • Track US gridsquare coverage for VHF award chasing.
  • See at a glance which grids still need to be worked or confirmed.

GMDX Summer Challenge

URL: awards/gmdxsummer

The GMDX Summer Challenge is a Scottish DX group event run across four weeks on the 6-metre and 4-metre bands.

What it Shows

Results are presented week by week (Weeks 1–4) for both bands, broken down by:

  • CW contacts
  • SSB and other voice contacts
  • Digital contacts
  • Combined total

Note: The current implementation uses hardcoded dates for the 2024 event (late May through early July 2024). This page shows historical 2024 data.

Use Cases

  • Review your participation in the 2024 GMDX Summer Challenge.
  • Compare CW, voice, and digital activity across both 6m and 4m for each week.

Gridmaster

URL: awards/gridmaster/{variant}

Gridmaster is a gridsquare-based award available for five DXCC entities, each accessible from a sub-menu:

Sub-menu item URL
DL (Germany) awards/gridmaster/dl
LX (Luxembourg) awards/gridmaster/lx
JA (Japan) awards/gridmaster/ja
US (United States) awards/gridmaster/us
UK (United Kingdom) awards/gridmaster/uk

What it Shows

An interactive Leaflet map with a Maidenhead grid overlay covering the selected country. Grid cells are colour-coded by status:

  • Worked β€” at least one contact logged with a station in that grid
  • LoTW confirmed β€” confirmed via LoTW
  • Paper confirmed β€” confirmed via QSL card or eQSL

A count of grids worked and confirmed is displayed alongside the map.

Filters

Use standard Cloudlog band and mode filters to see coverage on a specific band or mode.

Use Cases

  • Chase the German Gridmaster award (DL) by finding coverage gaps.
  • Track gridsquare coverage within any of the five supported countries.

IOTA

URL: awards/iota

Islands On The Air (IOTA) is an award for contacting amateur radio stations on island groups around the world. Island groups are identified by IOTA references (e.g., EU-005).

What it Shows

A table of IOTA references with worked and confirmed status. A summary card shows total worked and confirmed counts.

Filters

Band, mode, continent checkboxes (AF / AS / EU / NA / SA / OC / AN), show Worked / Confirmed / Not Worked, and an Include Deleted References toggle.

Use Cases

  • Track progress towards IOTA award thresholds (100, 200, etc.).
  • Use the continent filter to focus on a specific region's island groups.
  • Enable "Not Worked" to generate a list of needed references to target.

POTA

URL: awards/pota

Parks on the Air (POTA) tracks contacts with stations activating national parks, state parks, nature areas, and other protected lands worldwide. POTA references are stored in the COL_POTA_REF ADIF field.

What it Shows

The POTA page uses HTMX to load four panels dynamically:

  • Stats panel β€” total unique parks worked, unique parks confirmed, first and last contact date.
  • Progress bars β€” visual progress towards POTA Hunter award thresholds: 10, 25, 50, and 100 unique parks.
  • Table β€” list of every POTA reference worked, with date, band, mode, and confirmation status.
  • Map β€” a Leaflet map showing the geographic location of all worked parks.

Filters

Date range (from / to), band, mode, confirmed-only toggle. Filters are applied across all four panels simultaneously.

Use Cases

  • See how many parks you have hunted towards the POTA Hunter award.
  • Use the map to visualise the geographic spread of your park contacts.
  • Filter to a specific date range to review a trip or event period.

SIG

URL: awards/sig

SIG (Special Interest Groups) is a flexible award tracker that works with the standard ADIF fields COL_SIG (type of SIG) and COL_SIG_INFO (specific reference within that SIG). QSO records must be logged with these fields populated before any data appears here.

What it Shows

A table listing every SIG type found in your log, along with:

  • The number of QSOs logged for that SIG type
  • The number of unique SIG references contacted

Clicking a SIG type opens a detail page listing every reference within that type and the contacts made.

If the SIG type is WAB, the link redirects to the dedicated WAB award page instead.

Each SIG type also has export buttons for ADIF and CSV to download all contacts for that group.

Populating SIG Data

Import QSO records with the MY_SIG and MY_SIG_INFO (or COL_SIG / COL_SIG_INFO) fields set, or edit individual QSOs to add these values. Common SIG types include BOTA (Bunkers on the Air), LOTA (Lighthouses on the Air), and similar activities.

Use Cases

  • Track activations or contacts for any programme that uses the ADIF SIG fields.
  • Export all contacts for a specific SIG type for award submission.

SOTA

URL: awards/sota

Summits on the Air (SOTA) tracks contacts with stations activating mountain summits worldwide. Summit references are stored in the COL_SOTA_REF ADIF field.

What it Shows

The SOTA page uses HTMX to load three panels dynamically:

  • Stats panel β€” total unique summits worked, confirmed summits, breakdown by band and by mode, and first/last contact dates.
  • Table β€” every SOTA contact with summit reference, association, region, summit name, date, band, mode, and confirmation status. The table has a client-side search box to filter by reference or callsign.
  • Map β€” a Leaflet map showing the geographic position of every worked summit, with markers colour-coded by confirmation status. Clicking a marker shows the QSOs for that summit.

Cloudlog automatically downloads the SOTA summit dataset when the page is first opened if the data files are missing.

Filters

Date range (from / to), band, mode, SOTA association, SOTA region, and a Confirmed Only toggle. All filters update all three panels simultaneously.

Use Cases

  • Review your SOTA chaser log and see how many unique summits you have worked.
  • Filter by association to focus on a mountain range or country programme.
  • Enable Confirmed Only to see which summits count towards your chaser score.

US Counties

URL: awards/counties

US Counties tracks contacts with stations in every county across all 50 US states, useful for the CQ USA-CA (United States Counties Award) and similar programmes.

What it Shows

A state-level summary table showing the number of counties worked and total counties in each state. Clicking a state opens a county detail page listing:

  • Each county name
  • Whether it has been worked and/or confirmed

Clicking a county in the detail view shows the QSOs logged for that county.

Use Cases

  • Track progress across US states and individual counties.
  • Identify states with low county coverage to prioritise in portable operations or county expeditions.

VUCC

URL: awards/vucc

The VHF/UHF Century Club (VUCC) is an ARRL award for VHF/UHF operators who contact stations in 100 or more Maidenhead gridsquares.

What it Shows

A summary table listing each band you have worked VHF/UHF contacts on, showing:

  • Grids worked on that band
  • Grids confirmed on that band

Clicking a Worked or Confirmed link opens a grid detail page listing every individual gridsquare for that band and type. Clicking a gridsquare in the detail page shows the QSOs logged for it.

Use Cases

  • Track your VUCC total per band (50 MHz, 144 MHz, 432 MHz, etc.).
  • See which gridsquares you have worked but not yet confirmed to prioritise QSL follow-up.

WAB

URL: awards/wab

Worked All Britain (WAB) tracks contacts with stations in every Maidenhead small square within the United Kingdom.

What it Shows

An interactive Leaflet map of Britain with a colour-coded small-square overlay. Squares change colour depending on worked and confirmed status. Below the map, a summary shows:

  • Total squares worked
  • Total squares confirmed

A table lists all WAB QSOs with square reference, date, band, mode, and confirmation status. Clicking a square on the map or in the table shows QSO details for that square.

Filters

Band, mode, confirmed-only toggle.

Use Cases

  • Track squares worked for the WAB award.
  • Use the map to find geographic gaps in your coverage.
  • Filter to a specific band to review VHF or HF WAB contacts separately.

WAJA

URL: awards/waja

Worked All Japan Prefectures (WAJA) is a JARL award for contacting stations in all 47 Japanese prefectures.

What it Shows

  • A colour-coded map of Japan showing which prefectures have been worked or confirmed.
  • A table listing all 47 prefectures with worked and confirmed status.
  • A summary card showing totals worked and confirmed.

Filters

Band, mode, confirmation type (QSL / LoTW / eQSL), show Worked / Confirmed / Not Worked, and an Include Deleted Entities toggle (inherited from the DXCC filter pattern).

Use Cases

  • Check progress toward completing all 47 prefectures.
  • Use the map to visually identify unworked prefectures.

WAS

URL: awards/was

Worked All States (WAS) is an ARRL award for contacting stations in all 50 US states.

What it Shows

  • A colour-coded map of the United States showing which states have been worked and/or confirmed.
  • A table listing all 50 states with worked and confirmed status per confirmation method.
  • A summary card showing total worked and confirmed.

Filters

Band, mode, confirmation type (QSL / LoTW / eQSL), show Worked / Confirmed / Not Worked.

Use Cases

  • Monitor WAS progress and see which states still need to be worked or confirmed.
  • Filter by band when chasing WAS on a specific band (e.g., 160m WAS or 6m WAS).

WWFF

URL: awards/wwff

World Wide Flora and Fauna (WWFF) tracks contacts with stations activating nature reserves and protected areas worldwide. References follow the format XX-NNNN (e.g., GFF-0001 for German flora and fauna sites).

What it Shows

  • A summary card showing total unique WWFF references worked and confirmed.
  • A table listing every WWFF reference contacted with date, band, mode, and confirmation status.

Filters

Band, mode, confirmation type (QSL / LoTW / eQSL).

Use Cases

  • Track WWFF hunter contacts for diplomas issued by the national WWFF programme coordinators.
  • Filter by band to review nature-area contacts on VHF or HF separately.

Award Settings

URL: award/index

Award Settings controls which awards appear in the Awards menu. Each award can be individually enabled or disabled.

How to Manage Awards

  1. Open Awards > Award Settings at the bottom of the Awards dropdown.
  2. A table lists every available award with a toggle switch in each row.
  3. Click a toggle to instantly enable or disable that award β€” changes are saved automatically without a page reload.
  4. Use the Activate All button to enable every award at once.
  5. Use the Deactivate All button to hide every award and start from a clean menu.

Disabled awards are hidden from the Awards dropdown menu entirely. You can re-enable them at any time.

Use Cases

  • Keep the Awards menu tidy by only enabling the awards relevant to your operating interests.
  • Quickly enable all awards when exploring what each one shows.

Tips

  • Most award pages default to showing all bands on first load, with QSL and LoTW confirmation both enabled. Adjust the filters after the page opens to narrow the view.
  • The Not Worked toggle is particularly useful when planning operating sessions β€” enable it along with Not Worked only to generate a list of targets.
  • SOTA and POTA use HTMX to lazy-load their panels. If a panel looks empty, wait a moment for the request to complete or check your internet connection for any external data dependencies.
  • DXCC band-by-band tracking requires that QSOs be logged with the correct band field. Check your import settings if totals look lower than expected.
  • SIG tracking requires QSOs to have the COL_SIG and COL_SIG_INFO ADIF fields populated. If the SIG page is empty, your QSOs for that programme may not have these fields set.

Troubleshooting

Award not appearing in the menu Open Awards > Award Settings and verify the toggle for that award is switched on.

Award page shows no data Confirm that your active logbook contains QSOs relevant to the award (correct band, DXCC entity, SOTA reference field, etc.). Check that the band and mode filters are not accidentally set to a value you have not logged.

SOTA page shows no summits Cloudlog downloads the SOTA summit dataset automatically. If the download fails, a message will appear in the application logs. Verify the server has outbound internet access and try reloading the page.

POTA or WWFF references are empty These awards rely on the COL_POTA_REF or COL_WWFF_REF ADIF fields being present in your log. If you imported QSOs from an ADIF file, verify the source file contains these fields.

FFMA or Gridmaster map is blank Ensure your station profile has a valid home gridsquare set, as these map views centre on your home location. The interactive map requires JavaScript to be enabled in your browser.