FAQ — Häufige Fragen

Allgemein

Auf welchen Macs läuft HAM-Tools?

macOS 14 (Sonoma) oder neuer — getestet bis macOS 26 (Tahoe), also auch macOS 15 (Sequoia) und 26. Sowohl Apple Silicon (M1+) als auch Intel. Die App ist als Universal Binary gebaut.

Intel-Macs: mindestens Version 1.34.2

Ältere Versionen wurden versehentlich nur für Apple Silicon gebaut und starteten auf Intel-Macs gar nicht (»Diese App wird auf diesem Mac nicht unterstützt«). Ab 1.34.2 ist das behoben — einmalig das aktuelle DMG installieren, die eingebaute Update-Prüfung kann auf einer nie gestarteten App nicht greifen.

macOS 12 / 13 wird nicht unterstützt

Auf älteren Systemen erscheint „Du kannst diese Version des Programms nicht mit dieser Version von macOS verwenden". Grund: die App nutzt SwiftUI-APIs aus macOS 14 (MapKit-DSL, neue onChange-Signatur). macOS 14 ist ein kostenloses Apple-Update für alle Macs ab Baujahr 2018.

Brauche ich Internet?

Nein. Für DX-Cluster und POTA/SOTA-Spots ja, für alles andere (Logbuch, Rechner, Cabrillo-Export, CAT) nicht. Die Lizenz-Validierung läuft offline (signiert).

Wo liegen meine Daten?

~/Documents/HAM-Tools/:

• Logs/ — alle .htlog-Dateien (SQLite)
• Exports/ — ADIF + Cabrillo + Lizenz-Sicherungen
• Backups/ — automatische Sicherungen vor riskanten Aktionen
• Cache/ — Callbook-Cache + Spot-History
• Macros/ — SSB-Voice-Aufnahmen F1–F8
• Winlink/ — Postfach, Kontakte, Signaturen

Gibt es die App auf Englisch?

Ja, seit 1.12.0 ist die komplette Oberfläche auf Englisch übersetzt. Umschalten unter Einstellungen → Darstellung → Sprache (System / Deutsch / English) — wird live übernommen, kein Neustart nötig.

Lizenz

Was kann ich ohne Lizenz testen? (Demo-Modus)

Fast alles: Alle Module und Rechner sind offen, das Logging ist auf 50 QSOs kumulativ über alle Logs begrenzt. Danach schaltet das Logbuch auf Read-Only — alles bleibt lesbar und exportierbar (ADIF, Cabrillo), nur neues Loggen braucht dann die Lizenz. Ein Banner in der App zeigt jederzeit den Stand. Details: Lizenz aktivieren.

Wie bekomme ich eine Lizenz?

Mail an hb9hji@funkwelt.net mit Rufzeichen + Name. Du bekommst einen Lizenz-String zur Aktivierung in der App.

Was passiert nach 12 Monaten?

Deine aktuelle App-Version läuft weiter unbegrenzt. Nur App-Versionen, die nach deinem Update-Frist-Datum released werden, brauchen eine Update-Verlängerung (anfragen wie Erst-Lizenz).

Kann ich die Lizenz auf zwei Macs nutzen?

Ja, solange beide Macs dasselbe Callsign aus den lizenzierten Rufzeichen verwenden. Lizenz-String einfach auf beiden Macs einspielen.

Logbuch

Wo liegen meine Log-Files?

