# Settings and Data

## Where everything lives

A `data/` folder is created **next to `OpsLog.exe`**:

- **Settings database** (SQLite): settings, profiles, rigs/antennas, cluster
  nodes, lookup cache, award lists, QSL templates. Always local.
- **Logbook** (`logbook.db`, SQLite): QSOs, when the profile logs locally.
- `data/qsl/templates/…` — QSL card templates and their photos.
- `data/qsl/outbox/…` — sent QSL card JPEGs.
- Recordings folder (configurable) — per-QSO WAV/MP3.
- Backups, diagnostic logs.

Paths are stored **relative to the folder**, so the whole OpsLog directory can
move to another drive or PC. Back up your setup by copying `data/`. See
[[Profiles and Databases]] for local-vs-MySQL logbooks.

## Settings map

| Section | What |
|---------|------|
| **General** | language, theme, date format (US / FR / Standard), Main-view panes, digital-modes grouping, Super Check Partial, ClubLog exceptions & Most Wanted |
| **Station** | your callsign, grid, name, address (my-station ADIF) — hand-corrected CQ/ITU zones stay corrected |
| **CAT** | radio backend + connection, CAT sharing (rigctld), protocol trace ([[CAT Control]]) |
| **Lookup** | QRZ.com / HamQTH credentials |
| **Audio** | DVK / recorder devices, PTT, gains and levels, RX monitor |
| **CW Keyer** | engine (WinKeyer / Serial / Icom / Flex CWX / Yaesu / TCI), macros, ESM |
| **External services** | LoTW (TQSL), QRZ, eQSL, ClubLog, HRDLog, POTA, Cloudlog/Wavelog |
| **Email** | SMTP for eQSL-by-email and *Send log to F4BPO* |
| **Amplifier / Tuner Genius / Antenna Genius / Rotator / Antenna** | station hardware ([[Amplifiers and Switches]] · [[Maps and Antennas]]) |
| **Database** | settings DB + this profile's logbook, rename/relocate |
| **Backup** | database + ADIF backup at shutdown |

## Appearance & language

Four themes (Warm light, Warm dark, Graphite dark, High contrast) plus **Auto**
(follows the OS); fresh installs start dark. Full **English / French** UI with
a first-run flag chooser and a switcher in Settings → General. **Ctrl + wheel**
zooms the whole UI (remembered; Ctrl+0 resets). The window title bar is drawn
by OpsLog — drag the top bar to move, double-click to maximise — and the window
reopens on the screen it was closed on.

## UDP integrations

- **Inbound**: WSJT-X / MSHV / JTDX QSO logging and status (unicast or
  multicast), and DXHunter remote-call packets (fills the callsign, tunes the
  rig when the packet carries `<FREQ>`/`<MODE>`).
- **Outbound**: the current frequency to **PstRotator**, radio info in **N1MM
  `RadioInfo`** format, or an **ADIF record on each logged QSO**.

## Other

- **Autostart** external programs (WSJT-X, JTAlert, rotator control…) at
  launch, skipping any already running.
- **Update check** at startup, when opening Help → About, and every 5 minutes.
  A "What's new" summary appears on the first launch after each update.
- **Help → Send log to F4BPO** (shown when SMTP is configured) e-mails the
  diagnostic logs straight to the developer.
- **Anonymous usage telemetry** — a once-a-day heartbeat (random install ID +
  version + OS; no callsign or QSO data). Opt out in Preferences.
