Einstellungen
Das Einstellungs-Fenster (⌘,) hat elf Tabs. Jeder Tab konfiguriert einen klar abgegrenzten Bereich der App. Diese Seite ist der Hub — mehrere Tabs (Station, CAT, Rotor, 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 | Verbindungsweg (USB / IC-705 WLAN / Netzwerk), TRX-Profil, Serial-Port, Baud, Hamlib-Subprocess-Status |
| Rotor | Antennenrotor via rotctld (USB / Netzwerk), 22 Modell-Profile, Kalibrierung, Spot-Klick-Tracking |
| 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–F8Datenbanken 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.co + CSV-Import | ~68k Einträge |
| 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).
Verbindungsweg (Picker »Weg«, neu in 1.13.0):
| Weg | Felder |
|---|---|
| USB (Serial) | Standard — HAM-Tools startet einen eigenen rigctld am Serial-Port (Felder siehe unten) |
| IC-705 WLAN | Radio-IP, Benutzer, Passwort — Werte aus dem Radio-Menü Set → WLAN-Set → Fernsteuerung (Network User mit Administrator-Rechten). Direkte Verbindung ohne Zusatztool; Audio läuft nicht über HAM-Tools. CI-V-Adresse muss zur Radio-Einstellung passen (IC-705: 0xA4) |
| Netzwerk (rigctld) | Host + Port eines bereits laufenden rigctld-Servers (z.B. wfview/kappanhang, oft Port 4533; Standard-rigctld: 4532) |
Details + Tutorial: CAT → Verbindungswege und IC-705 über WLAN verbinden.
Felder (USB-Weg):
| Feld | Beschreibung |
|---|---|
| TRX-Profil | Dropdown mit 31 kuratierten Profilen (trx-profiles.json) — wählt automatisch Rig-Modell-ID, Default-Baud und PTT-Modus. Das Hamlib-Backend kennt darüber hinaus ~200 weitere Modelle |
| 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) |
| CAT teilen | Schalter »rigctld für andere Programme offen halten« — hält den eingebauten Hamlib-Server lokal (127.0.0.1:4532) offen, sodass WSJT-X & Co. parallel dasselbe Radio nutzen. Mit WSJT-X-Konfig-Anzeige + Copy-Button und »Freigabe beenden« |
| 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) bzw. Yaesu (V1–V5) wird ausgelöst
- Bei modernen Yaesu startet der TUNE-Knopf einen echten Tuner-Abgleich (separat von der TUN-an/aus-Pille)
CAT teilen mit WSJT-X
Details zum Parallelbetrieb mit WSJT-X/fldigi (Rig = Hamlib NET rigctl, 127.0.0.1:4532, PTT = CAT) stehen im Modul CAT → CAT teilen.
CAT-Tutorials
Schritt-für-Schritt-Inbetriebnahme mit USB-Kabel, Treiber-Check und Test-Ablauf: Tutorials → CAT-Inbetriebnahme. Für den IC-705 ohne Kabel: IC-705 über WLAN verbinden.
Rotor
Antennenrotor-Steuerung via Hamlib (rotctld) — HAM-Tools bringt ein gebundeltes rotctld-Helper-Binary mit (SPID, Yaesu GS-232, Hy-Gain, Green Heron, EA4TX, Prosistel, M2 u.a., dazu Satelliten-Az/El).
Verbindungsweg (Picker »Weg«):
| Weg | Felder |
|---|---|
| USB (Serial) | Standard — HAM-Tools startet einen eigenen rotctld am Serial-Port (Felder siehe unten). Loopback-only (127.0.0.1) |
| Netzwerk (rotctld) | Host + Port eines bereits laufenden rotctld-Servers (Standard-Port 4533), z.B. ein Remote-Rotor im LAN |
Felder (USB-Weg):
| Feld | Beschreibung |
|---|---|
| Rotor-Profil | Hersteller + Modell aus 22 kuratierten Profilen (rotor-profiles.json) — wählt automatisch Hamlib-Rotor-Nr., Default-Baud, Serial-Parameter und Az/El-Fähigkeit |
| USB-Port | /dev/cu.usbserial-* o.ä. — auto-detektiert via Dropdown (🔄 aktualisiert) |
| Baud / Datenbits / Stoppbits / Parität / Handshake | vom Profil vorbelegt, überschreibbar |
| Nord-Offset / Drehbereich | Kalibrierung in Grad; Drehbereich z.B. 0–450 bei Überlapp |
| Elevation nutzen | nur bei Az/El-Modellen |
| Poll-Intervall | wie oft der Live-Azimut gelesen wird (Standard 1000 ms) |
| Spot-Klick-Tracking | Schalter »Beim Spot-Klick automatisch auf die Peilung drehen« — dreht die Antenne auf die Großkreis-Peilung zur DX-Station |
Was passiert nach erfolgreicher Verbindung:
- Live-Azimut auf der Kompass-Rose + manuelles Ziel per Slider/»Drehen«
- »Stop« hält eine laufende Rotation sofort an
- Bei aktivem Spot-Klick-Tracking dreht ein DX-Cluster-Spot-Klick die Antenne auf die Peilung (Quelle: eigener Station-Locator + DXCC-Standort des Spots)
Mehrere Rotor-Konfigurationen sind speicherbar (eine pro Rotor), Wechsel über den »Aktive Konfig«-Picker.
Rotor-Tutorial
Schritt-für-Schritt-Inbetriebnahme mit USB-Adapter, Treiber-Check, Kalibrierung und Spot-Klick: Tutorials → Rotor-Inbetriebnahme. Volle Modul-Doku inkl. Modell-Tabelle: Rotor / Antennensteuerung.
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
Komplette Pipeline (TQSL.app installieren, Station-Location in tqsl-GUI anlegen, Zertifikat einrichten, ersten Upload in HAM-Tools): 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
Setup-Walkthrough mit eigener Mikrofon-Aufnahme + TRX-Voice-Keyer: 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 |
| Übersprungenes Update | Unter App-Info (seit 1.14.1): zeigt eine mit „Diese Version überspringen" weggeklickte Version + »Zurücksetzen«-Button — danach wird sie beim nächsten Check wieder angeboten |
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