~/Documents/HAM-Tools/Logs/*.htlog. Sind reguläre SQLite-Datenbanken — kannst du mit jedem SQLite-Tool öffnen wenn du forensisch ran willst.

Wie sichere ich meine Logs?

Standard-Backup via Time Machine reicht. Plus ADIF-Export pro Log als Sekundär-Backup.

Kann ich alte Logs importieren?

Ja, ADIF-Import legt ein neues Log mit allen QSOs aus der Datei an.

QSO versehentlich gelöscht — Rückgängig?

Aktuell nicht direkt in der App. Aus dem Time-Machine-Backup oder per ADIF-Re-Import.

Funktioniert der Wavelog-Upload mit der DARC-Instanz?

Ja. Die App spricht die normale Wavelog-API — egal ob die Instanz selbst gehostet ist oder beim DARC läuft. In Einstellungen → Lookup & Upload → Wavelog die Instanz-URL und einen Read/Write-API-Key eintragen (in Wavelog unter Konto → API Keys erzeugen), »Verbindung testen« klicken und das Stations-Profil aus dem Menü wählen — fertig. URL-Varianten wie ein angehängtes /index.php erkennt die App selbst.

Contest

Welche Contests sind vorbereitet?

40 Templates — HF-DX (CQ-WW & CQ-WPX CW/SSB/RTTY, ARRL-DX CW/SSB, ARRL RTTY Roundup, IARU-HF, WAE-DX, DARC-WAG, DARC 10m, RUS-DX, All Asian DX, JIDX, REF, SAC, EU-HF-Champ, EUCW/UFT …), nationale HB-Conteste (Helvetia, Field Day, 50 MHz, NMD, Weihnachtswettbewerb, SEC) und der komplette VHF/UHF-Block (IARU R1 VHF/UHF, DARC-UKW, Helvetia-VHF, Marconi, AGCW, Alpe-Adria).

Werden alle Contests gewertet?

Ja — alle 40 Templates haben ein eigenes, reglementkonformes Scoring (Punkte + Multiplikatoren bzw. km-Distanz bei VHF/UHF), gemeinsam mit MacADIF über die Library ADIFCore. Die Engine ist noch in Erprobung und nicht für jeden Contest gegen offizielle Ergebnislisten gegengerechnet — Endpunktzahl vor einer Einreichung prüfen. Für die IARU-HF-Wertung muss die eigene CQ-/ITU-Zone in den Stations-Einstellungen gesetzt sein.

Kann ich eigene Contests definieren?

Aktuell nicht. Etappe 3 bringt einen User-Overlay-Folder für eigene contests.json-Einträge.

Wo landet der Cabrillo-Output?

~/Documents/HAM-Tools/Exports/<Contest-ID>-<Datum>.cbr. Beim Klick auf "Exportieren" auch direkt im Finder geöffnet.

CAT

Mein Radio wird nicht erkannt — Hilfe?

Häufigste Ursachen:

1. CI-V-Adresse falsch (bei ICOM) — Default im Settings, Radio-Menü prüfen
2. Port ist von einer anderen App belegt (WSJT-X, fldigi etc.) — die andere App schließen, oder besser »CAT teilen« nutzen (siehe nächste Frage), dann läuft beides parallel
3. USB-Kabel-Driver fehlt — FTDI-Driver installieren bei No-Name-Kabeln

Test mit dem "Hamlib Dummy-Rig"-Profil — wenn das verbindet, ist Hamlib OK; dann liegt's an der Hardware-Konfig.

PTT-Steuerung?

Ja — wird von den Contest-Macros F1–F8 für SSB-Wiedergabe genutzt: HAM-Tools setzt vor dem Audio-Start setPTT(true) und im onFinish- Callback setPTT(false). Funktioniert mit allen TRX-Profilen, die in trx-profiles.json supportsPTT: true haben (alle modernen ICOMs, Yaesus, Kenwoods, Elecrafts).

Wenn das nicht reicht (z.B. exotische TRX-Modelle): externes PTT- Interface via VOX oder Footswitch nutzen.

Kann ich HAM-Tools parallel mit WSJT-X (oder fldigi) nutzen?

Ja, seit 1.10.8 über »CAT teilen«: In Einstellungen → CAT den Schalter »rigctld für andere Programme offen halten« aktivieren. HAM-Tools hält dann seinen eingebauten Hamlib-Server lokal offen, an den sich WSJT-X & Co. parallel anhängen. In WSJT-X einstellen: Rig = Hamlib NET rigctl, Netzwerk-Server = 127.0.0.1:4532, PTT = CAT. Reihenfolge: erst in HAM-Tools »Start«, dann WSJT-X verbinden. Der Server bleibt offen, auch wenn du HAM-Tools' eigene CAT-Verbindung trennst — eine laufende WSJT-X-Session reißt nicht ab. Schaltest du im DX-Cluster zusätzlich »Band folgt TRX« ein, ziehen Spot-Liste, Karte und Filter bei einem WSJT-X-Bandwechsel automatisch mit.

Brauche ich WSJT-X für WSPR?

Nein. Das WSPR-Modul bringt Senden, Empfangen und Auswerten selbst mit (mehr). Der Decoder ist derselbe wie in WSJT-X (wsprd, mitgeliefert), aber du brauchst kein zweites Programm, keine Audio-Umleitung und keine zweite CAT-Verbindung.

Wer WSJT-X parallel für FT8 laufen lassen will, nutzt »CAT teilen« wie oben beschrieben. Gleichzeitig auf demselben Gerät senden können beide allerdings nicht — es gibt nur einen Sender.

Yaesu: Warum schaltet die TUN-Taste den Tuner aus statt zu tunen?

Die TUN-Pille schaltet nur den Tuner an/aus. Für einen echten Tuner-Abgleich gibt es seit 1.10.8 den separaten TUNE-Knopf (moderne Yaesu via AC002;). Bei Rigs ohne CAT-steuerbaren Tuner (FT-817/857/897) ist er ausgeblendet.

IC-705 über WLAN — brauche ich wfview oder kappanhang?

Nein. Seit 1.13.0 spricht HAM-Tools das Icom-Netzwerkprotokoll (RS-BA1) nativ: In Einstellungen → CAT beim »Weg«-Picker »IC-705 WLAN« wählen, Radio-IP + Network-User + Passwort eintragen, fertig. Frequenz, Mode, S-Meter, PTT und QSY laufen kabellos; Audio streamt HAM-Tools bewusst nicht (WSJT-X & Co. extern weiter nutzbar). Seit 1.29.1 verbindet sich die App bei WLAN-Verlust automatisch neu, seit 1.32 erkennt zusätzlich ein CI-V-Watchdog hängende Verbindungen (~10 s ohne Antwort) und baut die Verbindung neu auf. Anleitung: Tutorial: IC-705 über WLAN verbinden.

Kann ich HAM-Tools an einen bestehenden rigctld anhängen?

Ja, seit 1.13.0 über den Verbindungsweg »Netzwerk (rigctld)«: Host + Port eines bereits laufenden rigctld-Servers eintragen (z.B. von wfview/kappanhang, oft Port 4533) — HAM-Tools startet dann keinen eigenen Subprocess, sondern dockt an. Praktisch, wenn ein anderes Tool die Radio-Verbindung hält oder das Radio an einem Shack-PC im LAN hängt.

Mein Radio wird nicht erkannt — Detail-Anleitung?

→ Tutorial: CAT-Inbetriebnahme — von USB-Treiber-Check über TRX-Profil bis zur rigctld-Diagnose.

DX-Cluster

Warum verbindet sich DXHeat / DXSummit / DXWatch nicht?

Das sind Web-Aggregatoren — Webseiten, die Cluster-Spots sammeln und im Browser anzeigen. Sie bieten keinen Telnet-Zugang, deshalb bleibt der Verbindungsversuch hängen. HAM-Tools verbindet sich mit Telnet-Clustern (DX Spider, AR-Cluster, CC Cluster) — also mit denselben Quellen, aus denen auch diese Webseiten ihre Spots beziehen. Trage stattdessen einen Telnet-Node ein (z.B. den voreingestellten Funkwelt-DXSpider oder einen Node aus der ng3k.com-Liste); mehrere aktive Cluster werden automatisch dedupliziert.

Kann mich die App benachrichtigen, wenn eine DXpedition QRV wird?

Ja, seit 1.12.1: Im DX-Cluster gibt es den DXpeditions-Tab mit der NG3K-ADXO-Liste (~40 aktive und geplante Expeditionen). Pro Eintrag aktivierbar — wird eine überwachte DXpedition in ihrem QRV-Fenster gespottet, kommt eine macOS-Benachrichtigung und der Spot bekommt ein cyanfarbenes ✈-Symbol in Spot-Liste und Logbuch-DX-Tab. Details: DX-Cluster → DXpedition-Alerts.

Winlink

Was ist Winlink und brauche ich dafür Internet?

Winlink ist E-Mail über das Winlink-Netz — Nachrichten mit Betreff, Text und Anhängen, weltweit zustellbar. Über den Weg Internet (Telnet/CMS) braucht nur die eigene Station Internet, die Gegenseite nicht. Ab 1.34 kommen die Funk-Wege dazu (natives ARDOP, VARA) — dann geht es ganz ohne Internet. Details: Winlink-Modul.

Wo wird mein Winlink-Passwort gespeichert?

Ausschliesslich im macOS-Schlüsselbund — nie in Dateien oder Einstellungs-Exporten.

Warum kommt meine Testnachricht an mich selbst nicht an?

Das CMS betrachtet Nachrichten ans eigene Rufzeichen als sofort zugestellt — sie kommen nicht zurück. Zum Testen: eine Nachricht an den TEST-Bot senden (Auto-Antwort) oder von extern ans eigene Call schreiben (Betreff mit //WL2K beginnen, sonst greift der Spam-Schutz).

QSL-Services (QRZ / eQSL / Club Log / LoTW / Wavelog / HRDLOG)

Welche QSL-Services unterstützt HAM-Tools?

Sechs parallel: QRZ.com Live-Upload, eQSL.cc Auto-Upload, Club Log Live-Upload, LoTW via tqsl-Subprocess, Wavelog (ab 1.35) und HRDLOG.net (ab 1.46). Jeder mit eigenem Auto-Upload-Toggle + »QSL gesendet«-Auto-Mark. Konfiguration unter Einstellungen → Lookup & Upload.

Brauche ich für LoTW etwas Extra?

Ja, TQSL.app von der ARRL muss installiert sein (HAM-Tools darf TQSL aus Lizenzgründen nicht mitliefern). Volle Anleitung: Tutorial: LoTW-Pipeline einrichten.

Reise-Modus — alle Uploads pausieren?

In Einstellungen → Lookup & Upload gibt's ganz oben den Master-Toggle »Real-Time-Upload«. Wenn aus, sind ALLE Auto-Uploads (QRZ, eQSL, ClubLog, LoTW) pausiert. Nach dem Urlaub einschalten → Bulk-Upload aller offenen QSOs via Rechtsklick auf die Tabelle.

QSO-Bestätigungen ziehen?

QSL-Tab im Logbuch → Buttons »QRZ-Bestätigungen abrufen« bzw. »LoTW-Bestätigungen abrufen«. Confirmations werden gegen deine QSOs auf Call+Band+Mode+Datum gematched und als Confirmed markiert.

Contest — Macros, Multi-Op & Audio

F1–F8 Macros aufsetzen?

→ Tutorial: Contest mit F1–F8 Macros — CW-Templates, SSB-Voice-Aufnahmen, ICOM Voice-Keyer (V1–V4) bzw. Yaesu (V1–V5).

Mehrere Operatoren am gleichen Log?

→ Tutorial: Multi-Op-Contest.

Mikrofon-Permission verweigert

Beim ersten SSB-Aufnahme-Versuch fragt macOS nach Berechtigung. Falls verweigert: Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon → HAM-Tools-Häkchen setzen, App neu starten.

Update-System

Wie weiß ich, dass ein Update da ist?

Beim App-Start (max 1× / 24h) prüft die App automatisch ein signiertes JSON-Manifest auf toolbox.funkwelt.net/app/updates.json ab. Plus ⌘⌥U für manuellen Check.

Seit 1.14.0 installiert der Update-Dialog auf Wunsch direkt: „Jetzt installieren" lädt das DMG mit Fortschrittsbalken, prüft die SHA-256 aus dem signierten Manifest, tauscht die App aus und startet neu — „Im Browser laden" bleibt als Alternative.

Wie ist sichergestellt, dass das Update wirklich von HB9HJI kommt?

Das Update-Manifest ist Ed25519-signiert. Der Public-Key ist in der ausgelieferten App eingebacken — wenn jemand fremdes Manifest oder DMG-URL einschleust, schlägt die Signatur-Verifikation fehl und das Update wird verworfen.

»Kritische Updates«?

Manifest-Feld critical: true blockiert den »Überspringen«-Button im Update-Dialog. Wird nur für echte Sicherheits-/Crash-Hotfixes verwendet, nicht für jede Feature-Version.

Updates rückgängig machen?

Seit der Privacy-Bereinigung mit V1.9.7 werden ältere DMGs nicht mehr öffentlich vorgehalten — die enthielten hardcoded Autor-Defaults (HB9HJI als Cluster-Login, JN47PN als QTH-Locator) die bei Erstinstallation aktiv geworden wären. Wenn du einen Rollback brauchst (z.B. eine neue Version crashed), schick eine kurze Mail an bugs@funkwelt.net — die ältere Version kommt dann ad-hoc.

macOS-Sicherheit & Notarisierung

Beim ersten Öffnen: »HAM-Tools ist beschädigt«?

Tritt seit V1.9.0 nicht mehr auf — die App ist seitdem Apple- notarisiert (Developer-ID + Hardened Runtime + Notary-Ticket). Doppelklick öffnet die App direkt.

Wenn du eine ältere DMG hast und die Meldung kommt: Rechtsklick → »Öffnen« → »Trotzdem öffnen«, oder Terminal:

sudo xattr -dr com.apple.quarantine /Applications/HAM-Tools.app

Empfehlung: Auf aktuelle Version updaten.

Macht Gatekeeper / XProtect Probleme?

Sollte nicht — Notarisierung schließt das ab. Falls doch (z.B. Enterprise-Mac mit strenger MDM-Policy): Logs unter Konsole.app → "amfid" und Mail an bugs@funkwelt.net.

Mehr Fragen?

Bug melden bzw. Mail an bugs@funkwelt.net mit der Frage.