ARRL TQSL CORE v2.8.6 · EMBEDDED LoTW · QRZ · CLUB LOG CLI /opt/homebrew/bin/tqsl
v1.5.3 · Build 122 Official ARRL TQSL Engine Inside

TrustedQSL,
reborn for macOS.

Say goodbye to twenty-year-old wxWidgets dialogs and browser tab juggling. True QSL pairs the official ARRL tqsl cryptographic core with a native SwiftUI Operator Desk — uniting LoTW, QRZ.com, and Club Log signing, durable confirmation sync, live WSJT-X UDP capture, and a drop-in CLI bridge.

macOS 14.0+ (Sonoma & Sequoia) · Apple Silicon (arm64) · 24.9 MB · GPLv2 Open Source

Verify SHA-256 checksum & package details
1697b73b94bcf71bbe9d6783d95d2022077e21a0557606a2dd26fa0ac0385fef

Archive: TrueQSL-1.5.3-build122-macOS-arm64.zip · Ad-hoc signed bundle with embedded ARRL TQSL Core v2.8.6 (tqsl-engine & libtqsllib.dylib). version.json · SHA256SUMS

True QSL app icon
CRYPTOGRAPHIC PIPELINE

One-Click Sign, Upload & Reconcile

Bit-for-bit ARRL LoTW compliance with Apple Keychain security.

01 · INGEST & WATCH Live UDP 2237 & Log Watchers

WSJT-X · JTDX · Lab599 Utility · SDR-Control · MacLoggerDX · ADIF

02 · PREFLIGHT & SIGN Review-First ADIF + Official TQSL v2.8.6 Core

Station/DXCC/UTC certificate check · PKCS#12 Keychain · uploaded.db guard

03 · SYNC & CONFIRM LoTW · QRZ.com · Club Log + Evidence Replay

Durable upload queue · Paged QRZ & LoTW receipt inventory · DXCC/WAS/VUCC

v2.8.6 Embedded Official ARRL TQSL Core
19,800+ QSOs Zero-Lag Native Logbook & Audit
3 Clouds LoTW, QRZ.com & Club Log Queue
146 Tests Automated Verification Suite

Core Architecture

Every link between your rig and your confirmations.

Engineered to replace fragmented utilities with one cohesive, auditable macOS workflow.

01 · OFFICIAL CRYPTOGRAPHY

Review-First Multi-Cloud Signing

Embeds the official ARRL TQSL v2.8.6 engine alongside Apple Security.framework PKCS#12 import. Every ADIF contact is validated for station callsign, DXCC, UTC date coverage, and mode before signing to LoTW, QRZ.com, and Club Log.

  • Embedded tqsl-engine
  • Durable Upload Queue
  • .tq8 Export
02 · NEW IN v1.5.2 & v1.5.3

Visible Confirmation Sync & Replay

Independent LoTW and paged QRZ (250-record cursor) confirmation sync with live progress and cancellation. Replays matched confirmation evidence without overwriting local edits or tripping over legacy Unicode scalar-length fields.

  • 4,055-Record Cache Verified
  • Zero Metadata Conflicts
  • LoTW + QRZ Badges
03 · REAL-TIME INGESTION

UDP 2237 Listener & Log Watchers

Intercepts binary Log QSO (Type 5) and decode packets from WSJT-X and JTDX with zero disk lag, plus automatic file watchers for Lab599 Utility, SDR-Control (iCloud), and MacLoggerDX.

  • Port 2237 UDP
  • Lab599 TX-500 Ready
  • Auto-LoTW Option
04 · DROP-IN CLI BRIDGE

/opt/homebrew/bin/tqsl Replacement

Point MacLoggerDX, RUMlogNG, WSJT-X, Cloudlog, N1MM, or Aether directly at True QSL. Enforces shared ADIF preflight validation and explicit station selection (-l) while returning standard exit codes.

  • Drop-In Symlink
  • Preflight Guarded
  • Shared uploaded.db
05 · LIVE DX & AUTOMATION

Wait & Pounce + DX Cluster Telnet

Hunt needed DXCC entities and Maidenhead grids on FT8/FT4 with clear audio gap detection and a Halt-TX safety watchdog, or connect to global Telnet DX Clusters with instant ATNO highlighting.

  • WSJT-X Type 4 Reply
  • Watchdog Protected
  • Telnet Spot Filter
06 · GEOGRAPHY & AWARDS

