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
• Audio/ — reservierter Audio-Ordner
• Winlink/ — Postfach, Kontakte, Signaturen

Die SSB-Voice-Aufnahmen F1–F8 liegen ausserhalb davon unter ~/Library/Application Support/HAM-Tools/Macros/Contest/ — Einstellungen → Daten → Voice-Keyer öffnet den Ordner.

Gibt es die App auf Englisch?

Ja, HAM-Tools unterstützt Deutsch und Englisch. Version 1.54.0 ergänzt englische Dialoge und Rechner-Fachtexte. Umschalten unter Einstellungen → Darstellung → Sprache (System / Deutsch / English), danach die App neu starten. Die Web-Toolbox hat einen eigenen DE/EN-Schalter; dieser wirkt sofort und erhält die Eingaben.

Lizenz

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

Fast alles: Alle Module und Rechner sind offen, das Loggen neuer QSOs ist auf 50 QSOs kumulativ über alle Logs begrenzt. Danach braucht neues Loggen die Lizenz — vorhandene QSOs bleiben lesbar, bearbeitbar und exportierbar (ADIF, Cabrillo), und der ADIF-Import bestehender Logs bleibt unbegrenzt, damit du deine Daten vor dem Entscheid komplett übernehmen kannst. 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. Solange HAM-Tools als Beta läuft, ist die Lizenz kostenlos.

Was passiert nach 12 Monaten?

Deine aktuelle App-Version läuft weiter unbegrenzt. Nur App-Versionen, die nach deinem Update-Frist-Datum gebaut 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. Beim ADIF-Import kannst du nur neue QSOs ins Ziellog übernehmen, alle QSOs importieren oder ein neues Log anlegen. Die Vorschau zeigt mögliche Duplikate anhand von Rufzeichen, Band, Mode und höchstens fünf Minuten Zeitabweichung.

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?

Ja. Eigene Vorlagen liegen als JSON-Dateien im Ordner Contests des Datenordners (~/Documents/HAM-Tools/Contests/). Unter Einstellungen → Daten → Contest-Vorlagen öffnest du die Beispieldatei, sicherst sie unter neuem Namen und passt ID, Name und Exchange-Felder an. Mit scoringLike übernimmt die Vorlage die Wertung eines mitgelieferten Contests, sonst zählt jedes QSO einen Punkt. Details im Contest-Modul.

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 schliessen, 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 reisst 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

Wo ist das bisherige DX-Cluster-Modul?

Seit 1.52.0 liegt die Bedienung unter Logbuch → DXClusters. Die alte Modulansicht entfällt; separate Cluster-, Bandmap- und Terminalfenster bleiben im Menü Fenster. Module blendet die gemeinsame Modulnavigation ein oder aus.

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 weiss 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.

Welche Version ist aktuell, ohne die App zu starten?

Der Changelog zeigt zuoberst die aktuelle Version mit Datum. Maschinenlesbar und ohne Signatur-Umschlag gibt es dieselben Angaben unter toolbox.funkwelt.net/app/latest.json (Version, Build-Datum, DMG-Link, SHA-256, Release-Notes DE/EN, Link in den Changelog). Alle DMGs ab 1.10.0 liegen unter /app/dmg/. Die App selbst prüft weiterhin nur das signierte updates.json.

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?

Ältere Versionen ab 1.10.0 liegen unter toolbox.funkwelt.net/app/dmg/ — mit einer gültigen Lizenz bleiben sie lebenslang nutzbar. Versionen vor 1.10.0 sind nicht mehr verfügbar (Privacy-Bereinigung mit V1.9.7: sie enthielten Autor-Defaults, die bei Erstinstallation aktiv geworden wären). Crasht eine neue Version bei dir, melde das bitte zusätzlich an bugs@funkwelt.net.

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 schliesst 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.