Schedules — Plan Skeds + DX Events
New in V1.9.9: a unified tab in the logbook for managing planned radio appointments. Two kinds of entries, same UI:
- Skeds — 1:1 appointments with a specific counterpart call ("Sunday 14:30 UTC, HB9XYZ, antenna comparison")
- DX Events — announced DXpeditions, net slots, contest windows ("3D2A Fiji, EU window 18:00 → 22:00 UTC")
Accessible as the lower tab-bar section "Schedules" in the logbook (Standard and Contest logs).
Create a Schedule
Toolbar at the top → "+ New":
| Field | Description |
|---|---|
| Type | Sked or DX Event (segmented control at the top) |
| Title | Optional, e.g. "Antenna Test" or "3D2A Fiji" |
| Call | Counterpart station (sked) or DX call (DX event). Auto-uppercase |
| Start (UTC) | Date + time in UTC, required field. Pre-filled with today 18:00 UTC for a new entry from 1.56 |
| End (UTC) | DX events only, optional — checkbox Set end of window. Pre-filled with 22:00 UTC; if you move the start past it, the end follows (start + 1 h) from 1.56 |
| Frequency | In MHz (e.g. 14.205), optional. As you type, the band is set automatically. An invalid entry blocks saving and shows "Invalid frequency — leave empty or enter e.g. 14.205" from 1.56 |
| Band | Auto from freq, manually overridable (2200m – 13cm) |
| Mode | SSB · CW · FM · AM · RTTY · FT8 · FT4 · JT65 · JS8 · PSK31 · DIGITAL |
| Status | scheduled / done / missed / cancelled |
| Reminder | none · 10 min · 30 min · 1 hour · 1 day before (macOS notification) |
| Notes | Free text |
At least title or call must be set — otherwise the Save button is disabled.
Card Actions
Each schedule entry appears as a card with:
| Element | Function |
|---|---|
| Type icon | Person symbol (sked) or globe (DX event) |
| Countdown | Live: "in 1 h 23 min", "Tomorrow 07:00 UTC", "running now" — color-coded. Day and time always in UTC, like the start time on the card from 1.55 |
| Status badge | Visible when not "scheduled"; card dimmed when done/missed |
| Reminder note from 1.56 | Orange with a crossed-out bell when the chosen reminder could not be scheduled — e.g. "Reminder not scheduled: notifications for HAM-Tools are disabled in System Settings." or "… the lead time is already in the past." |
| 📡 Log now | Opens the QSO form pre-filled (call · freq · band · mode · note) and sends a CAT QSY to the radio, if connected |
| 🔍 Cluster filter | DX events only: sets the DX cluster search field to call + band filter |
| ✏ Edit | A sheet opens pre-filled |
| ▾ Status | Quick menu: scheduled / done / missed / cancelled |
| 🗑 Trash | Delete without confirmation |
"Log now" + CAT
If your TRX is connected via CAT, it jumps automatically to the planned frequency and into the planned mode when you click "Log now" — you only need to type the RST values and log.
Sorting
Order in the list:
- Currently running DX events at the very top (with a green "running now" tag)
- Future appointments ascending by start time (nearest at the top)
- Past appointments descending (most recent at the top), dimmed
- Cancelled appointments at the very bottom
From 1.56 an appointment moves to the bottom as soon as you set it to "cancelled", and a cancelled or completed DX event no longer shows "running now" during its window from 1.56.
Filters
Pill filters above the list:
- Type: All · Skeds · DX Events
- Time: All times · Today · This week · Upcoming · Past
Filters combine independently. The counter in the top right shows "X of Y" visible/total entries.
Today and This week go by the UTC date, and the week starts on Monday from 1.56. Up to 1.55 the Mac's local time applied — an appointment at 23:30 UTC could land on the wrong day.
macOS Notifications
If you choose a reminder when creating an entry (e.g. "10 min before"), macOS sends a system notification at the lead time:
Sked with HB9XYZ
In 10 min · 14.205 MHz · 20m · SSB
Permission: The first time, macOS asks for permission. If you decline, the schedule is still saved — only the notification is skipped. From 1.56 the card says so too ("Reminder not scheduled: …")
from 1.56.Behavior on changes:
- Edit a schedule → the old notification is replaced by a new one
- Set status to "done/missed/cancelled" → the notification is cancelled
- Delete a schedule → the notification is cancelled
- Restart the app → all active schedules are re-queued at launch (rehydrate)
Notifications need a signed app build
In the DMG release, notifications work normally. In an unsigned dev build (swift run from source) macOS silently denies the permission request — the code path is safe (no crash), but there's no real notification.
Where Are Schedules Stored?
A JSON file under ~/Documents/HAM-Tools/Cache/schedules.json. The format is human-readable (ISO dates, pretty-printed) — you can open the file with any text editor in case you ever need a bulk import or export.
Save errors are shown from 1.56
- If the file cannot be read (e.g. after a faulty manual edit), the tab shows "Schedules could not be loaded" and blocks all changes so the existing file is not overwritten. Check the file, then click Reload. Up to 1.55 the next save would have overwritten the file with an empty list.
- If writing fails (disk space, access permissions), the previous state is kept and a message appears: "Schedule not saved" in the form, or "Schedule change not saved" for status changes and deletions.
Common Workflows
Arranged Sked with a Radio Friend
- + New → type "Sked", type the call, date + UTC time, frequency
- Note: "presence check before going abroad" or similar
- Reminder: "10 min before"
- Create — the macOS notification fires at the trigger
Mark a DXpedition Window
- + New → type "DX event", title "3D2A Fiji", call "3D2A"
- Start = window start UTC, turn on "Set end of window", End = window close
- Frequency + band + mode from the DX newsletter
- At the start of the window: click "Cluster filter" → the DX cluster shows only 3D2A spots on the planned band
After a Successful QSO
- Card → Status ▾ → "done" — the card is dimmed, the notification (if not yet fired) is cancelled
- On failure: "missed" — same UI reaction
- If the schedule is called off: "cancelled" — ends up at the very bottom of the sorting
Related Modules
- Logbook — where "Log now" lands
- DX Cluster — where "Cluster filter" takes effect
- CAT / Radio Control — prerequisite for QSY auto-tune
- Settings — the Schedules tab is always active, no settings of its own