Document Changes

2026-04-07 16:57:22 +02:00 · 2026-04-04 12:12:41 +02:00
parent b3b7bc6a43
commit e4648b596f
4 changed files with 94 additions and 18 deletions
--- a/github_docs/de-Installation.md
+++ b/github_docs/de-Installation.md
@@ -46,7 +46,17 @@ Die aktuelle Version kann als AppImage heruntergeladen werden:

 **https://github.com/praktimarc/kst4contest/releases/latest**

-Der Dateiname hat das Format `praktiKST-v<Versionsnummer>-linux-x86_64.AppImage`.
+Der Dateiname hat das Format `KST4Contest-v<Versionsnummer>-linux-x86_64.AppImage`.
+
+### macOS
+
+> ⚠️ **Best-Effort-Support:** macOS-Builds werden als zusätzliche Option bereitgestellt, sind aber **nicht umfassend getestet**. Wir bauen und veröffentlichen macOS-Binaries mit jedem Release, können allerdings nicht alle Szenarien unter macOS testen. Bei Problemen freuen wir uns über eine Rückmeldung – wir versuchen unser Bestes, können aber nicht den gleichen Support-Umfang wie für Windows und Linux garantieren.
+
+Die aktuelle Version kann als DMG-Disk-Image heruntergeladen werden (für Apple-Silicon- und Intel-Macs verfügbar):
+
+**https://github.com/praktimarc/kst4contest/releases/latest**
+
+Der Dateiname hat das Format `KST4Contest-v<Versionsnummer>-macos-<Architektur>.dmg`, wobei `<Architektur>` entweder `arm64` (Apple Silicon) oder `x86_64` (Intel) ist.


 ---
@@ -64,11 +74,22 @@ Die Einstellungen werden unter `%USERPROFILE%\.praktikst\preferences.xml` gespei
 ### Linux
 1. AppImage herunterladen.
 2. AppImage in gewünschten Ordner entpacken.
-3. AppImage ausführbar machen (geht im Terminal mit `chmod +x praktiKST-v<Versionsnummer>-linux-x86_64.AppImage`)
+3. AppImage ausführbar machen (geht im Terminal mit `chmod +x KST4Contest-v<Versionsnummer>-linux-x86_64.AppImage`)
 4. AppImage ausführen.

 Die Einstellungen werden unter `~/.praktikst/preferences.xml` gespeichert.

+### macOS
+1. DMG-Datei für die eigene Architektur herunterladen (Apple Silicon oder Intel).
+2. DMG-Datei öffnen.
+3. `KST4Contest.app` in den **Programme**-Ordner ziehen.
+4. Beim ersten Start zeigt macOS ggf. eine Warnung, da die App nicht notarisiert ist. Zum Öffnen:
+   - Rechtsklick (oder Ctrl-Klick) auf `KST4Contest.app` im Finder → **Öffnen** wählen.
+   - Alternativ: **Systemeinstellungen → Datenschutz & Sicherheit** → **Trotzdem öffnen** klicken.
+5. KST4Contest aus dem Programme-Ordner oder dem Launchpad starten.
+
+Die Einstellungen werden unter `~/.praktikst/preferences.xml` gespeichert.
+
 ---

 ## Update
@@ -98,6 +119,12 @@ Derzeit folgendermaßen:
 2. neues AppImage ausführbar makieren
 3. (optional) altes AppImage löschen.

+#### macOS
+
+1. Neue DMG-Datei herunterladen.
+2. DMG öffnen.
+3. Die neue `KST4Contest.app` in den **Programme**-Ordner ziehen und die alte Version ersetzen.
+

 ---

--- a/github_docs/de-Log-Synchronisation.md
+++ b/github_docs/de-Log-Synchronisation.md
@@ -83,20 +83,26 @@ Für den integrierten DX-Cluster-Server: N1MM+ als DX-Cluster-Client konfigurier

 ### Win-Test

-Win-Test wird mit einem dedizierten UDP-Netzwerk-Listener unterstützt, der das native Win-Test Netzwerkprotokoll versteht. 
+Win-Test wird mit einem dedizierten UDP-Netzwerk-Listener unterstützt, der das native Win-Test Netzwerkprotokoll versteht.

 **Vorteile der Win-Test Integration:**
 - Automatische QSO-Synchronisation zur Markierung gearbeiteter Stationen.
- **Sked-Übergabe (ADDSKED):** Über den Button "Create sked" im Stationsinfo-Panel wird nicht nur in KST4Contest ein Sked angelegt, sondern dieses auch *direkt per UDP an das Win-Test Netzwerk als ADDSKED-Paket gesendet*.
+- **Sked-Übergabe (ADDSKED):** Über den Button "Create sked" im Stationsinfo-Panel wird nicht nur in KST4Contest ein Sked angelegt, sondern dieser auch *direkt per UDP an das Win-Test Netzwerk als ADDSKED-Paket gesendet* – automatisch, sobald der Listener aktiv ist.
 - Es kann zwischen den Sked-Modi "AUTO", "SSB" oder "CW" gewählt werden.
