Einstellungen

Das Einstellungs-Fenster (⌘,) hat zehn Tabs. Jeder Tab konfiguriert einen klar abgegrenzten Bereich der App. Diese Seite ist der Hub — fünf Tabs (Station, CAT, Lookup & Upload, Macros, Lizenz) haben in Tutorials eigene Schritt-für-Schritt-Anleitungen.

Tab	Wofür
Station	Eigenes Rufzeichen, Locator, Kanton, App-Rufzeichen-Lizenz
Daten	Datenordner-Pfad, POTA/SOTA/WWFF/BOTA-Datenbanken, SCP-Quellen
CAT	TRX-Profil, Serial-Port, Baud, Hamlib-Subprocess-Status
Cluster	DXSpider-Knoten verwalten, Spotter-Radius
Lookup & Upload	QRZ, HamQTH, eQSL, Club Log, LoTW — alles QSL-bezogene
Externe Logger	UDP-Broadcasting an N1MM, Win-Test, Cluster-Master
Macros	F1–F8 Contest-Macros (CW + SSB)
Alerts	Watch-List für Cluster-Spots, macOS-Benachrichtigungen
Darstellung	Theme-Auswahl, App-Sprache
Lizenz	Lizenzschlüssel eingeben + aktivieren

Station

Hier definierst du wer du bist — alle anderen Module greifen darauf zurück.

Felder:

Feld	Beschreibung
Rufzeichen	Dein primäres Lizenz-Rufzeichen (z.B. `HB9HJI`). Wird in ADIF/Cabrillo-Exports als `OPERATOR` verwendet, dient als Substring-Master für die Pro-Log-Callsign-Validation
Locator	6-stelliger Maidenhead-Locator (z.B. `JN47PN`). Quelle für Distanz-Berechnungen, History-Map-Heimat-Punkt, Cluster-Radius-Filter
Kanton	Optional — nur für CH-Calls. Wird bei Schweizer Conteste als HQ-Info exportiert

Pro-Log-Callsign

Im Logbuch kann jedes Log einen eigenen Station-Call halten (Portabel, Ausland, Club-Call). Der hier eingetragene Master-Call ist nur der Default und die Validation-Basis. Siehe Logbuch — Pro-Log-Callsign.

Daten

Wo HAM-Tools seine Dateien ablegt — und welche Datenbanken es lädt.

Datenordner: Default ist ~/Documents/HAM-Tools/. Wechselbar via File-Picker. Auto-Migration vom Legacy-Pfad beim ersten Start. Enthält:

HAM-Tools/
├── Logs/       — .htlog SQLite-Dateien pro Logbuch
├── Cache/      — Spots, Callbook-Cache, Memories
├── Exports/    — ADIF (.adi) + Cabrillo (.cbr)
├── Backups/    — Auto-Backups vor riskanten Aktionen
└── Macros/     — SSB-Voice-Aufnahmen F1–F8

Datenbanken mit eigenem Lade-/Status-Indikator:

DB	Quelle	Größe
POTA-Parks	`pota.app`	~91k Einträge
SOTA-Gipfel	`sotadata.org.uk`	~181k Einträge
WWFF-Referenzen	`wwff-cc.org` + CSV-Import	wechselnd
BOTA-Referenzen	CSV-Import	wechselnd
SCP Master-Calls	`supercheckpartial.com` + `cdn.clublog.org`	~230k Calls

Jede DB hat Status-Pille (lädt / bereit / Fehler), Aktualisierungs-Button und Auto-Stale-Erinnerung nach 14 Tagen.

CAT

Anbindung an deinen Transceiver via Hamlib — HAM-Tools bringt ein gebundeltes rigctld-Helper-Binary mit (Yaesu, Icom, Kenwood, Elecraft + ~200 weitere Modelle).

Felder:

Feld	Beschreibung
TRX-Profil	Dropdown mit ~200 unterstützten Modellen (`trx-profiles.json`) — wählt automatisch Rig-Modell-ID, Default-Baud und PTT-Modus
Serial-Port	`/dev/cu.usbserial-*` oder `/dev/cu.SLAB_USBtoUART` — auto-detektiert via Dropdown
Baud-Rate	wird vom Profil vorbelegt, überschreibbar
CI-V-Adresse	nur für ICOM (z.B. `0x94` für IC-7300)
Hamlib-Status	Live-Anzeige ob `rigctld` läuft + Verbindungs-Healthcheck

