Options

Open with Alt+O or the Options button. Changes take effect when you press OK.

Tree display

Expand first level after update

After each fetch, open the top level of the tree so the outermost groups are visible without expanding them by hand. On by default.

Collapse all after update

After each fetch, collapse the whole tree to just the top-level groups. Off by default. If both this and "Expand first level" are on, collapse wins.

Branches you had open are re-opened after a refresh where possible, so auto-refresh doesn't lose your place.

Updates

Check for updates at startup

When PSK Heard By starts, quietly ask GitHub whether a newer release exists. If one does, the status line says so and a prompt offers to download and install it — choosing Yes downloads the installer and launches it, and PSK Heard By closes so the update can finish. If the check can't complete (offline, etc.) nothing is shown. On by default. You can always check by hand with F4.

Sound

Enable success sound

Play a sound when a fetch succeeds. Off by default.

Enable failure sound

Play a sound when a fetch fails (timeout, network error, HTTP error). On by default.

File (for each)

The .wav file to play. A bare filename is looked for next to the program; you can also Browse to any file and store a full path. Defaults are fetch-success.wav and fetch-failed.wav.

Fetch

Fetch timeout

How long to wait for PSK Reporter before giving up: 15, 30, 45, 60, or 90 seconds. 45 by default. Raise it on a slow link; a large 24-hour query for a busy callsign can take a while.

Spot data caching

Accumulate spots across fetches

Instead of replacing the results each fetch, merge new spots into the existing tree. Lets you build a picture of a whole session. Off by default. The settings below apply only when this is on.

Retain accumulated spots for

Drop accumulated spots older than this on each fetch: Forever, or 15 minutes up to 30 days. "Forever" keeps everything for the session.

Clear accumulated data at startup

Begin every session with an empty set rather than reloading what was cached last time.

Clear Data Now

Immediately discard all accumulated spots. Asks first.

Where settings are stored

All of the above, plus your callsign, direction, time window, tree layout, and window position, are saved to:

%LOCALAPPDATA%\PSKHeardBy\PSKHeardBy.ini

It's a plain text key=value file you can inspect or back up. Delete it to return everything to defaults. The same folder holds the location cache (cache.json) and the log files described in Troubleshooting.