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.

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
• Cache/ — Callbook-Cache + Spot-History

Lizenz

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.

Contest

Welche Contests sind vorbereitet?

14 Templates: HB-Helvetia, USKA Field Day SSB/CW, USKA 50 MHz, CQ-WW CW/SSB, CQ-WPX CW/SSB, ARRL-DX CW/SSB, IARU-HF, DARC-WAG, WAE-DX CW/SSB.

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

Mein Radio wird nicht erkannt — Detail-Anleitung?

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

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

Welche QSL-Services unterstützt HAM-Tools?

Vier parallel: QRZ.com Live-Upload, eQSL.cc Auto-Upload, Club Log Live-Upload und LoTW via tqsl-Subprocess. 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

Welche Contests sind vorbereitet?

14 Templates: HB-Helvetia, USKA Field Day SSB/CW, USKA 50 MHz, CQ-WW CW/SSB, CQ-WPX CW/SSB, ARRL-DX CW/SSB, IARU-HF, DARC-WAG, WAE-DX CW/SSB.

F1–F8 Macros aufsetzen?

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

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.

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.