diff --git a/github_docs/Home.md b/github_docs/Home.md index 73ed814..4352b32 100644 --- a/github_docs/Home.md +++ b/github_docs/Home.md @@ -48,6 +48,6 @@ Entwickelt von **DO5AMF (Marc Fröhlich)**, Operator bei DM5M. ## Schnellinfo / Quick Info -- **Download**: https://do5amf.funkerportal.de/ +- **Download**: https://github.com/praktimarc/kst4contest/releases - **GitHub**: https://github.com/praktimarc/kst4contest - **Kontakt / Contact**: praktimarc+kst4contest@gmail.com diff --git a/github_docs/as_plane_feed_1.png b/github_docs/as_plane_feed_1.png new file mode 100644 index 0000000..08e28e5 Binary files /dev/null and b/github_docs/as_plane_feed_1.png differ diff --git a/github_docs/as_plane_feed_2.png b/github_docs/as_plane_feed_2.png new file mode 100644 index 0000000..be35ea1 Binary files /dev/null and b/github_docs/as_plane_feed_2.png differ diff --git a/github_docs/as_plane_feed_3.png b/github_docs/as_plane_feed_3.png new file mode 100644 index 0000000..65f47d5 Binary files /dev/null and b/github_docs/as_plane_feed_3.png differ diff --git a/github_docs/as_plane_feed_4.png b/github_docs/as_plane_feed_4.png new file mode 100644 index 0000000..74ffa8f Binary files /dev/null and b/github_docs/as_plane_feed_4.png differ diff --git a/github_docs/client_settings_window_logsync.png b/github_docs/client_settings_window_logsync.png new file mode 100644 index 0000000..41e782e Binary files /dev/null and b/github_docs/client_settings_window_logsync.png differ diff --git a/github_docs/client_settings_window_station.png b/github_docs/client_settings_window_station.png new file mode 100644 index 0000000..312fa19 Binary files /dev/null and b/github_docs/client_settings_window_station.png differ diff --git a/github_docs/de-AirScout-Integration.md b/github_docs/de-AirScout-Integration.md index 92c61cb..9babdc4 100644 --- a/github_docs/de-AirScout-Integration.md +++ b/github_docs/de-AirScout-Integration.md @@ -32,6 +32,8 @@ Für diesen Dienst ist ein Account erforderlich. Bitte eine Spende für Thomas i 1. AirScout starten. 2. In den AirScout-Einstellungen den OV3T-Feed-Account eintragen (Benutzername, Passwort, URL). +![AirscoutSchritt1](as_plane_feed_1.png) +![AirscoutSchritt2](as_plane_feed_2.png) 3. Verbindung testen. ### Schritt 2: UDP-Kommunikation für KST4Contest aktivieren @@ -46,6 +48,9 @@ In AirScout die UDP-Schnittstelle aktivieren: In den KST4Contest-Preferences → **AirScout Settings**: - AirScout-Kommunikation aktivieren - IP und Port auf Standardwerte lassen (sofern nicht geändert) +![AirscoutSchritt3](as_plane_feed_3.png) + + --- diff --git a/github_docs/de-Changelog.md b/github_docs/de-Changelog.md index 2215108..cd6b83b 100644 --- a/github_docs/de-Changelog.md +++ b/github_docs/de-Changelog.md @@ -6,6 +6,8 @@ Versionsverlauf von KST4Contest / PraktiKST. --- +letzter Changelog bitte aus GitHub entnehmen. Der bisherige Changelog + ## v1.263 (2025-06-08) **AirScout-Kommunikation und Login-Name** diff --git a/github_docs/de-Home.md b/github_docs/de-Home.md index 75b7cb5..a383643 100644 --- a/github_docs/de-Home.md +++ b/github_docs/de-Home.md @@ -42,7 +42,7 @@ Der ON4KST-Chat ist der De-facto-Standard für Skeds auf den 144-MHz-und-höher- - **E-Mail**: praktimarc+kst4contest@gmail.com *(nur für kst4contest-Themen)* - **GitHub**: https://github.com/praktimarc/kst4contest -- **Download**: https://do5amf.funkerportal.de/ +- **Download**: https://github.com/praktimarc/kst4contest/releases/latest --- diff --git a/github_docs/de-Installation.md b/github_docs/de-Installation.md index 0f79300..147bd66 100644 --- a/github_docs/de-Installation.md +++ b/github_docs/de-Installation.md @@ -4,10 +4,6 @@ ## Voraussetzungen -### Java - -KST4Contest ist eine Java-Anwendung. Es wird eine aktuelle **Java Runtime Environment (JRE)** benötigt. Die empfohlene Version ist Java 17 oder höher. - ### ON4KST-Account Um den Chat zu nutzen, ist ein registrierter Account beim ON4KST-Chat-Dienst erforderlich: @@ -34,21 +30,42 @@ Bei starkem Chat-Verkehr (5–6 Nachrichten pro Sekunde im Contest) gehen öffen ## Download +### Windows + Die aktuelle Version kann als ZIP-Datei heruntergeladen werden: -**https://do5amf.funkerportal.de/** +**https://github.com/praktimarc/kst4contest/releases/latest** + +Der Dateiname hat das Format `praktiKST-v-windows-x64.zip `. + +### Linux + +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.zip`. --- ## Installation +### Windows + 1. ZIP-Datei herunterladen. 2. ZIP-Datei in einen gewünschten Ordner entpacken. -3. `praktiKST.exe` (Windows) bzw. das entsprechende Start-Skript ausführen. +3. `praktiKST.exe` ausführen. -Die Einstellungen werden unter `%USERPROFILE%\.praktikst\preferences.xml` (Windows) gespeichert. +Die Einstellungen werden unter `%USERPROFILE%\.praktikst\preferences.xml` gespeichert. + +### 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`) +4. AppImage ausführen. + +Die Einstellungen werden unter `~/.praktikst/preferences.xml` gespeichert. --- @@ -59,8 +76,12 @@ KST4Contest enthält einen **automatischen Update-Hinweis-Dienst**: Sobald eine - einem Changelog, - dem Download-Link zur neuen Version. +![Beispiel Update Fenster](update_window.png) + ### Update-Prozess +#### Windows + Derzeit gibt es nur einen Weg zum Aktualisieren: 1. Den alten Ordner löschen. @@ -68,6 +89,14 @@ Derzeit gibt es nur einen Weg zum Aktualisieren: Die Einstellungsdatei (`preferences.xml`) bleibt erhalten, da sie im Benutzerordner gespeichert ist – nicht im Programmordner. +#### Linux + +Derzeit folgendermaßen: +1. neues AppImage herunterladen +2. neues AppImage ausführbar makieren +3. (optional) altes AppImage löschen. + + --- ## Bekannte Probleme beim Start diff --git a/github_docs/de-Konfiguration.md b/github_docs/de-Konfiguration.md index 7da6fbd..cf64137 100644 --- a/github_docs/de-Konfiguration.md +++ b/github_docs/de-Konfiguration.md @@ -4,11 +4,18 @@ Nach dem ersten Start öffnet sich das **Einstellungsfenster** – dieses ist der zentrale Ausgangspunkt für alle Konfigurationen. Es empfiehlt sich, das Einstellungsfenster während des Betriebs geöffnet zu lassen (z. B. um den Beacon schnell ein- und auszuschalten). -> **Wichtig**: Nach jeder Änderung unbedingt **„Save Settings"** klicken! Die Einstellungen werden in `~/.praktikst/preferences.xml` gespeichert. Ab v1.21 werden auch Fenstergrößen und Divider-Positionen beim Speichern gesichert. +> **Wichtig**: Nach jeder Änderung unbedingt **„Save Settings"** klicken! Die Einstellungen werden unter Linux in `~/.praktikst/preferences.xml` und unter Windows in `%USERPROFILE%\.praktikst\preferences.xml` (bzw. `C:\Users\\.praktikst\preferences.xml`) gespeichert. Ab v1.21 werden auch Fenstergrößen und Divider-Positionen beim Speichern gesichert. --- ## Station Settings (Stationseinstellungen) +![Stationseinstellungen](client_settings_window_station.png) +### Login und Chat-Kategorien + +Hier werden die Zugangsdaten für den ON4KST-Chat eingetragen (Rufzeichen und Passwort). +Zudem wird die **primäre Chat-Kategorie** (z. B. IARU Region 1 VHF/Microwave) ausgewählt. + +Mit der Option für einen **zweiten Chat** (Multi-Channel-Login) kann man sich gleichzeitig in eine weitere Kategorie (z. B. UHF/SHF) einloggen. Beide Chats werden dann parallel überwacht. Hier kann optional auch ein abweichender Login-Name für den zweiten Chat vergeben werden (nützlich für Opposite Station Multi-Callsign Logging). ### Rufzeichen und Locator @@ -32,7 +39,7 @@ Maximale Entfernung (in km), für die Richtungs-Warnungen ausgelöst werden soll ## Log-Sync-Einstellungen -Zwei Methoden stehen zur Verfügung, um gearbeitete Stationen automatisch zu markieren. Details: [Log-Synchronisation](de-Log-Synchronisation). +Drei Methoden stehen zur Verfügung, um gearbeitete Stationen automatisch zu markieren. Details: [Log-Synchronisation](de-Log-Synchronisation). ### Universal File Based Callsign Interpreter (Simplelogfile) @@ -40,7 +47,11 @@ Interpretiert beliebige Log-Dateien per Regex nach Rufzeichen-Mustern. Keine Ban ### Netzwerk-Listener für QSO-UDP-Broadcast -**Empfohlene Methode.** KST4Contest hört auf UDP-Pakete, die das Logprogramm beim Speichern eines QSOs an die Broadcast-Adresse sendet. Die Stationen werden mit Bandinformation markiert. UDP-Port: Standard **12060**. +**Empfohlene Methode.** KST4Contest hört auf UDP-Pakete, die das Logprogramm beim Speichern eines QSOs an die Broadcast-Adresse sendet. Die Stationen werden mit Bandinformation markiert. UDP-Port: Standard **12060**. (Wird z. B. von UCXLog, N1MM+, QARTest, DXLog.net genutzt). + +### Win-Test Network-Listener (Zusätzlicher UDP-Listener) + +Dedizierter Netzwerk-Erkenner für Win-Test. KST4Contest empfängt und verarbeitet Win-Test-spezifische UDP-Pakete (inkl. Sked-Übergabe) auf dem dafür konfigurierten Port. --- @@ -130,6 +141,6 @@ Umschaltbar über das Menü: **Window → Use Dark Mode**. Die Farben können ü Nach **jeder** Änderung **„Save Settings"** klicken! Ohne Speichern gehen alle Änderungen beim nächsten Start verloren. -- Speicherort: `~/.praktikst/preferences.xml` +- Speicherort: unter Linux `~/.praktikst/preferences.xml` und unter Windows `%USERPROFILE%\.praktikst\preferences.xml` (bzw. `C:\Users\\.praktikst\preferences.xml`) - Ab v1.21: Fenstergrößen und Divider-Positionen werden ebenfalls gespeichert. - Bei Problemen: Konfigurationsdatei löschen → KST4Contest erstellt eine neue mit Standardwerten. diff --git a/github_docs/de-Log-Synchronisation.md b/github_docs/de-Log-Synchronisation.md index 30fe9ba..8a76a8d 100644 --- a/github_docs/de-Log-Synchronisation.md +++ b/github_docs/de-Log-Synchronisation.md @@ -5,6 +5,7 @@ KST4Contest markiert gearbeitete Stationen automatisch in der Chat-Benutzerliste. Dafür gibt es zwei grundlegende Methoden: --- +![Log-Synchronisation Einstellungsfenster](client_settings_window_logsync.png) ## Methode 1: Universal File Based Callsign Interpreter (Simplelogfile) @@ -32,6 +33,7 @@ Das Logprogramm sendet beim Speichern eines QSOs ein UDP-Paket an die Broadcast- ## Unterstützte Logprogramme ### UCXLog (DL7UCX) +![UCXLog Konfiguration](ucxlog_logsync.png) UCXLog sendet QSO-UDP-Pakete und Transceiver-Frequenzpakete. @@ -46,6 +48,8 @@ Hinweis für Multi-Setup (2 Computer, 2 Radios, eine KST4Contest-Instanz): Beide ### QARTest (IK3QAR) +![QARTest Konfiguration](qartest_logsync.png) + **Besonderheit**: QARTest kann das **vollständige Log** an KST4Contest senden (Schaltfläche „Invia log completo" in den QARTest-Einstellungen). Damit werden auch QSOs erfasst, die vor dem Start von KST4Contest geloggt wurden. **Einstellungen in QARTest:** @@ -68,14 +72,33 @@ Für den integrierten DX-Cluster-Server: N1MM+ als DX-Cluster-Client konfigurier ### DXLog.net +![DXLog.net Konfiguration](dxlog_net_logsync.png) + **Einstellungen in DXLog.net:** - UDP-Broadcast aktivieren - IP des KST4Contest-Computers eintragen (grün markierte Felder) - Port: 12060 -### WinTest +### Win-Test -WinTest wird ebenfalls unterstützt. KST4Contest empfängt WinTest-UDP-Pakete über einen dedizierten Listener. Die Konfiguration erfolgt analog zu den anderen Programmen. +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*. +- Es kann zwischen den Sked-Modi "AUTO", "SSB" oder "CW" gewählt werden. + +**Notwendige Einstellungen in KST4Contest:** +- `UDP-Port for Win-Test listener` (Standard: 9871). +- `Receive Win-Test network based UDP log messages` aktivieren. +- `Win-Test sked transmission (push via ADDSKED to Win-Test network)` aktivieren. +- `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. + +**Einstellungen in Win-Test:** +- Das Netzwerk in Win-Test muss aktiv sein. +- Win-Test muss so konfiguriert sein, dass es seine Broadcasts an den entsprechenden Port (Standard 9871) sendet bzw. empfängt. --- @@ -83,6 +106,8 @@ WinTest wird ebenfalls unterstützt. KST4Contest empfängt WinTest-UDP-Pakete ü Neben der QSO-Synchronisation übertragen UCXLog und andere Programme auch die **aktuelle Transceiverfrequenz** via UDP. KST4Contest verarbeitet diese Information und stellt sie als Variable `MYQRG` bereit. +![FrequenzButtons](qrg_buttons.png) + **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. > **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/dxlog_net_logsync.png b/github_docs/dxlog_net_logsync.png new file mode 100644 index 0000000..feba0ef Binary files /dev/null and b/github_docs/dxlog_net_logsync.png differ diff --git a/github_docs/en-Home.md b/github_docs/en-Home.md index 214e4e4..695b93f 100644 --- a/github_docs/en-Home.md +++ b/github_docs/en-Home.md @@ -42,7 +42,7 @@ The ON4KST Chat is the de-facto standard for skeds on the 144 MHz and higher ban - **Email**: praktimarc+kst4contest@gmail.com *(for kst4contest topics only)* - **GitHub**: https://github.com/praktimarc/kst4contest -- **Download**: https://do5amf.funkerportal.de/ +- **Download**: https://github.com/praktimarc/kst4contest/releases/latest --- diff --git a/github_docs/qartest_logsync.png b/github_docs/qartest_logsync.png new file mode 100644 index 0000000..8da59bd Binary files /dev/null and b/github_docs/qartest_logsync.png differ diff --git a/github_docs/qrg_buttons.png b/github_docs/qrg_buttons.png new file mode 100644 index 0000000..5e5ea1d Binary files /dev/null and b/github_docs/qrg_buttons.png differ diff --git a/github_docs/ucxlog_logsync.png b/github_docs/ucxlog_logsync.png new file mode 100644 index 0000000..93c34b3 Binary files /dev/null and b/github_docs/ucxlog_logsync.png differ diff --git a/github_docs/update_window.png b/github_docs/update_window.png new file mode 100644 index 0000000..9464fe4 Binary files /dev/null and b/github_docs/update_window.png differ