World Map, Awards & QRZ Rank

Plot contacts on a native MapKit 3D globe with geodesic great-circle paths, solar grayline, and live NOAA SFI/K-index telemetry — and track DXCC, WAS, Triple Play, VUCC, WAZ, and QRZ.com leaderboards.

  • MapKit 3D Globe
  • DXCC / WAS / VUCC
  • NOAA Space Weather

Introduced in v1.5 · Operator Desk

Ten precision workflows for serious log hygiene.

From auditing your own LoTW server receipt inventory to previewed 1,000-contact bulk edits with guarded undo.

TQ-025 → TQ-034 Implemented
01 · LoTW Receipt Inventory

Compare local logs against your own ARRL LoTW report with separate queued, submitted, received, and QSL states.

02 · Aged QSL Follow-Up

Configurable worklist of unconfirmed contacts by age and receipt state; QRZ confirmation never masks missing LoTW.

03 · Paused Correction Queue

Field-by-field comparison and destination-specific review; never implicitly replaces or deletes remote QRZ records.

04 · Station & Date Profiles

Separate callsign, UTC date range, and Keychain namespaces with overlap prevention and combined read-only browsing.

05 · Certificate Reminders

Configurable UTC expiration thresholds, missing-key/pending alerts, historical coverage checks, and ARRL renewal guidance.

06 · Explicit Award Evidence

Track reported award credits and operator document references while keeping worked, QSL, and credit states distinct.

07 · Guarded Bulk Editor

Preview up to 1,000 contact edits with mandatory reason, durable checkpoint, atomic commit, and restart-safe undo.

08 · Scheduled .tqbackup

Opt-in versioned profile backups while open, with checksum verification and unfinished-upload quarantine on restore.

09 · AND / OR Smart Folders

Profile-owned saved queries across any retained ADIF field, with full Unicode and Gregorian UTC date precision.

10 · Per-Contact Audit Trail

Immutable submission snapshots, import decisions, edit checkpoints, and per-contact JSON history export.

Why Upgrade?

True QSL vs. Legacy TrustedQSL.

Same official ARRL cryptographic core underneath — generations ahead at the desk.

Capability True QSL v1.5.3 Legacy ARRL TrustedQSL Manual Browser Uploads
User interface & framework Native Swift, SwiftUI & AppKit Legacy C++ wxWidgets Separate web portals
ARRL LoTW cryptographic engine Official ARRL TQSL v2.8.6 embedded Official ARRL TQSL v2.8.x Requires external TQSL first
Multi-cloud upload queue LoTW + QRZ.com + Club Log (durable) LoTW only Manual file upload per site
Pre-signing QSO inspector & editor 19,800+ QSO logbook + Import Review Blind signing only None prior to upload
Confirmation sync & evidence replay Independent LoTW + paged QRZ merge None Manual ADIF download/import
Live WSJT-X / JTDX & Lab599 integration UDP Port 2237 + Auto file watchers None None
Drop-in /opt/homebrew/bin/tqsl CLI Included with preflight validation Manual path setup Not applicable

Engineering Transparency

Verified behavior & operating boundaries.

Documented test coverage and safety rules for your certificates and logbook.

146 Automated Tests Passing

Validated with swift test across 146 unit and regression suites — covering 10,000-contact inventory audits, Unicode scalar/byte ADIF boundaries, multi-page QRZ cursors, historical-fingerprint evidence replay, and guarded bulk-edit undo.

Read-Only Inventory & Paused Corrections

LoTW receipt checks and confirmation sync are strictly download/merge operations and never upload contacts or submit paid award applications. Correction jobs start paused; confirmed QRZ match-field changes require website review rather than implicit replacement.

Keychain Secrets & .tqbackup Archives

LoTW, QRZ, and Club Log credentials stay in macOS Keychain and are redacted from logs. Verified .tqbackup archives include private keys and are unencrypted so you can recover your station identity — store backup files securely.

Latest Release · v1.5.3 (Build 122)

Ready for your next confirmation.

Extract the ZIP, move True QSL.app to /Applications, and optionally link the drop-in CLI for third-party loggers.

# Optional: link True QSL as your drop-in tqsl CLI for MacLoggerDX, RUMlogNG & WSJT-X
ln -sfn "/Applications/True QSL.app/Contents/MacOS/TrueQSL" /opt/homebrew/bin/tqsl