LoTW-Pipeline einrichten

LoTW (Logbook of The World) ist das offizielle ARRL-System für QSO-Bestätigungen und wird für die meisten DXCC-, WAS- und WAZ-Awards akzeptiert. HAM-Tools nutzt das offizielle CLI-Tool TQSL als Subprocess — du behältst volle Kontrolle über Zertifikate und Station- Locations.

Dauer: 30 Minuten beim ersten Mal, danach laufen Uploads in Sekunden.

Voraussetzungen

• LoTW-Account bei arrl.org/logbook-of-the-world (kostenlos, Postversand-Verifizierung kann 1–2 Wochen dauern)
• HAM-Tools installiert und Lizenz aktiviert
• Internetverbindung

Phase 1 — TQSL.app installieren (einmalig)

HAM-Tools liefert TQSL nicht mit (ARRL-Lizenzgründe). Du installierst es selbst.

1. Download: lotw.arrl.org/lotw-help/installation/ → »TQSL for macOS« (aktuell 2.8.x)
2. DMG öffnen, TQSL.app in den Programme-Ordner ziehen
3. Erster Start: Gatekeeper meckert (»nicht verifizierter Entwickler«). Rechtsklick → »Öffnen« → »Trotzdem öffnen«.

tqsl 2.5+

HAM-Tools unterstützt sowohl tqsl ≥ 2.5 (Configs in ~/.tqsl/) als auch ältere Versionen (Configs in ~/Library/Application Support/TrustedQSL/). Du musst dich nicht entscheiden — der Picker findet beides.

Phase 2 — ARRL-Zertifikat anfordern + importieren

1. In TQSL.app: Callsign Certificate → Request New Callsign Certificate
2. Rufzeichen eintragen, Land/DXCC, Lizenz-Zeitraum
3. »Save Request« → erzeugt .tq5-Datei
4. Per E-Mail (verlinkt am Ende des Wizards) an ARRL einreichen
5. ARRL schickt Postkarte an deine Lizenzadresse mit Verify-Code (das ist warum das 1–2 Wochen dauern kann)
6. Nach Antwort: TQSL.app → Callsign Certificate → Load Certificate → .tq6-Datei laden, die ARRL dir mailt
7. Beim Laden vergibst du ein Cert-Passwort — merken!

TQSL legt das Cert in seinem eigenen Datenordner ab (~/.tqsl, ältere Versionen ~/Library/Application Support/TrustedQSL), nicht im macOS-Schlüsselbund.

Phase 3 — Station-Location in TQSL anlegen

Eine Station-Location beschreibt wo du gefunkt hast (für die LoTW-Zuordnung von DXCC-Multipliers, US-States, ITU/CQ-Zonen).

1. TQSL.app → Station → Station Locations
2. »Add« klicken
3. Wizard durchklicken:
   • Callsign: HB9HJI (dein Lizenz-Call)
   • DXCC Entity: Schweiz / dein Land
   • CQ Zone: 14 (CH), ITU Zone: 28
   • Grid Square: dein Locator (z.B. JN47PN)
   • State / County: nur bei W/VE relevant
4. Name vergeben: z.B. HB9HJI/HOME (wird in HAM-Tools angezeigt)
5. »OK«, Station ist gespeichert in ~/.tqsl/station_data.xml

Mehrere Stationen

Wenn du portabel funkst oder im Ausland, leg pro Standort eine eigene Location an: HB9HJI/JN36, HB9HJI/M-Toskana, HB9HJI/AM. HAM-Tools lädt immer mit der Location hoch, die in den Einstellungen gewählt ist (Phase 4) — vor dem Upload von einem anderen Standort dort umstellen.

ab 1.56 Der eigene Locator eines Logs gilt

für LoTW nicht: Den Standort (und damit MY_GRIDSQUARE) bestimmt hier die Station-Location in TQSL.

Phase 4 — In HAM-Tools verknüpfen

Erst jetzt kommt HAM-Tools ins Spiel.

