diff --git a/github_docs/de-Installation.md b/github_docs/de-Installation.md index 81186b2..2570f0c 100644 --- 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-linux-x86_64.AppImage`. +Der Dateiname hat das Format `KST4Contest-v-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-macos-.dmg`, wobei `` 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-linux-x86_64.AppImage`) +3. AppImage ausführbar machen (geht im Terminal mit `chmod +x KST4Contest-v-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. + --- diff --git a/github_docs/de-Log-Synchronisation.md b/github_docs/de-Log-Synchronisation.md index 8bc78ff..0fb98f4 100644 --- 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. --- diff --git a/github_docs/en-Installation.md b/github_docs/en-Installation.md index 7fa8fb1..a1115a2 100644 --- 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-linux-x86_64.AppImage`. +The filename has the format `KST4Contest-v-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-macos-.dmg`, where `` 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-linux-x86_64.AppImage`) +3. Make the AppImage executable (in the terminal with `chmod +x KST4Contest-v-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. + --- diff --git a/github_docs/en-Log-Sync.md b/github_docs/en-Log-Sync.md index 7e432e7..85ea0ed 100644 --- 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. ---