+- **Automatische QRG-Auflösung für SKEDs:** KST4Contest wählt die Sked-Frequenz intelligent:
+  1. Hat die Gegenstation in einer Chat-Nachricht ihre QRG genannt, wird diese verwendet.
+  2. Sonst wird die eigene aktuelle QRG verwendet (aus Win-Test STATUS oder manueller Eingabe).

-**Notwendige Einstellungen in KST4Contest:**
- `UDP-Port for Win-Test listener` (Standard: 9871).
+**Einstellungen im Reiter „Log-Synchronisation":**
 - `Receive Win-Test network based UDP log messages` aktivieren.
- `Win-Test sked transmission (push via ADDSKED to Win-Test network)` aktivieren.
+- `UDP-Port for Win-Test listener` (Standard: 9871).
 - `KST station name in Win-Test network (src of SKED packets)`: Legt fest, unter welchem Stationsnamen KST4Contest im WT-Netzwerk auftritt (z.B. "KST").
- `Win-Test station name filter`: Wenn hier ein Name eingetragen wird (z.B. "STN1"), werden nur QSOs von dieser bestimmten Win-Test Instanz verarbeitet. Leer lassen, um alle zu akzeptieren.
- `Win-Test network broadcast address`: Wird idR automatisch erkannt und ist erforderlich, um die Sked-Pakete ins Netzwerk zu senden.
+- `Win-Test network broadcast address`: Wird i.d.R. automatisch erkannt; erforderlich für das Senden von Sked-Paketen.
+
+**Einstellungen im Reiter „TRX-Synchronisation":**
+- `Win-Test STATUS QRG Sync`: Wenn aktiviert, übernimmt KST4Contest die aktuelle Transceiverfrequenz aus dem Win-Test STATUS-Paket als eigene QRG (MYQRG).
+- `Use pass frequency from Win-Test STATUS`: Statt der eigenen TRX-QRG wird die im STATUS-Paket enthaltene Pass-Frequenz als MYQRG verwendet (für Multi-Op-Setups, bei denen mit einer Pass-QRG gearbeitet wird).
+- `Win-Test station name filter`: Wird hier ein Name eingetragen (z.B. "STN1"), verarbeitet KST4Contest nur Pakete dieser Win-Test-Instanz. Leer lassen, um alle zu akzeptieren.

 **Einstellungen in Win-Test:**
 - Das Netzwerk in Win-Test muss aktiv sein.
@@ -112,6 +118,11 @@ Neben der QSO-Synchronisation übertragen UCXLog und andere Programme auch die *

 **Ergebnis**: Die eigene QRG muss im Chat nie mehr manuell eingegeben werden – ein Klick auf den MYQRG-Button oder die Verwendung der Variable im Beacon genügt.

+**Quellen für die eigene QRG (MYQRG):**
+- UCXLog, N1MM+, DXLog.net, QARTest via UDP-Port 12060
+- Win-Test STATUS-Paket (optional, konfigurierbar im Reiter „TRX-Synchronisation" unter „Win-Test STATUS QRG Sync")
+- Manuelle Eingabe im QRG-Feld
+
 > **Hinweis für Multi-Setup**: Bei zwei Logprogrammen an zwei Computern sollte nur **eines** die Frequenzpakete senden. KST4Contest kann nicht zwischen den Quellen unterscheiden und verarbeitet alle eingehenden Pakete.

 ---
--- a/github_docs/en-Installation.md
+++ b/github_docs/en-Installation.md
@@ -46,7 +46,17 @@ The latest version can be downloaded as an AppImage:

 **https://github.com/praktimarc/kst4contest/releases/latest**

-The filename has the format `praktiKST-v<version_number>-linux-x86_64.AppImage`.
+The filename has the format `KST4Contest-v<version_number>-linux-x86_64.AppImage`.
+
+### macOS
+
+> ⚠️ **Best-Effort Support:** macOS builds are provided as a convenience but are **not fully tested**. We build and release macOS binaries with every release, but we cannot test every scenario on macOS. If you encounter issues, please report them – we will do our best to address them, but cannot guarantee the same level of support as for Windows and Linux.
+
+The latest version can be downloaded as a DMG disk image (available for both Apple Silicon and Intel Macs):
+
+**https://github.com/praktimarc/kst4contest/releases/latest**
+
+The filename has the format `KST4Contest-v<version_number>-macos-<arch>.dmg`, where `<arch>` is `arm64` (Apple Silicon) or `x86_64` (Intel).


 ---
@@ -64,11 +74,22 @@ Settings are stored at `%USERPROFILE%\.praktikst\preferences.xml`.
 ### Linux
 1. Download the AppImage.
 2. Unzip the AppImage into a folder of your choice.