1. Einstellungen → Lookup & Upload (⌘, → Tab »Lookup & Upload«)
2. Sub-Picker oben: »LoTW« wählen
3. tqsl-Binary: Default ist /Applications/Tqsl.app/Contents/MacOS/tqsl — Auto-Detection sollte den Pfad gefunden haben. Falls leer oder die App liegt woanders: Button »📁 Suchen…« rechts neben dem Feld klicken → im Finder einfach die Tqsl.app anklicken, HAM-Tools trägt den Binary-Pfad automatisch ein. Funktioniert auch mit Homebrew-Installation (/opt/homebrew/bin/tqsl direkt auswählen).
4. Station-Location: Dropdown öffnen → du siehst die Locations aus Phase 3. Wähle deine Default-Location (z.B. HB9HJI/HOME)

Picker leer?

Wenn das Dropdown leer bleibt: Station-Location war noch nicht in TQSL angelegt. Phase 3 wirklich abgeschlossen? Liegt ~/.tqsl/station_data.xml (oder ~/Library/Application Support/TrustedQSL/station_data.xml)? Im Terminal prüfen:

cat ~/.tqsl/station_data.xml
ls -la ~/Library/Application\ Support/TrustedQSL/

Phase 5 — Auto-Upload aktivieren

Drei Toggles in der LoTW-Section:

Toggle	Effekt
»Jedes geloggte QSO automatisch hochladen«	Pro QSO ein TQSL-Aufruf — empfohlen für Daheim-Logger. Wirkt nur in Standard-Logs (DX)
»Nach erfolgreichem Upload › QSL via LoTW gesendet ‹ markieren«	Setzt zusätzlich den allgemeinen QSL-Versand (Datum + «LOTW»), sofern noch keiner eingetragen ist — empfehlenswert. Bis 1.56 war der Schalter ohne Wirkung ab 1.57
»Real-Time-Upload (Master)« ganz oben	Wenn aus, ALLES pausiert (für Reisen/Portabel ohne Internet)

Phase 6 — Ersten Upload testen

1. Logbuch → Log auswählen, mind. 1 QSO darin
2. QSO in der Tabelle markieren (oder mehrere via ⌘-Klick)
3. Rechtsklick → »An LoTW hochladen (tqsl)« (bei mehreren: »N QSOs an LoTW hochladen (tqsl)«) — alle markierten QSOs gehen in einem einzigen tqsl-Aufruf raus
4. Hat dein Zertifikat ein Passwort (Phase 2), fragt tqsl in einem eigenen Fenster danach — HAM-Tools speichert es nicht
5. Warte 5–30 Sekunden — ein Alert meldet das Ergebnis (»N QSOs an LoTW hochgeladen« mit Neu / Duplikate / Fehler, oder »LoTW-Upload fehlgeschlagen« mit dem Ende der tqsl-Ausgabe). Die Spalte »QSL-Status« in der Tabelle zeigt danach:

Anzeige	Bedeutung
LoTW → (Zeile gelb)	Erfolgreich an LoTW übergeben
LoTW ✓ (Zeile grün)	Gegenstation hat ihr QSO auch hochgeladen + es matched

Initial wirst du nur LoTW → sehen — Confirmation kommt, wenn die Gegenstation ihrerseits uploaded.

ab 1.56 Der Upload-Status landet immer im

Log, aus dem das QSO stammt — auch wenn du während des Uploads ein anderes Log öffnest.

Phase 7 — Confirmation-Sync

Nach ein paar Tagen / Wochen haben einige Gegenstationen ihre QSOs auch bei LoTW eingereicht. Hol dir die Bestätigungen:

