Skip to content

Logbook ​

Controls and data from 1.54.0 ​

Compact reduces the QSO entry area in standard logs. Additional fields and their values remain available in the full form. Extra info toggles the right information panel; Radio details remembers its expanded state.

State is stored separately from City/QTH. WAS uses validated US states from this field; existing city names are not automatically converted into states. ADIF preserves State separately. Opening a log automatically adds this optional field (schema 19); keeping a backup of .htlog files before updating remains advisable.

IOTA stores the island reference of the other station (e.g. EU-005) in the QSO form, the edit window and as an optional IOTA column in the log list. Spellings like "eu 5" become EU-005. ADIF uses the IOTA field; only a valid reference (continent + three digits) is exported. The POTA, SOTA and WWFF fields in the QSO form refer to the other station (their park/summit/reference). When opening a log, HAM-Tools adds the IOTA field (schema 21) and first saves a backup under Backups/.

Stats uses the active log except for the explicitly global DXCC card. Year charts and year labels use UTC, and band names are normalized for grouping. History only shows QSOs with a valid locator within the selected time, mode and band filters.

Memories reports load and write errors. Editing is disabled after a load failure until the file can be read again; Reload retries. Failed saves retain input. When editing QSOs, image changes are applied only on Save.

Export hunter logs without an own reference as standard ADIF. Cabrillo warns about missing received exchanges before exporting; EDI warns when the selected band does not match all selected QSOs. These warnings do not replace a review of the contest submission.

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.

The logbook is the heart of HAM-Tools. Multi-log, persistent sub-tabs, all award workflows.

Cluster and navigation from 1.52.0 ​

The DXClusters tab contains node selection, radius filtering, follow-radio control, alert acknowledgement and spot statistics. See DX cluster. The former standalone module has been removed. Modules shows or hides shared module navigation.

The CAT display has more room for VHF frequencies. Clicking the QRZ photo opens a larger view sized to the available screen area.

Saving, tables and data exchange from 1.51 ​

Sorting and filtering large logs and changing individual rows avoid unnecessary table rebuilds. Row numbers still refer to the chronology of the entire log. Report-only edits update the record and display without a full award recalculation.

After a successful save, the entry form resets or the edit dialog closes. If saving fails, input remains available for correction or retry. Newly created logs are remembered when switching between log types.

ADIF import offers new records only, all records, or a new log. Duplicate detection compares callsign, band and mode within an inclusive five-minute time window against the target log. Adding an existing .htlog file refreshes global awards immediately.

ADIF reimport also preserves exported solar values and own multi-SOTA references. For a complete backup including internal identifiers and status fields, keep the .htlog files as well; ADIF does not replace a full database backup.

Multi-Log ​

You can run any number of logbooks in parallel — for example:

  • Lifetime Log (default log, collects all your QSOs for life)
  • POTA Sessions (one per activated park)
  • Contests (one per contest weekend)

Each log is its own .htlog file (SQLite) in the data folder. Default: ~/Documents/HAM-Tools/Logs/.

Create a Log ​

  1. Top bar → click the log name → "Create New Log"
  2. Choose a type:
  3. Name + notes → Create

My Locator per Log from 1.56 ​

Every wizard asks for "My locator (for this log)", prefilled with the locator from Settings → Station. For a portable activation, enter the locator on site. The log keeps this locator even if you change the global one later.

In the outdoor wizards (POTA, SOTA, WWFF, BOTA, LLOTA, WCA, GMA) the field takes the locator of the selected reference as soon as you pick your park, summit or bunker. This is the centre point from the reference list: for large areas, better enter your actual position. A locator you typed yourself is never overwritten.

It is used for MY_GRIDSQUARE in the ADIF export and in the uploads to QRZ, Club Log, Wavelog, HRDLOG and eQSL, in the contest exchange and VHF distance scoring, in the EDI and Cabrillo header and on the eQSL card. LoTW still uses the station location from TQSL.

From 1.57 it also applies wherever the app calculates from your own location

from 1.57: the QTH marker and lines on the