-3. Make the AppImage executable (in the terminal with `chmod +x praktiKST-v<version_number>-linux-x86_64.AppImage`)
+3. Make the AppImage executable (in the terminal with `chmod +x KST4Contest-v<version_number>-linux-x86_64.AppImage`)
 4. Run the AppImage.

 Settings are stored at `~/.praktikst/preferences.xml`.

+### macOS
+1. Download the DMG file for your architecture (Apple Silicon or Intel).
+2. Open the DMG file.
+3. Drag `KST4Contest.app` into your **Applications** folder.
+4. On first launch, macOS may show a warning because the app is not notarised. To open it:
+   - Right-click (or Control-click) on `KST4Contest.app` in Finder and choose **Open**.
+   - Alternatively, go to **System Settings → Privacy & Security** and click **Open Anyway**.
+5. Run KST4Contest from your Applications folder or Launchpad.
+
+Settings are stored at `~/.praktikst/preferences.xml`.
+
 ---

 ## Updating
@@ -98,6 +119,12 @@ Currently as follows:
 2. Mark the new AppImage as executable
 3. (optional) Delete the old AppImage.

+#### macOS
+
+1. Download the new DMG file.
+2. Open the DMG.
+3. Drag the new `KST4Contest.app` into your **Applications** folder, replacing the old version.
+

 ---

--- a/github_docs/en-Log-Sync.md
+++ b/github_docs/en-Log-Sync.md
@@ -87,16 +87,22 @@ Win-Test is supported with a dedicated UDP network listener that understands the

 **Advantages of Win-Test Integration:**
 - Automatic QSO synchronization to mark worked stations.
- **Sked Handover (ADDSKED):** Using the "Create sked" button in the station info panel not only creates a sked in KST4Contest but also *sends it directly via UDP to the Win-Test network as an ADDSKED packet*.
+- **Sked Handover (ADDSKED):** Using the "Create sked" button in the station info panel not only creates a sked in KST4Contest but also *sends it directly via UDP to the Win-Test network as an ADDSKED packet* – automatically, as soon as the listener is active. No separate toggle is needed.
 - You can choose between "AUTO", "SSB", or "CW" sked modes.
+- **Automatic QRG resolution for SKEDs:** KST4Contest selects the sked frequency intelligently:
+  1. If the other station mentioned their QRG in a recent chat message, that frequency is used.
+  2. Otherwise, your own current QRG is used (from Win-Test STATUS or manual entry).

-**Required Settings in KST4Contest:**
- `UDP-Port for Win-Test listener` (Default: 9871).
+**Settings in the "Log Synchronisation" tab:**
 - Enable `Receive Win-Test network based UDP log messages`.
- Enable `Win-Test sked transmission (push via ADDSKED to Win-Test network)`.
- `KST station name in Win-Test network (src of SKED packets)`: Defines the station name KST4Contest uses in the WT network (e.g., "KST").
- `Win-Test station name filter`: If a name is entered here (e.g., "STN1"), only QSOs from that specific Win-Test instance will be processed. Leave empty to accept all.
- `Win-Test network broadcast address`: Is usually detected automatically and is required to send sked packets to the network.
+- `UDP-Port for Win-Test listener` (default: 9871).
+- `KST station name in Win-Test network (src of SKED packets)`: Defines the station name KST4Contest uses in the WT network (e.g. "KST").
+- `Win-Test network broadcast address`: Usually detected automatically; required to send sked packets to the network.
+
+**Settings in the "TRX Synchronisation" tab:**
+- `Win-Test STATUS QRG Sync`: When enabled, KST4Contest takes the current transceiver frequency from the Win-Test STATUS packet and uses it as your own QRG (MYQRG).
+- `Use pass frequency from Win-Test STATUS`: Instead of the main TRX frequency, the pass frequency contained in the STATUS packet is used as MYQRG (useful for multi-op setups that operate with a dedicated pass QRG).
+- `Win-Test station name filter`: If a name is entered here (e.g. "STN1"), KST4Contest only processes packets from that specific Win-Test instance. Leave empty to accept all.

 **Settings in Win-Test:**
 - The network in Win-Test must be active.
@@ -112,6 +118,11 @@ In addition to QSO synchronisation, UCXLog and other programs also transmit the

 **Result**: Your own QRG never needs to be typed manually in the chat – clicking the MYQRG button or using the variable in the beacon is sufficient.

+**Sources for your own QRG (MYQRG):**
+- UCXLog, N1MM+, DXLog.net, QARTest via UDP port 12060
+- Win-Test STATUS packet (optional, configurable in the "TRX Synchronisation" tab under "Win-Test STATUS QRG Sync")
+- Manual entry in the QRG field
+
 > **Note for multi-setup**: With two logging programs on two computers, only **one** should send frequency packets. KST4Contest cannot distinguish between sources and processes all incoming packets.

 ---