1. Einmalig: Einstellungen → Lookup & Upload → LoTW, Abschnitt »Confirmation-Sync (LoTW Web-Login)« — Username und Password deines Accounts auf lotw.arrl.org eintragen (nicht das Cert-Passwort aus Phase 2)
2. Logbuch → Tab »QSL« in der unteren Tab-Leiste
3. Button »LoTW-Bestätigungen abrufen« (derselbe Abruf steckt in den Einstellungen hinter »Bestätigungen jetzt abrufen«)
4. HAM-Tools holt den LoTW-Report (ADIF) von arrl.org und matched ihn gegen die QSOs des geöffneten Logs auf Call + Datum/Uhrzeit (auf die Minute) + Band + Mode; ein Alert zeigt, wie viele Bestätigungen zugeordnet und neu sind
5. Bestätigte QSOs wechseln in der Spalte »QSL-Status« von LoTW → auf LoTW ✓
6. Awards-Tab zeigt die neuen Confirmed-Counter

Abgleich erst ab 1.56 zuverlässig ab 1.56

Bis 1.55 fand der Abruf wegen eines Parser-Fehlers keine Bestätigungen. Hast du vorher vergeblich abgerufen, einfach jetzt noch einmal abrufen. Ab 1.57 prüft der Abgleich alle Logbücher, nicht nur das geöffnete; nicht lesbare Logbücher nennt das Ergebnis ab 1.57.

Frequenz: 1× pro Woche reicht

LoTW pusht Bestätigungen nicht in Echtzeit. Ein wöchentlicher Sync deckt 95% ab. Wenn ein DXpedition-QSO wichtig ist (LoTW-Sync der DX-Operatoren erfolgt oft erst nach 6 Monaten), warte einfach.

Häufige Probleme

»Station Location X could not be found«
→ Tippfehler im Picker. Geh in TQSL.app → Station Locations und prüfe den exakten Namen (Gross-/Kleinschreibung zählt). Oder Picker in HAM-Tools nochmal öffnen — Dropdown zeigt die echten Namen.

Cert-Passwort wird jedes Mal abgefragt
→ Das ist Absicht (Sicherheit). Speichern ginge nur via Keychain- Item-Reuse, das machen wir nicht — du könntest sonst nicht zwischen Personal/Club/Contest-Certs trennen.

»tqsl: error: command-line option 'x' not recognized«
→ Du hast eine sehr alte TQSL-Version (< 2.5). Aktualisiere auf 2.7+.

Upload landet im »rejected«-Branch obwohl alles ok aussieht
→ Der Fehler-Alert enthält das Ende der rohen tqsl-Ausgabe ([tqsl output]). Häufige Ursache: Cert ist abgelaufen (LoTW-Certs gelten 3 Jahre), oder die Mode-Bezeichnung (z.B. FT8 vs. MFSK) wird von tqsl nicht akzeptiert. Manuelles tqsl im Terminal aufrufen reproduziert das.

Einige QSOs abgelehnt — und keins ist als gesendet markiert ab 1.56
→ Lehnt LoTW bei einem Sammel-Upload einzelne QSOs ab (oder verarbeitet tqsl nur einen Teil), markiert HAM-Tools keines der QSOs mehr als gesendet — bis 1.55 konnten dabei alle als hochgeladen gelten. Abgelehnte QSOs anhand der tqsl-Ausgabe korrigieren und die Auswahl erneut hochladen; bereits angenommene meldet LoTW dann als Duplikat.

»tqsl hat nach 180 s nicht geantwortet und wurde beendet« ab 1.56
→ HAM-Tools bricht einen hängenden tqsl-Aufruf nach 180 Sekunden ab. Internetverbindung und LoTW-Status prüfen, dann erneut hochladen.

eQSL/QRZ statt LoTW verwenden
→ siehe Einstellungen → Lookup & Upload. Jeder Service hat eigene Toggles, alle parallel möglich.

Was als Nächstes

• Erstes POTA-QSO loggen — falls noch nicht
• POTA-Modul und SOTA-Modul lesen LoTW- Confirmations automatisch für Award-Tracking
• ARRL DXCC + WAS + WAZ Awards können bei genug Confirmations direkt bei ARRL beantragt werden