cluster map, the history map and the contest map, the distance column and the spotter radius in the cluster, distance and bearing per QSO (entry, table, recalculation) and the rotor bearing on a spot click. Grayline, FreeDV, WSPR and the QTH locator module are not tied to a log and keep using the global locator.

  • An invalid locator (not 4, 6 or 8 Maidenhead characters) disables Create.
  • To change it later: log list → right-click the log → My Locator …. An empty field resets the log to the global locator.
  • Logs from earlier versions have no locator of their own and keep using the global one.
  • On the first start of a new version that updates the database, the app first backs up every logbook to Backups/ (name contains pre-v…). The backup can be opened again via Import ….

Switch Logs ​

Top bar → click the log name → popover with all open logs → click to switch. Sub-tab state (column widths, filters) is saved separately per log type.

Sub-Tabs ​

Below the QSO entry panel you'll find the tab bar with module-specific views. Which tabs are visible depends on the log type:

TabStandardPOTASOTAWWFFBOTALLOTAWCAGMAContest
Log (QSO table)✓✓✓✓✓✓✓✓✓
DXClusters (Spots · Map · Bandmap · Spot statistics, plus DXpeditions in the standard log)✓POTA feedSOTA feedWWFF filterBOTA filterLLOTA feedWCA filterGMA feedfiltered
Awards✓✓✓✓✓✓✓✓—
Memories (sked list)✓✓✓✓✓✓✓✓—
History (QSO card chronicle)✓✓✓✓✓✓✓✓—
Program Map—POTA mapSOTA mapWWFF mapBOTA mapLLOTA mapWCA mapGMA mapContest map
Band Plan✓✓✓✓✓✓✓✓✓

TIP

The DXClusters tab is the default at app launch — right after opening you see the current spots and can log directly by double-clicking an interesting spot.

QSO Entry Panel ​

The form type automatically follows the log type:

  • Standard Log → generic DX workflow (call, RST, name, locator)
  • Contest Log → lean Contest entry with dynamic exchange fields
  • POTA / SOTA / WWFF / BOTA / LLOTA / WCA / GMA Log → program-specific form with ref auto-complete, activation counter (10 / 4 / 44 / 1 / 10 / 50 / 4 QSOs) and P2P/S2S/R2R/B2B/L2L/C2C detection

CW/SSB Macros in the Form ​

Once CAT is connected, every form shows the F1–F8 macros above the voice keyer row (profile General; contests have their own profile): via Hamlib send_morse in CW mode, otherwise PTT plus your own voice recording. F1–F8 trigger the slots, Esc stops, the free-text field sends typed CW text with Enter. The {Ref} variable inserts the active log's reference (“CQ POTA … HB-0123”). Assign slots under Settings → Macros; details in the macro tutorial.

Auto-Fill from DX Cluster ​

Double-clicking a spot in the DXClusters table or Cluster tab fills call + frequency + mode into the entry panel. If CAT is active, the radio also jumps to the frequency.

Auto-Fill from Callbook ​

As soon as you leave the call field (Tab or Enter), a callbook lookup starts. Name, QTH, locator, country, continent, CQ/ITU zone (and for US stations state/county) are filled in. Auto-retry runs at log time in case the first attempt came up empty.

Multi-service lookup engine (new in 1.30.0)

Three services are available: QRZ.com, HamQTH and Callook.info (free, FCC database, US callsigns only — needs no credentials). Under Settings → Lookup & Upload you pick the primary and optionally a secondary (fallback) that steps in when the primary returns no hit. The auto-suggest toggles control field by field what gets filled from the lookup (name, QTH, locator, country, DXCC, zones, state, county, …) — they apply everywhere: QSO form, contest, all outdoor programs and bulk lookup.

Live Markings per Spot & QSO ​

New in 1.8.9

  • ATNO/NEW-BAND/NEW-MODE pill per spot in the DX cluster, live from your logged history — details see DX cluster.
  • Band Plan live pill in the QSO status bar shows immediately while logging whether frequency + mode are IARU-R1 compliant (green in band, orange wrong subsegment, red outside band). Active in all six QSO forms — details see DX cluster.

Band Plan as Its Own Window (⌘⇧P) ​

New in 1.8.8

The band plan is no longer just a sub-tab — it also opens as its own window via ⌘⇧P or menu Window → Band Plan Window. Handy on a second monitor while logging.

Award Counter ​