Was passiert nach erfolgreicher Verbindung:

Frequenz wird automatisch im Logger angezeigt + persistiert
Mode wird als Single-Source-of-Truth verwendet (RST-Defaults folgen, Cabrillo-Mismatch-Warnung)
Macros F1–F8 senden CW direkt über send_morse
ICOM Voice-Keyer V1–V4 wird ausgelöst

CAT-Tutorial folgt

Schritt-für-Schritt-Inbetriebnahme mit USB-Kabel, Treiber-Check und Test-Ablauf kommt in Tutorials → CAT-Inbetriebnahme.

Cluster

DX-Cluster-Knoten verwalten. Mehrere Knoten parallel aktivierbar.

Pro Knoten:

Feld	Beispiel
Name	`DXSpider Funkwelt`
Host	`dxspider.funkwelt.net`
Port	`7300`
Aktiv	Toggle (mehrere Knoten gleichzeitig möglich)

Vorbelegte Knoten: Funkwelt, HB9W, DB0ERF, DX.OE5TXF, ON0ANT, VE7CC.

Spotter-Radius-Filter: Spots werden nach Distanz vom eigenen QTH gefiltert (Haversine-Formel, basierend auf Station-Locator).

Lookup & Upload

Der mit Abstand dichteste Tab: alle QSL- und Callbook-Services an einer Stelle. Sub-Picker zur Service-Auswahl, Master-Schalter für Real-Time-Upload.

Callbook-Lookup

Feld	Beschreibung
Primary Service	`QRZ.com` oder `HamQTH.com` — zuerst gefragt
Secondary (Fallback)	Optional zweiter Service, falls Primary keinen Treffer hat
Auto-Lookup beim TAB	Nach Eingabe des Calls + TAB werden Name/QTH/Locator etc. automatisch geholt
Felder ergänzen	10 Toggles: Name, QTH, Locator, Country, DXCC, CQ-Zone, ITU-Zone, IOTA, State, County — du wählst was übernommen wird

Cache: 30 Tage, lokal in Cache/callbook-cache.json.

Upload-Services

Master-Schalter »Real-Time-Upload« ganz oben — wenn aus, sind ALLE Auto-Uploads pausiert (Reise-Mode).

Service	Was es tut
QRZ.com	Auto-Upload pro QSO + Confirmation-Sync (»QRZ-Bestätigungen abrufen« im QSL-Tab)
eQSL.cc	Form-POST mit Nickname-Override pro Log, Status-Pille in Tabelle
Club Log	`realtime.php` mit Firewall-Schutz (Auto-Pause nach Burst)
LoTW (tqsl)	Subprocess-Upload via lokales `tqsl`-Binary, Confirmation-Sync via LoTW-Report-Download

Pro Service: API-Key/Username/Password + Auto-Upload-Toggle + »QSL via X gesendet«-Auto-Mark.

LoTW-Spezial

Feld	Erklärung
tqsl-Binary	Default `/Applications/Tqsl.app/Contents/MacOS/tqsl`. Auto-Detection beim ersten Start. Button »📁 Suchen…« rechts daneben öffnet einen Finder-Picker — du klickst einfach Tqsl.app an, HAM-Tools extrahiert den Binary-Pfad automatisch (auch wenn die App woanders als in /Programme liegt oder per Homebrew installiert wurde)
Station-Location	Dropdown aus `~/.tqsl/station_data.xml` (tqsl 2.5+) und `~/Library/Application Support/TrustedQSL/station_data.xml` (ältere tqsl). Picker zeigt deine in tqsl-GUI angelegten Locations

LoTW-Tutorial folgt

Komplette Pipeline (TQSL.app installieren, Station-Location in tqsl-GUI anlegen, Zertifikat einrichten, ersten Upload in HAM-Tools) kommt in Tutorials → LoTW-Pipeline.

Externe Logger

UDP-Broadcasting von Logged-QSOs an externe Tools. Mehrere Targets parallel konfigurierbar, je mit eigenem Format (N1MM, Win-Test, Cluster-Master, generisches ADIF-UDP).

Pro Target:

Feld	Beispiel
Name	`N1MM Logger`
Host	`192.168.1.50`
Port	`12060`
Format	N1MM XML / Win-Test / ADIF-UDP / Custom
Aktiv	Toggle