In the top right of the logbook you'll see, in the Standard and POTA logs:

  • DXCC: countries worked / confirmed — counted by DXCC entity (ADIF code resolved from the callsign), not by country name; "Germany" and "Fed. Rep. of Germany" are one country. The number may become smaller and more accurate after updating to 1.62 from 1.62
  • WAZ: CQ zones
  • WAS: US states (counts only QSOs from the USA)
  • QSOs: total count across all logs

What counts as "confirmed" (since 1.59 according to the award rules; before that eQSL counted everywhere): for DXCC and WAS only LoTW or a paper card — the ARRL does not accept eQSL for any of its awards. For WAZ likewise LoTW or card; CQ would additionally accept eQSL from "Authenticity Guaranteed" members, but HAM-Tools does not (yet) record whether the partner is AG, so those confirmations are missing from the WAZ counter — the number is too low rather than too high. A paper card is a received QSL whose route is not electronic (LoTW, eQSL, QRZ). The QRZ sync now marks QRZ's own confirmations without a route as "QRZ"; older QRZ confirmations without a route cannot be told apart and still count as a card. The QSL tab still shows every confirmation (LoTW, eQSL, direct) — that is about QSL status, not awards.

You record a paper card from 1.59 directly in the QSO editor (Edit): section QSL card with sent and received, each with a date (UTC) and a route (Direct, Bureau, Manager, Electronic — the ADIF codes D/B/M/E). Removing the tick clears date and route. If a sync has already set a route such as "LOTW" or "QRZ", it stays as its own entry; LoTW and eQSL themselves appear only as a hint and cannot be edited.

In the Contest Log the counter switches to QSOs / Bands of the active contest log.

ADIF Import/Export ​

  • Export ADIF: toolbar of the current log → exports all QSOs as ADIF 3.x
  • Import ADIF: preview and choice of new QSOs only, all QSOs, or import into a new log
  • Cabrillo Export: visible only for contest logs, pre-filled with all header fields from the wizard
  • Multi-Ref Split (POTA / WWFF / BOTA): for an outdoor log with multiple references, the export writes one file per park/ref/bunker, each with a single MY_SIG_INFO (upload platforms require it that way), using the filename scheme HB9HJI@K-1234 20260518.adi. Shared with MacADIF in the ADIFCore.OutdoorExporter library. SOTA keeps its own CSV V2 path. Details: POTA module.

Auto-Upload to External Logbooks ​

Six services upload new QSOs in real time once they are configured and enabled under Settings → Lookup & Upload:

  • QRZ Logbook — enter the API key; includes confirmation sync
  • Club Log — email + application password (the app API key is included)
  • eQSL.cc — username + password, per-log nickname override
  • LoTW — via the local tqsl binary with a station location
  • Wavelog (new in 1.35) — instance URL + API key, "Test connection" loads the station profiles from the server; the only service that also transfers contest and outdoor QSOs
  • HRDLOG.net (new in 1.46) — callsign + upload code; status column in the log, backfill older QSOs via right-click

The "Real-Time Upload" master switch pauses all services at once (travel mode). Each service has its own status column in the QSO table; existing QSOs can be batch-uploaded via right-click.

Resend after editing (new in 1.59): when an already uploaded QSO is changed (report, locator, comment, reference …), HAM-Tools remembers this per service. With auto-upload enabled the change goes out immediately: Club Log deletes the old record and inserts it anew; LoTW, eQSL, Wavelog and HRDLOG receive the QSO again. Otherwise the QSL tab lists the affected services under the "Changed" filter with the buttons Resend (↑) and Resolved (✓). What cannot be done is said plainly: QRZ is never resent, because QRZ would overwrite a confirmed record as unconfirmed — correct it there by hand and press "Resolved". If eQSL, Wavelog or HRDLOG reports a duplicate, the change was not applied there. If callsign, band, mode or time were changed, the old record stays at the service (except Club Log) and has to be deleted there; the QSL tab shows this until "Resolved".

Still manual: pota.app and sotadata.org.uk — upload via browser; the programme exports are split accordingly.

Keyboard Shortcuts ​

ShortcutAction
ReturnLog QSO
Cmd+,Settings
Cmd+Shift+POpen Band Plan window
Cmd+Opt+UCheck for updates
Cmd+Shift+BReport Bug
TabNext field
Shift+TabPrevious field

HAM-Tools © HB9HJI · Funkwelt