Sinnvoll z.B. wenn du HAM-Tools als Master-Logger nutzt und parallel ein zweites Tool für SDR-Bandscope oder Skimmer fütterst.

Macros

F1–F8 Contest-Macros (siehe Contest-Macros & Voice-Keyer). Acht Slots, je mit Label + CW-Text + optionaler SSB-Aufnahme.

Pro Slot:

Feld	Beschreibung
Label	Kurzer Anzeigename auf dem Button (z.B. `CQ`, `5NN`, `TU`)
CW-Text	Template mit Variablen `{MyCall}`, `{TheirCall}`, `{Snt}`, `{Rcv}`, `{Cnt}`, `{Exch}`
SSB-Aufnahme	Live-Aufnahme via Mikrofon, AAC/m4a-Datei in `Macros/Contest/`. Vorhören ohne PTT, Lösch-Button

Werks-Belegung (N1MM-Style): CQ · Exch · TU · MyCall · HisCall · ? · 5NN · AGN.

Mode-Auto-Erkennung: Beim Drücken eines Macro-Buttons schaut HAM-Tools auf radio.hamlibMode — CW → Hamlib send_morse, SSB → AVAudioPlayer mit PTT-Toggling.

Macros-Tutorial folgt

Setup-Walkthrough mit eigener Mikrofon-Aufnahme + ICOM Voice-Keyer kommt in Tutorials → Contest mit Macros.

Alerts

Watch-List für Cluster-Spots. Wenn ein Spot ein Prefix oder Rufzeichen aus der Liste matched, gibt's eine macOS-Benachrichtigung plus ★-Markierung in der Spot-Liste.

Feld	Beschreibung
Watch-Einträge	Liste von Prefixen (`DL`, `K1`) oder vollen Calls (`K1AA`)
DXCC-Filter	Optional zusätzliche DXCC-Auswahl (z.B. nur Most-Wanted-DXCC)
macOS-Notifications	Toggle — System-Notifications aktivieren, Permission wird beim ersten Aktivieren gefragt

Darstellung

Optik + Sprache der App.

Theme (V1.9.1):

Theme	Charakter
HAM Style	Default, ham-grün auf Anthrazit
Dark	klassisches macOS-Dunkel
Ham Classic	Beige/Gold, Retro-Funk-Optik
Matrix	Schwarz mit Matrix-Grün (`#00FF41`) und Cyan-Akzenten

Sprache: System / Deutsch / English. Effekt wird live übernommen, kein Neustart nötig.

Lizenz

Lizenzschlüssel-Verwaltung. HAM-Tools nutzt Ed25519-signierte Lizenzen — der Public-Key ist in der App eingebacken, der Private-Key liegt nur beim Autor (siehe Lizenz aktivieren).

Aktion	Wofür
Schlüssel einfügen	Aus E-Mail kopieren, hier einsetzen, `Aktivieren` klicken
Aktivierungs-Status	Zeigt Lizenz-Inhaber + Ablaufdatum (falls zeitlich begrenzt)
Reset	Löscht den aktuellen Schlüssel, App geht in Demo-Modus

Demo-Modus

Ohne aktivierten Schlüssel laufen einige Pro-Features (Auto-Upload an QSL-Services, Bulk-Operationen, Voice-Keyer-Aufnahme) eingeschränkt oder gar nicht. Details siehe Lizenz aktivieren.

Wo werden die Einstellungen gespeichert?

Alle Einstellungen leben in UserDefaults unter ~/Library/Preferences/com.hb9hji.hamrechner.plist. Passwörter (QRZ, HamQTH, eQSL, Club Log) liegen verschlüsselt im macOS-Keychain.

Wenn du auf einen neuen Mac umziehst:

Datenordner (~/Documents/HAM-Tools/) kopieren — enthält Logs, Caches, Macros
Plist (~/Library/Preferences/com.hb9hji.hamrechner.plist) kopieren — enthält Einstellungen ohne Passwörter
Passwörter neu eingeben — Keychain wird nicht automatisch mitkopiert (außer per iCloud-Keychain-Sync)
CAT-Profile neu zuordnen falls Serial-Port-Namen abweichen

Einstellungen ​

Station ​

Daten ​

CAT ​

Cluster ​

Lookup & Upload ​

Callbook-Lookup ​

Upload-Services ​

LoTW-Spezial ​

Externe Logger ​

Macros ​

Alerts ​

Darstellung ​

Lizenz ​

Wo werden die Einstellungen gespeichert? ​