Wiki Sync Pipelines

Wiki Sync fix Wiki no longer empty commits Add files via upload a
2026-03-30 04:31:04 +02:00 · 2026-03-25 17:37:33 +01:00
parent 9ec17332e2
commit f93f3acbb0
22 changed files with 2392 additions and 0 deletions
--- a/.github/workflows/github-wiki.yml
+++ b/.github/workflows/github-wiki.yml
@@ -0,0 +1,21 @@
+name: Publish wiki
+on:
+  push:
+    branches: [main]
+    paths:
+      - github_docs/**
+      - .github/workflows/github-wiki.yml
+concurrency:
+  group: publish-wiki
+  cancel-in-progress: true
+permissions:
+  contents: write
+jobs:
+  publish-wiki:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Andrew-Chen-Wang/github-wiki-action@v4
+        with:
+          path: github_docs
+          disable-empty-commits: true
--- a/github_docs/Home.md
+++ b/github_docs/Home.md
@@ -0,0 +1,53 @@
+# KST4Contest – Wiki
+
+**KST4Contest** (auch bekannt als *PraktiKST*) ist ein Java-basierter Chat-Client für den [ON4KST-Chat](http://www.on4kst.info/chat/), speziell entwickelt für den Contest-Betrieb auf den VHF/UHF/SHF-Bändern.
+
+Entwickelt von **DO5AMF (Marc Fröhlich)**, Operator bei DM5M.
+
+---
+
+## 🌐 Sprache / Language
+
+| 🇩🇪 Deutsch | 🇬🇧 English |
+|---|---|
+| [Startseite (Deutsch)](de-Home) | [Home (English)](en-Home) |
+
+---
+
+## 🇩🇪 Inhalt (Deutsch)
+
+| Seite | Inhalt |
+|---|---|
+| [Installation](de-Installation) | Download, Java-Voraussetzungen, Update |
+| [Konfiguration](de-Konfiguration) | Alle Einstellungen im Detail |
+| [Log-Synchronisation](de-Log-Synchronisation) | UCXLog, N1MM+, QARTest, DXLog.net, WinTest |
+| [AirScout-Integration](de-AirScout-Integration) | Flugzeug-Scatter-Erkennung |
+| [DX-Cluster-Server](de-DX-Cluster-Server) | Integrierter DX-Cluster für das Log-Programm |
+| [Funktionen](de-Funktionen) | Alle Features im Überblick |
+| [Makros und Variablen](de-Makros-und-Variablen) | Text-Snippets, Shortcuts, Variablen |
+| [Benutzeroberfläche](de-Benutzeroberflaeche) | UI-Erklärung und Bedienung |
+| [Changelog](de-Changelog) | Versionsgeschichte |
+
+---
+
+## 🇬🇧 Contents (English)
+
+| Page | Contents |
+|---|---|
+| [Installation](en-Installation) | Download, Java requirements, updates |
+| [Configuration](en-Configuration) | All settings in detail |
+| [Log Synchronisation](en-Log-Sync) | UCXLog, N1MM+, QARTest, DXLog.net, WinTest |
+| [AirScout Integration](en-AirScout-Integration) | Aircraft scatter detection |
+| [DX Cluster Server](en-DX-Cluster-Server) | Built-in DX cluster for your logging software |
+| [Features](en-Features) | All features at a glance |
+| [Macros and Variables](en-Macros-and-Variables) | Text snippets, shortcuts, variables |
+| [User Interface](en-User-Interface) | UI explained and how to operate it |
+| [Changelog](en-Changelog) | Version history |
+
+---
+
+## Schnellinfo / Quick Info
+
+- **Download**: https://do5amf.funkerportal.de/
+- **GitHub**: https://github.com/praktimarc/kst4contest
+- **Kontakt / Contact**: praktimarc+kst4contest@gmail.com
--- a/github_docs/de-AirScout-Integration.md
+++ b/github_docs/de-AirScout-Integration.md
@@ -0,0 +1,108 @@
+# AirScout-Integration
+
+> 🇬🇧 [English version](en-AirScout-Integration) | 🇩🇪 Du liest gerade die deutsche Version
+
+AirScout (von DL2ALF) ist ein Programm zur Erkennung von Flugzeugen für den Aircraft-Scatter-Betrieb. KST4Contest ist eng mit AirScout integriert und zeigt reflektierbare Flugzeuge direkt in der Benutzerliste an.
+
+> **Aircraft Scatter** ermöglicht sehr weitreichende Verbindungen auf VHF und höher – auch für Stationen mit geringer Höhe über NN oder ungünstigen topografischen Verhältnissen.
+
+---
+
+## AirScout herunterladen
+
+Download von AirScout:
+- http://airscout.eu/index.php/download
+
+---
+
+## Flugzeugdaten-Feeds (ADSB)
+
+Öffentliche Flugzeugdaten-Feeds im Internet sind oft unzuverlässig und begrenzt nutzbar. Eine empfohlene Alternative bietet **OV3T (Thomas)** mit einem dedizierten ADSB-Feed-Dienst:
+
+- https://airscatter.dk/
+- https://www.facebook.com/groups/825093981868542
+
+Für diesen Dienst ist ein Account erforderlich. Bitte eine Spende für Thomas in Betracht ziehen – der Server-Betrieb ist nicht kostenlos!
+
+---
+
+## AirScout einrichten
+
+### Schritt 1: ADSB-Feed in AirScout konfigurieren
+
+1. AirScout starten.
+2. In den AirScout-Einstellungen den OV3T-Feed-Account eintragen (Benutzername, Passwort, URL).
+3. Verbindung testen.
+
+### Schritt 2: UDP-Kommunikation für KST4Contest aktivieren
+
+In AirScout die UDP-Schnittstelle aktivieren:
+
+- In den AirScout-Einstellungen die entsprechende Checkbox aktivieren (nur eine Checkbox notwendig).
+- Standard-Ports nicht ändern, wenn kein besonderer Grund vorliegt.
+
+### Schritt 3: KST4Contest-Einstellungen
+
+In den KST4Contest-Preferences → **AirScout Settings**:
+- AirScout-Kommunikation aktivieren
+- IP und Port auf Standardwerte lassen (sofern nicht geändert)
+
+---
+
+## Kommunikation zwischen KST4Contest und AirScout (ab v1.263)
+
+**Verbesserung in v1.263**: KST4Contest sendet nur noch Stationen an AirScout, deren QRB (Entfernung) kleiner als das eingestellte **Maximum-QRB** ist. Das Abfrageintervall wurde von 12 Sekunden auf **60 Sekunden** verlängert.
+
+**Vorteile:**
+- Deutlich weniger Berechnungsaufwand für AirScout
+- Deutlich weniger Nachrichtenverkehr
+- Das Tracking-Problem mit dem „Show Path in AirScout"-Button wurde dadurch deutlich verbessert
+- Weniger Rechenleistung insgesamt
+
+Außerdem: Der Name des KST4Contest-Clients und des AirScout-Servers war früher hartcodiert (`KST` und `AS`). Ab v1.263 werden die in den Preferences eingetragenen Namen verwendet.
+
+---
+
+## Mehrere KST4Contest-Instanzen und AirScout
+
+> **Achtung**: Wenn mehrere KST4Contest-Instanzen gleichzeitig betrieben werden und bei beiden die AirScout-Kommunikation aktiviert ist, antwortet AirScout **an beide Instanzen**.
+
+Das ist unproblematisch, wenn:
+- Beide Instanzen denselben Locator verwenden, **oder**
+- Beide Instanzen unterschiedliche Login-Rufzeichen haben.
+
+Andernfalls kann es zu fehlerhaften AP-Daten kommen.
+
+---
+
+## AP-Spalte in der Benutzerliste
+
+Nach der Einrichtung erscheint in der Benutzerliste eine **AP-Spalte** mit bis zu zwei reflektierbaren Flugzeugen pro Station.
+
+Beispiel-Darstellung:
+
+| Station | AP-Info |
+|---|---|
+| DF9QX | 2 Planes: 0 min / 0 min, je 100% |
+| F5DYD | 2 Planes: 14 min / 31 min, je 50% |
+
+Die AP-Informationen sind auch im **Privatnachrichten-Fenster** verfügbar.
+
+Die Prozentzahl gibt das Reflexionspotenzial an (Größe des Flugzeugs, Höhe, Entfernung).
+
+---
+
+## AP-Variablen in Nachrichten
+
+Die Flugzeugdaten können direkt in Nachrichten eingefügt werden:
+
+- `FIRSTAP` → z. B. `a very big AP in 1 min`
+- `SECONDAP` → z. B. `Next big AP in 9 min`
+
+Details: [Makros und Variablen](Makros-und-Variablen#variablen)
+
+---
+
+## „Show Path in AirScout"-Button
+
+In der Benutzerliste gibt es einen Button mit einem Pfeil, der die Richtung (QTF) zur ausgewählten Station anzeigt. Ein Klick maximiert AirScout und zeigt den Pfad mit reflektierbaren Flugzeugen zum ausgewählten Gesprächspartner.
--- a/github_docs/de-Benutzeroberflaeche.md
+++ b/github_docs/de-Benutzeroberflaeche.md
@@ -0,0 +1,105 @@
+# Benutzeroberfläche
+
+> 🇬🇧 [English version](en-User-Interface) | 🇩🇪 Du liest gerade die deutsche Version
+
+## Verbinden mit dem Chat
+
+1. Im Einstellungsfenster eine **Chat-Kategorie** auswählen (z. B. 144 MHz VHF, 432 MHz UHF, …).
+2. **Connect**-Button klicken.
+3. Warten bis die Verbindung aufgebaut ist.
+
+> Trennen und Neu-Verbinden ist nur über das Einstellungsfenster möglich. Es empfiehlt sich daher, das Einstellungsfenster geöffnet zu lassen.
+
+---
+
+## Hauptfenster-Überblick
+
+Das Hauptfenster besteht aus mehreren Bereichen:
+
+### PM-Fenster (oben links)
+
+Zeigt alle empfangenen **Privatnachrichten** sowie abgefangene öffentliche Nachrichten, die das eigene Rufzeichen enthalten. Neue Nachrichten erscheinen in **Rot** und faden alle 30 Sekunden über Gelb bis Weiß ab.
+
+### Benutzerliste (Chat Members)
+
+Die zentrale Tabelle aller aktuell aktiven Chat-Nutzer. Spalten (je nach Konfiguration):
+
+| Spalte | Inhalt |
+|---|---|
+| Call | Rufzeichen der Station |
+| Name | Name aus dem Chat-Namenfeld |
+| Loc | Maidenhead-Locator |
+| QRB | Entfernung in km |
+| QTF | Richtung in Grad |
+| QRG | Automatisch erkannte Frequenz |
+| AP | AirScout-Flugzeugdaten (wenn aktiv) |
+| Band-Farben | Worked/NOT-QRV-Status pro Band |
+
+**Sortierung**: Klick auf Spaltenköpfe. QRB-Sortierung arbeitet numerisch (ab v1.22 korrigiert).
+
+### Sendfeld
+
+Texteingabe für ausgehende Nachrichten. Nach Klick auf ein Rufzeichen in der Benutzerliste erhält das Sendfeld automatisch den Fokus – sofort tippen ohne Doppelklick (ab v1.22).
+
+### MYQRG-Feld
+
+Rechts neben dem Sendbutton. Zeigt die aktuelle eigene QRG an, kann auch manuell eingetragen werden.
+
+### MYQTF-Feld *(für v1.3)*
+
+Eingabefeld für die aktuelle Antennenrichtung. Wird für die geplante `MYQTF`-Variable verwendet.
+
+---
+
+## Filter
+
+Die Filter-Leiste (ab v1.21 als Flowpane für kleine Bildschirme):
+
+- **Show only QTF**: Richtungsfilter aktivieren (Buttons N/NE/E/… oder Grad-Eingabe)
+- **Show only QRB [km] <=**: Entfernungsfilter aktivieren (Toggle-Button)
+- **Hide Worked [Band]**: Gearbeitete Stationen pro Band ausblenden (je ein Toggle pro Band)
+- **Hide NOT-QRV [Band]**: NOT-QRV-markierte Stationen pro Band ausblenden
+
+---
+
+## Stationsinfo-Panel (Further Info)
+
+Rechts unten: Zeigt alle Nachrichten einer ausgewählten Station (CQ-Nachrichten und PMs in einem Panel). Ein Nachrichtenfilter lässt sich über den Standard-Filter in den Preferences vorbelegen.
+
+Hier können auch **Sked-Erinnerungen** aktiviert werden.
+
+---
+
+## Prioritätsliste
+
+Zeigt die vom Score-Service berechneten Top-Kandidaten. Aktualisiert sich automatisch im Hintergrund basierend auf Richtung, Entfernung und AP-Verfügbarkeit.
+
+---
+
+## Cluster & QSO der anderen
+
+Separates Fenster (kann miniaturisiert werden). Zeigt den Kommunikationsfluss zwischen anderen Stationen – interessant in ruhigeren Phasen.
+
+---
+
+## Menü
+
+### Window
+- **Use Dark Mode** (ab v1.26): Dunkles Farbschema aktivieren/deaktivieren.
+
+---
+
+## Fenstergrößen und Divider
+
+Ab **v1.21** werden beim Klick auf **„Save Settings"** auch Fenstergrößen und Divider-Positionen aller Panels in der Konfigurationsdatei gespeichert und beim nächsten Start wiederhergestellt.
+
+Bei Problemen mit der Darstellung: Konfigurationsdatei löschen → KST4Contest erstellt neue Standardwerte.
+
+---
+
+## Tipps zur Bedienung
+
+- **Einstellungsfenster geöffnet lassen**: Schneller Zugriff auf Beacon-Aktivierung/Deaktivierung.
+- **Rechtsklick in der Benutzerliste**: Öffnet das Snippet-Menü und weitere Aktionen (QRZ.com-Profil, NOT-QRV-Tags setzen).
+- **Enter aus dem Chat heraus**: Wenn im Sendfeld Text steht, sendet Enter direkt – auch wenn der Fokus woanders liegt.
+- **Beacon stoppen**: Beim Scannen von Frequenzen den Beacon ausschalten, damit der Chat nicht mit Meldungen überflutet wird.
--- a/github_docs/de-Changelog.md
+++ b/github_docs/de-Changelog.md
@@ -0,0 +1,156 @@
+# Changelog
+
+> 🇬🇧 [English version](en-Changelog) | 🇩🇪 Du liest gerade die deutsche Version
+
+Versionsverlauf von KST4Contest / PraktiKST.
+
+---
+
+## v1.263 (2025-06-08)
+**AirScout-Kommunikation und Login-Name**
+
+**Geändert:**
+- AirScout-Kommunikation grundlegend überarbeitet: Nur noch Stationen mit QRB < max-QRB werden an AirScout gesendet.
+- Abfrage-Intervall von 12 Sekunden auf **60 Sekunden** erhöht.
+- Deutlich weniger Berechnungsaufwand und Nachrichtenverkehr → Stabileres AirScout-Tracking.
+- Name des AS-Clients und AS-Servers ist jetzt aus den Preferences konfigurierbar (war vorher hartcodiert auf „KST" / „AS").
+
+**Behoben:**
+- „Track in AirScout"-Button war sehr träge → durch neue Kommunikationslogik deutlich verbessert.
+- Name im Chat ist jetzt speicherbar (Fehler behoben).
+- Visuelle Korrekturen vor und nach dem Login.
+- Fehler behoben, der von 9A2HM (Kreso) gemeldet wurde.
+
+---
+
+## v1.262 (2025-05-21)
+**Freeze-Fix bei vorzeitiger Nachrichtenlieferung**
+
+**Behoben:**
+- ON4KST liefert manchmal Nachrichten, bevor der Login abgeschlossen ist. Das verursachte Fehler in der Nachrichtenverarbeitung → jetzt behoben.
+
+---
+
+## v1.26 (2025-05)
+**Multi-Channel-Login und Dark Mode**
+
+**Neu:**
+- **Dark Mode**: Umschaltbar über `Window → Use Dark Mode`.
+- **Multi-Channel-Login**: Gleichzeitiger Login in zwei Chat-Kategorien.
+- **Opposite Station Multi-Callsign Login-Tagging**: Unterstützung für Stationen mit mehreren Rufzeichen.
+
+**Geändert:**
+- Farbgebungs-Mechanismus überarbeitet: Farben können jetzt über CSS angepasst werden.
+
+**Behoben:**
+- Stationsmarkierung komplett überarbeitet und korrekt gestellt.
+
+---
+
+## v1.251 (2025-02)
+**Bugfix für UDP-Broadcast-Spot-Info**
+
+**Behoben:**
+- Problem beim Lesen von UDP-Broadcast-Spot-Informationen behoben (gemeldet von Steve Clements – danke!).
+- Stationsmarkierung (erneut verbessert).
+
+---
+
+## v1.25 (2025-02)
+**Wunschliste umgesetzt**
+
+**Neu:**
+- **Neuer Einstellungs-Tab: Messagehandling**
+  - Auto-Antwort auf eingehende Nachrichten konfigurierbar.
+  - Automatische Antwort mit eigener CQ-QRG, wenn jemand danach fragt.
+  - Konfigurierbarer Standard-Filter für das Userinfo-Fenster *(für Gianluca :-) )*.
+- **Farbige PM-Zeilen**: Neue Privatnachrichten erscheinen rot und faden alle 30 Sekunden über Gelb bis Weiß ab *(Idee von IU3OAR, Gianluca)*.
+
+**Behoben:**
+- Stationen mit Suffixen wie „-2" und „-70" wurden nicht als gearbeitet markiert → werden jetzt ignoriert, Station wird korrekt markiert.
+
+---
+
+## v1.24 (2024-11)
+**Wunschliste + DX-Cluster-Spots**
+
+**Neu:**
+- Button zum Öffnen des **QRZ.com-Profils** der ausgewählten Station.
+- Button zum Öffnen des **QRZ-CQ-Profils** der ausgewählten Station.
+- **DX-Cluster-Server-Integration**: Richtungs-Warnungen werden als Spots an das Logprogramm gesendet (wenn QRG bekannt).
+
+*(Zusätzlich wurden Farbgebungen der PM-Zeilen hinzugefügt – tnx Gianluca)*
+
+---
+
+## v1.23 (2024-10)
+**Integrierter DX-Cluster-Server**
+
+**Neu:**
+- KST4Contest enthält jetzt einen **integrierten DX-Cluster-Server**.
+- Generiert DX-Cluster-Spots und sendet sie an das Logprogramm, wenn eine Richtungs-Warnung ausgelöst und eine QRG bekannt ist.
+- Spotter-Rufzeichen muss sich vom Contest-Rufzeichen unterscheiden (für korrekte Filterung im Logprogramm).
+
+*(Idee von OM0AAO, Viliam Petrik – danke!)*
+
+---
+
+## v1.22 (2024-05)
+**Usability-Verbesserungen und AirScout-Button-Fix**
+
+**Neu:**
+- Neue Variablen (tnx OM0AAO, Viliam Petrik):
+  - `MYLOCATORSHORT`
+  - `MYQRGSHORT`
+  - `QRZNAME`
+
+**Geändert:**
+- Sendfeld-Fokus: Nach Klick auf Rufzeichen in der Benutzerliste erhält das Sendfeld sofort den Fokus – kein Doppelklick notwendig *(tnx Gianluca)*.
+
+**Behoben:**
+- Worked-Station-Filter ist jetzt live-aktiv: Gearbeitete Stationen verschwinden sofort nach Aktivierung des Filters *(tnx Gianluca)*.
+- QRB-Sortierung war lexikografisch → jetzt numerisch *(tnx Alessandro Murador)*.
+- AirScout-„Show Path"-Button: Klick maximiert AirScout und zeigt den Pfad korrekt an.
+
+---
+
+## v1.21 (2024-04)
+**Usability-Verbesserungen**
+
+**Geändert:**
+- Fenstergrößen und Divider-Positionen werden beim Klick auf „Save Settings" in der Konfigurationsdatei gespeichert und beim Start wiederhergestellt.
+- Filter-Bereich als Flowpane → bessere Darstellung auf kleineren Bildschirmen.
+
+---
+
+## v1.2 (2024-04)
+**Bandselektion und NOT-QRV-Tags**
+
+**Neu:**
+- **Bandselektion**: In den Preferences auswählbar, welche Bänder aktiv sind. Nur für gewählte Bänder erscheinen Buttons und Felder in der UI. Speichern und Neustart erforderlich.
+- **NOT-QRV-Tags pro Station und Band**: Stationen können für jedes Band als „nicht QRV" markiert werden. Kombinierbar mit dem Userlist-Filter.
+- **QTF-Pfeil**: Der „Show path in AS"-Button zeigt jetzt einen Pfeil mit dem QTF der ausgewählten Station an.
+
+---
+
+## Frühere Versionen
+
+### v1.1
+Erste öffentlich veröffentlichte Version. Grundfunktionen:
+- Worked-Markierung via Simplelogfile und UDP
+- Sked-Richtungs-Hervorhebung
+- QRG-Erkennung
+- Text-Snippets und Shortcuts
+- AirScout-Interface (erste Version)
+- Intervall-Beacon
+- PM-Abfang für öffentliche Nachrichten mit eigenem Rufzeichen
+- Update-Hinweis-Dienst
+
+---
+
+## Geplante Features
+
+- `MYQTF`-Variable (eigene Antennenrichtung als Text)
+- Lebensdauer für den Worked-Status (automatisches Zurücksetzen)
+- Filterung des „Cluster & QSO der anderen"-Fensters auf eigenes QTF
+- Weitere Topografie-basierte Berechnungen für die Richtungswarnung
--- a/github_docs/de-DX-Cluster-Server.md
+++ b/github_docs/de-DX-Cluster-Server.md
@@ -0,0 +1,76 @@
+# Integrierter DX-Cluster-Server
+
+> 🇬🇧 [English version](en-DX-Cluster-Server) | 🇩🇪 Du liest gerade die deutsche Version
+
+Ab **Version 1.23** enthält KST4Contest einen integrierten DX-Cluster-Server. Dieser sendet Spots direkt an das Logprogramm, wenn eine Richtungs-Warnung ausgelöst wird.
+
+*(Idee von OM0AAO, Viliam Petrik – danke!)*
+
+---
+
+## Wozu dient der integrierte DX-Cluster-Server?
+
+Wenn KST4Contest erkennt, dass eine Station aus der eigenen Richtung ein Sked anfragt und gleichzeitig eine QRG bekannt ist, wird **automatisch ein DX-Cluster-Spot generiert** und an den Cluster-Client des Logprogramms gesendet.
+
+Das Logprogramm zeigt den Spot in der Bandkarte an. Ein Klick auf den Spot stellt Frequenz und Mode des Transceivers direkt ein – ohne manuelles Eintippen.
+
+---
+
+## Einrichtung
+
+### In KST4Contest
+
+In den Preferences → **DX-Cluster-Server-Einstellungen**:
+
+1. **Port** des internen Servers eintragen (z. B. 7300 oder 8000 – muss mit dem Logprogramm übereinstimmen).
+2. **Spotter-Rufzeichen** eintragen – **unbedingt ein anderes Rufzeichen als das Contest-Rufzeichen verwenden!**
+   - Grund: Logprogramme filtern Spots, die vom eigenen Rufzeichen stammen, als „gearbeitet" heraus. Wenn der Spotter dasselbe Rufzeichen hat, werden die Spots nicht angezeigt.
+3. **Angenommene MHz** eintragen: Bei Frequenzangaben wie „.205" im Chat muss KST4Contest entscheiden, ob 144.205, 432.205 oder 1296.205 gemeint ist. Bei Einband-Contests einfach die entsprechende Bandmitte eintragen. Vollständige Frequenzangaben wie „144.205" oder „1296.338" im Chat werden immer korrekt erkannt.
+
+### In UCXLog
+
+- Verbindung zu einem DX-Cluster-Server konfigurieren:
+  - Host: `127.0.0.1` (oder IP des KST4Contest-Computers)
+  - Port: Wie in KST4Contest konfiguriert
+  - Passwort: kann leer bleiben
+- Über die Schaltfläche **„Send a test message to your log"** kann die Verbindung getestet werden.
+
+### In N1MM+
+
+Ähnliche Einstellungen:
+- Host: `127.0.0.1` (oder IP des KST4Contest-Computers)
+- Port: Wie in KST4Contest konfiguriert
+
+---
+
+## Funktionsweise
+
+Ein Spot wird generiert, wenn **beide** Bedingungen erfüllt sind:
+
+1. Eine **Richtungs-Warnung** wurde ausgelöst (Station macht ein Sked in die eigene Richtung).
+2. **QRG der Station ist bekannt** (aus dem Chat ausgelesen oder manuell eingetragen).
+
+Der generierte Spot enthält:
+- Rufzeichen der Station
+- Frequenz
+- Spotterzeit
+
+Das Logprogramm kann den Spot dann in der Bandkarte anzeigen und den TRX per Mausklick auf die Frequenz abstimmen.
+
+---
+
+## Multi-Computer-Setup
+
+Wenn KST4Contest auf einem separaten Computer läuft (nicht auf dem Log-Computer):
+
+- Host im Logprogramm: IP des KST4Contest-Computers (nicht `127.0.0.1`)
+- Entspricht der Konfiguration der QSO-UDP-Broadcast-Pakete (siehe [Log-Synchronisation](de-Log-Synchronisation))
+
+---
+
+## Getestete Logprogramme
+
+- **UCXLog** ✓
+- **N1MM+** ✓
+
+Weitere Testergebnisse sind willkommen – bitte per E-Mail an DO5AMF melden.
--- a/github_docs/de-Funktionen.md
+++ b/github_docs/de-Funktionen.md
@@ -0,0 +1,173 @@
+# Funktionen
+
+> 🇬🇧 [English version](en-Features) | 🇩🇪 Du liest gerade die deutsche Version
+
+Übersicht aller Hauptfunktionen von KST4Contest.
+
+---
+
+## Sked-Richtungs-Hervorhebung
+
+Eine der Kernfunktionen: Wenn eine Station ein Sked in die **eigene Richtung** sendet, wird sie in der Benutzerliste **grün und fett** hervorgehoben.
+
+### Wie funktioniert das?
+
+Die Berechnung basiert auf folgender Logik:
+
+- Wenn Station A eine Sked-Anfrage an Station B sendet, wird angenommen, dass A ihre Antenne auf B ausrichtet.
+- Wenn die daraus resultierende Richtung von A zur eigenen Station innerhalb des halben Öffnungswinkels der eigenen Antenne liegt, wird A hervorgehoben.
+
+**Beispiel** (Öffnungswinkel 69°, Halbwinkel 34,5°):
+
+| Situation | Ergebnis für DO5AMF in JN49 |
+|---|---|
+| Sked von F5FEN → DM5M | ✅ Hervorhebung (F5FEN zeigt Richtung DM5M, das liegt nahe JN49) |
+| Sked von DM5M → F5FEN | ✅ Hervorhebung (DM5M antwortet in Richtung F5FEN) |
+| F1DBN ist unbeteiligt | ❌ Keine Hervorhebung |
+| DO5AMF/P (anderer Standort) | ❌ Keine Hervorhebung für Sked-Antwort |
+
+Die Berechnung berücksichtigt keine topografischen Wegberechnungen – das ist eine bewusste Vereinfachung. Möglicherweise wird das in einer späteren Version ergänzt.
+
+> Konfiguration: [Konfiguration – Antennen-Öffnungswinkel](Konfiguration#antennen-öffnungswinkel-antenna-beamwidth)
+
+---
+
+## Sked-Richtungs-Spots (Integrierter DX-Cluster)
+
+Ab **v1.23**: Richtungs-Warnungen werden als DX-Cluster-Spots an das Logprogramm weitergeleitet, wenn eine QRG bekannt ist. Details: [DX-Cluster-Server](de-DX-Cluster-Server).
+
+---
+
+## QRG-Erkennung (QRG Reading)
+
+KST4Contest verarbeitet jede Chat-Nachricht und extrahiert automatisch **Frequenzangaben**. Diese werden in der Benutzerliste in der **QRG-Spalte** angezeigt.
+
+Erkannte Formate: `144.205`, `432.088`, `.205` (mit konfigurierter Bandannahme), etc.
+
+**Nutzen**: Ohne nachzufragen kann man direkt auf die QRG einer Station schauen und entscheiden, ob eine Verbindung möglich ist.
+
+---
+
+## Worked-Markierung
+
+Gearbeitete Stationen werden in der Benutzerliste visuell markiert – pro Band. Grundlage ist die [Log-Synchronisation](de-Log-Synchronisation) via UDP oder Simplelogfile.
+
+Vor jedem Contest die Datenbank zurücksetzen: [Konfiguration – Worked Station Database Settings](Konfiguration#worked-station-database-settings).
+
+---
+
+## NOT-QRV-Tags (ab v1.2)
+
+Wenn eine Station mitteilt, dass sie auf einem bestimmten Band nicht QRV ist, kann dies manuell markiert werden:
+
+1. Station in der Benutzerliste auswählen.
+2. Rechtsklick → NOT-QRV für das entsprechende Band setzen.
+
+Diese Tags werden in der internen Datenbank gespeichert und bleiben nach einem Neustart von KST4Contest erhalten. Zurücksetzen über die Einstellungen möglich.
+
+**Nutzen**: Verhindert wiederholte Sked-Anfragen auf Bändern, auf denen die Station nicht QRV ist – schont sowohl die eigenen Nerven als auch die der Gegenstation.
+
+---
+
+## Richtungsfilter (Direction Filter)
+
+Zeigt in der Benutzerliste nur Stationen an, die sich in einer bestimmten Richtung befinden. Aktivierbar über die Buttons N / NE / E / SE / S / SW / W / NW oder durch manuelle Eingabe von Grad.
+
+Sinnvoll: Während man CQ in eine bestimmte Richtung ruft, nur Stationen in dieser Richtung anzeigen.
+
+---
+
+## Entfernungsfilter (Distance Filter)
+
+Stationen jenseits einer maximalen Entfernung ausblenden. Schaltfläche **„Show only QRB [km] <="** ist ein Toggle-Button.
+
+---
+
+## Worked- und NOT-QRV-Filter
+
+Toggle-Buttons (einer pro Band) zum Ausblenden bereits gearbeiteter Stationen und/oder NOT-QRV-markierter Stationen. Der Filter wirkt **sofort** ohne manuelles Neu-Aktivieren (ab v1.22 live).
+
+---
+
+## Farbige PM-Zeilen (ab v1.25)
+
+Neue Privatnachrichten erscheinen in **Rot**. Die Farbe wechselt alle 30 Sekunden über Gelb bis Weiß – wie ein Regenbogen-Fade. So ist auf einen Blick erkennbar, wie aktuell eine Nachricht ist.
+
+*(Idee von IU3OAR, Gianluca Costantino – danke!)*
+
+---
+
+## PM-Abfang (Catching Personal Messages)
+
+Manche Nutzer senden Direktnachrichten versehentlich öffentlich, z. B.:
+
+```
+(DM5M) pse ur qrg
+```
+
+KST4Contest erkennt solche Nachrichten, die das eigene Rufzeichen enthalten, und sortiert sie automatisch in die **Privatnachrichten-Tabelle** ein. So gehen keine Nachrichten verloren.
+
+---
+
+## Multi-Channel-Login (ab v1.26)
+
+Gleichzeitiger Login in **zwei Chat-Kategorien** (z. B. 144 MHz und 432 MHz). Beide Chats werden parallel überwacht.
+
+---
+
+## Dark Mode (ab v1.26)
+
+Aktivierbar über: **Window → Use Dark Mode**
+
+Für individuelle Farbanpassungen: CSS-Datei bearbeiten (Pfad in den Programmunterlagen).
+
+---
+
+## Opposite Station Multi-Callsign Login-Tagging (ab v1.26)
+
+Unterstützung für Stationen, die mit mehreren Rufzeichen gleichzeitig im Chat aktiv sind (z. B. Expedition-Setups).
+
+---
+
+## QRZ.com und QRZ-CQ Profil-Buttons (ab v1.24)
+
+Für ausgewählte Stationen in der Benutzerliste gibt es direkte Buttons, um das **QRZ.com-Profil** und das **QRZ-CQ-Profil** im Browser zu öffnen.
+
+---
+
+## Sked-Erinnerungen (Sked Reminder Service)
+
+Für vereinbarte Skeds können automatische Erinnerungs-PMs konfiguriert werden, die X Minuten vor dem vereinbarten Zeitpunkt gesendet werden. Die Erinnerungen werden aus dem FurtherInfo-Panel heraus aktiviert.
+
+---
+
+## Prioritätsliste / Score-Service
+
+KST4Contest berechnet automatisch eine **Prioritätsliste** der interessantesten Gesprächspartner, basierend auf:
+
+- Richtungserkennung
+- QRB (Entfernung)
+- AP-Verfügbarkeit (AirScout)
+- Worked-Status
+
+Die Top-Kandidaten werden in einer eigenen Liste angezeigt und helfen, im Contest-Stress die wichtigsten Stationen nicht zu übersehen.
+
+---
+
+## Intervall-Beacon
+
+Automatische CQ-Meldungen im öffentlichen Kanal in konfigurierbarem Intervall. Empfohlene Verwendung mit der Variable `MYQRG` für aktuelle Frequenzangabe. Details: [Konfiguration – Beacon Settings](Konfiguration#beacon-settings-automatischer-beacon).
+
+---
+
+## Simplelogfile
+
+Dateibasierte Log-Auswertung per Regex. Details: [Log-Synchronisation](Log-Synchronisation#methode-1-universal-file-based-callsign-interpreter-simplelogfile).
+
+---
+
+## Cluster & QSO der anderen
+
+Ein separates Fenster zeigt den QSO-Fluss zwischen anderen Stationen. Besonders interessant in ruhigeren Nacht-Stunden während des Contests, wenn weniger Verkehr herrscht.
+
+Dieses Fenster kann miniaturisiert werden, wenn es nicht benötigt wird. Zukünftig geplant: Filterung auf Stationen im ausgewählten QTF.
--- a/github_docs/de-Home.md
+++ b/github_docs/de-Home.md
@@ -0,0 +1,51 @@
+# KST4Contest – Wiki
+
+> 🇬🇧 [English version](en-Home) | 🇩🇪 Du liest gerade die deutsche Version
+
+**KST4Contest** (auch bekannt als *PraktiKST*) ist ein Java-basierter Chat-Client für den [ON4KST-Chat](http://www.on4kst.info/chat/), der speziell für den Contest-Betrieb auf den VHF/UHF/SHF-Bändern (144 MHz und aufwärts) entwickelt wurde.
+
+Entwickelt von **DO5AMF (Marc Fröhlich)**, Operator bei DM5M.
+
+---
+
+## Schnellnavigation
+
+| Seite | Inhalt |
+|---|---|
+| [Installation](de-Installation) | Download, Java-Voraussetzungen, Update |
+| [Konfiguration](de-Konfiguration) | Alle Einstellungen im Detail |
+| [Log-Synchronisation](de-Log-Synchronisation) | UCXLog, N1MM+, QARTest, DXLog.net, WinTest |
+| [AirScout-Integration](de-AirScout-Integration) | Flugzeug-Scatter-Erkennung |
+| [DX-Cluster-Server](de-DX-Cluster-Server) | Integrierter DX-Cluster für das Log-Programm |
+| [Funktionen](de-Funktionen) | Alle Features im Überblick |
+| [Makros und Variablen](de-Makros-und-Variablen) | Text-Snippets, Shortcuts, Variablen |
+| [Benutzeroberfläche](de-Benutzeroberflaeche) | UI-Erklärung und Bedienung |
+| [Changelog](de-Changelog) | Versionsgeschichte |
+
+---
+
+## Was ist KST4Contest?
+
+Der ON4KST-Chat ist der De-facto-Standard für Skeds auf den 144-MHz-und-höher-Bändern. KST4Contest erweitert die Chat-Nutzung um contest-spezifische Funktionen:
+
+- **Worked-Markierung**: Bereits gearbeitete Stationen werden farblich markiert, direkt aus dem Logprogramm via UDP synchronisiert.
+- **Sked-Richtungs-Erkennung**: Wenn eine Station eine andere aus deiner Richtung anruft, wird sie grün und fett hervorgehoben.
+- **QRG-Erkennung**: KST4Contest liest Frequenzen automatisch aus dem Chat-Verkehr und zeigt sie in der Benutzerliste an.
+- **AirScout-Interface**: Anzeige reflektierbarer Flugzeuge direkt in der Benutzerliste.
+- **Integrierter DX-Cluster-Server**: Spots werden direkt an das Logprogramm gesendet.
+- **Dark Mode** (ab v1.26): Schont die Augen in der Nacht.
+- **Multi-Channel-Login** (ab v1.26): Gleichzeitig in zwei Chat-Kategorien einloggen.
+
+---
+
+## Kontakt & Support
+
+- **E-Mail**: praktimarc+kst4contest@gmail.com *(nur für kst4contest-Themen)*
+- **GitHub**: https://github.com/praktimarc/kst4contest
+- **Download**: https://do5amf.funkerportal.de/
+
+---
+
+## Danksagungen
+
+Besonderer Dank gilt: Gianluca Costantino (IU3OAR), Alessandro Murador (IZ3VTH), Reczetár István (HA1FV), OM0AAO (Viliam Petrik, DX-Cluster-Idee), DC9DJ (Konrad Neitzel, Projektstruktur), DO5ALF (Andreas, Webmaster funkerportal.de), PE0WGA (Franz van Velzen, Tester) sowie allen weiteren Testern und Ideengebern.
--- a/github_docs/de-Installation.md
+++ b/github_docs/de-Installation.md
@@ -0,0 +1,83 @@
+# Installation
+
+> 🇬🇧 [English version](en-Installation) | 🇩🇪 Du liest gerade die deutsche Version
+
+## 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:
+
+- Registrierung unter: http://www.on4kst.info/chat/register.php
+
+### Verhaltensregeln im Chat
+
+Die offizielle Sprache im ON4KST-Chat ist **Englisch**. Auch bei Kommunikation mit Stationen aus dem eigenen Land bitte Englisch verwenden. Übliche HAM-Abkürzungen (agn, dir, pse, rrr, tnx, 73 …) sind gang und gäbe.
+
+### Persönliche Nachrichten
+
+Um eine Privatnachricht an eine andere Station zu senden, immer folgendes Format verwenden:
+
+```
+/CQ RUFZEICHEN Nachrichtentext
+```
+
+Beispiel: `/CQ DL5ASG pse sked 144.205?`
+
+Bei starkem Chat-Verkehr (5–6 Nachrichten pro Sekunde im Contest) gehen öffentliche Nachrichten, die an ein bestimmtes Rufzeichen gerichtet sind, leicht unter. KST4Contest fängt solche Nachrichten aber auch dann ab, wenn sie fälschlicherweise öffentlich gepostet werden (siehe [Funktionen – PM-Abfang](Funktionen#catching-personal-messages)).
+
+---
+
+## Download
+
+Die aktuelle Version kann als ZIP-Datei heruntergeladen werden:
+
+**https://do5amf.funkerportal.de/**
+
+Der Dateiname hat das Format `kst4Contest_v<Versionsnummer>.zip`.
+
+---
+
+## Installation
+
+1. ZIP-Datei herunterladen.
+2. ZIP-Datei in einen gewünschten Ordner entpacken.
+3. `praktiKST.exe` (Windows) bzw. das entsprechende Start-Skript ausführen.
+
+Die Einstellungen werden unter `%USERPROFILE%\.praktikst\preferences.xml` (Windows) gespeichert.
+
+---
+
+## Update
+
+KST4Contest enthält einen **automatischen Update-Hinweis-Dienst**: Sobald eine neue Version verfügbar ist, erscheint beim Start ein Fenster mit:
+- der Information, dass eine neue Version vorliegt,
+- einem Changelog,
+- dem Download-Link zur neuen Version.
+
+### Update-Prozess
+
+Derzeit gibt es nur einen Weg zum Aktualisieren:
+
+1. Den alten Ordner löschen.
+2. Das neue ZIP entpacken.
+
+Die Einstellungsdatei (`preferences.xml`) bleibt erhalten, da sie im Benutzerordner gespeichert ist – nicht im Programmordner.
+
+---
+
+## Bekannte Probleme beim Start
+
+### Norton 360
+
+Norton 360 stuft `praktiKST.exe` als gefährlich ein (Fehlalarm). Es muss eine Ausnahme für die Datei eingerichtet werden:
+
+1. Norton 360 öffnen.
+2. Sicherheit → Verlauf → Das entsprechende Ereignis suchen.
+3. „Wiederherstellen & Ausnahme hinzufügen" wählen.
+
+*(Gemeldet von PE0WGA, Franz van Velzen – danke!)*
--- a/github_docs/de-Konfiguration.md
+++ b/github_docs/de-Konfiguration.md
@@ -0,0 +1,135 @@
+# Konfiguration
+
+> 🇬🇧 [English version](en-Configuration) | 🇩🇪 Du liest gerade die deutsche Version
+
+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.
+
+---
+
+## Station Settings (Stationseinstellungen)
+
+### Rufzeichen und Locator
+
+Eigenes Rufzeichen und Maidenhead-Locator (6-stellig, z. B. `JN49IJ`) eintragen. Diese Werte werden für Distanz- und Richtungsberechnungen benötigt.
+
+### Aktivierte Bänder
+
+Über die **„my station uses band"**-Checkboxen werden die aktiven Bänder ausgewählt. Nur für ausgewählte Bänder erscheinen Schaltflächen und Tabellenzeilen in der Benutzeroberfläche. Nach Änderungen muss die Software neu gestartet werden.
+
+### Antennen-Öffnungswinkel (Antenna Beamwidth)
+
+Einen realistischen Wert für den Öffnungswinkel der eigenen Antenne eintragen (in Grad). Dieser Wert wird für die [Sked-Richtungs-Hervorhebung](Funktionen#sked-richtungs-hervorhebung) verwendet. Ein Testwert von 50° hat sich bewährt; DM5M nutzt Quads mit 69°.
+
+> **Keinesfalls** Fantasy-Werte eintragen – die Richtungsberechnungen werden sonst unbrauchbar.
+
+### Standard-Maximum-QRB
+
+Maximale Entfernung (in km), für die Richtungs-Warnungen ausgelöst werden sollen. Realistischer Wert für DM5M: 900 km. Stationen, die weiter entfernt sind, werden für Highlighting-Zwecke ignoriert.
+
+---
+
+## Log-Sync-Einstellungen
+
+Zwei Methoden stehen zur Verfügung, um gearbeitete Stationen automatisch zu markieren. Details: [Log-Synchronisation](de-Log-Synchronisation).
+
+### Universal File Based Callsign Interpreter (Simplelogfile)
+
+Interpretiert beliebige Log-Dateien per Regex nach Rufzeichen-Mustern. Keine Bandinformation möglich. Geeignet als Fallback oder für nicht direkt unterstützte Logprogramme.
+
+### 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**.
+
+---
+
+## TRX-Sync-Einstellungen
+
+Empfängt die aktuelle Frequenz des Transceivers vom Logprogramm via UDP. Ermöglicht die automatische Befüllung der Variable `MYQRG`. Nützlich für:
+
+- Schnelles Einfügen der eigenen QRG in Chat-Nachrichten.
+- Automatische CQ-Baken mit aktueller Frequenz.
+
+> **Hinweis für Multi-Setup**: Wenn zwei Logprogramme an zwei Computern betrieben werden, aber nur eine KST4Contest-Instanz, darf nur ein Logprogramm die Frequenzpakete senden. KST4Contest kann nicht zwischen den Quellen unterscheiden.
+
+---
+
+## AirScout-Einstellungen
+
+Konfiguration der Schnittstelle zu AirScout für die Flugzeug-Scatter-Erkennung. Details: [AirScout-Integration](de-AirScout-Integration).
+
+---
+
+## Notification Settings (Benachrichtigungen)
+
+Drei Benachrichtigungstypen stehen zur Wahl:
+
+1. **Einfache Sounds**: TADA-Sound für eingehende Nachrichten, Tick für Sked-Richtungserkennung usw.
+2. **CW-Ansage**: Das Rufzeichen einer Station, die eine Privatnachricht sendet, wird als CW-Signal ausgegeben.
+3. **Phonetische Ansage**: Das Rufzeichen wird phonetisch ausgesprochen.
+
+---
+
+## Shortcut Settings (Schnellzugriff-Schaltflächen)
+
+Konfiguration von Schnellzugriff-Schaltflächen, die direkt im Hauptfenster erscheinen. Ein Klick auf eine Schaltfläche fügt den konfigurierten Text in das Sendfeld ein. Alle [Variablen](Makros-und-Variablen#variablen) können verwendet werden.
+
+---
+
+## Snippet Settings (Text-Snippets)
+
+Text-Snippets sind über folgende Wege abrufbar:
+
+- **Rechtsklick** auf ein Rufzeichen in der Benutzerliste
+- **Rechtsklick** in der CQ-Nachrichtentabelle
+- **Rechtsklick** in der PM-Nachrichtentabelle
+- **Tastenkombinationen**: `Ctrl+1` bis `Ctrl+0` für die ersten 10 Snippets
+
+Wenn in der Benutzerliste ein Rufzeichen ausgewählt ist, wird der Snippet als Direktnachricht adressiert:
+`/CQ RUFZEICHEN <Snippet-Text>`
+
+---
+
+## Beacon Settings (Automatischer Beacon)
+
+Konfiguration eines automatischen Intervall-Beacons im öffentlichen Chat-Kanal. Empfohlen: Variable `MYQRG` im Text verwenden, damit die aktuelle Frequenz immer aktuell ist. Intervall und Text sind frei konfigurierbar.
+
+> **Tipp**: Beacon beim CQ-Rufen aktivieren und im Einstellungsfenster schnell deaktivieren, wenn kein CQ gerufen wird.
+
+---
+
+## Messagehandling Settings (ab v1.25)
+
+Neuer Einstellungsbereich mit folgenden Optionen:
+
+- **Auto-Antwort auf alle eingehenden Nachrichten**: Automatische Antwort auf Privatnachrichten konfigurierbar.
+- **Auto-Antwort mit eigener CQ-QRG**: Wenn jemand nach der eigenen QRG fragt, antwortet KST4Contest automatisch mit dem Inhalt der `MYQRG`-Variable.
+- **Standard-Filter für das Userinfo-Fenster**: Voreingestellter Nachrichtenfilter für das Stationsinfo-Fenster konfigurierbar *(für Gianluca :-) )*.
+
+---
+
+## Worked Station Database Settings (Gearbeitete-Stationen-Datenbank)
+
+Vor jedem Contest die interne Worked-Datenbank zurücksetzen! Enthält:
+
+- Worked-Status aller Stationen (pro Band)
+- NOT-QRV-Tags (seit v1.2)
+
+Schaltfläche **„Reinitialize"** unter der Tabelle verwenden. Eine geplante Funktion ist eine automatische Ablaufzeit für den Worked-Status.
+
+---
+
+## Dark Mode (ab v1.26)
+
+Umschaltbar über das Menü: **Window → Use Dark Mode**. Die Farben können über CSS individuell angepasst werden.
+
+---
+
+## Einstellungen speichern
+
+Nach **jeder** Änderung **„Save Settings"** klicken! Ohne Speichern gehen alle Änderungen beim nächsten Start verloren.
+
+- Speicherort: `~/.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.
--- a/github_docs/de-Log-Synchronisation.md
+++ b/github_docs/de-Log-Synchronisation.md
@@ -0,0 +1,111 @@
+# Log-Synchronisation
+
+> 🇬🇧 [English version](en-Log-Sync) | 🇩🇪 Du liest gerade die deutsche Version
+
+KST4Contest markiert gearbeitete Stationen automatisch in der Chat-Benutzerliste. Dafür gibt es zwei grundlegende Methoden:
+
+---
+
+## Methode 1: Universal File Based Callsign Interpreter (Simplelogfile)
+
+KST4Contest liest eine Log-Datei und sucht mittels regulärem Ausdruck nach Rufzeichen-Mustern. Dabei werden auch binäre Logdateien unterstützt – unlesbarer Binärinhalt wird einfach ignoriert.
+
+**Vorteil**: Funktioniert mit nahezu jedem Logprogramm, das eine Datei schreibt.
+**Nachteil**: Keine Bandinformation möglich – es wird nur „gearbeitet" markiert, nicht auf welchem Band.
+
+Pfad der Log-Datei in den Preferences eintragen. Die Datei wird nur gelesen, nie verändert (read-only).
+
+> **Tipp**: Die Simplelogfile-Funktion kann auch genutzt werden, um Stationen zu markieren, die definitiv nicht erreichbar sind (z. B. eigene Notizen). Das wird in einer späteren Version durch ein besseres Tagging-System ersetzt.
+
+---
+
+## Methode 2: Netzwerk-Listener (UDP-Broadcast) – Empfohlen
+
+Das Logprogramm sendet beim Speichern eines QSOs ein UDP-Paket an die Broadcast-Adresse des Heimnetzwerks. KST4Contest empfängt dieses Paket und markiert die Station inklusive **Bandinformation** in der internen SQLite-Datenbank.
+
+> **Wichtig**: KST4Contest muss **parallel zum Logprogramm laufen**. QSOs, die während einer Abwesenheit von KST4Contest geloggt werden, werden nicht erfasst – außer bei QARTest (kann das komplette Log senden).
+
+**Standard UDP-Port**: 12060 (entspricht dem Standard der meisten Logprogramme)
+
+---
+
+## Unterstützte Logprogramme
+
+### UCXLog (DL7UCX)
+
+UCXLog sendet QSO-UDP-Pakete und Transceiver-Frequenzpakete.
+
+**Einstellungen in UCXLog:**
+- UDP-Broadcast aktivieren
+- IP-Adresse des KST4Contest-Computers eintragen (bei lokalem Betrieb: `127.0.0.1`)
+- Port: 12060 (Standard)
+
+Grün markierte Felder in den UCXLog-Einstellungen beachten: IP und Port müssen eingetragen werden.
+
+Hinweis für Multi-Setup (2 Computer, 2 Radios, eine KST4Contest-Instanz): Beide Logprogramme müssen die QSO-Pakete an die IP des KST4Contest-Computers senden. Dann ist mindestens eine IP nicht `127.0.0.1`.
+
+### QARTest (IK3QAR)
+
+**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:**
+- UDP-Broadcast und IP/Port wie UCXLog konfigurieren
+- „Invia log completo" für den vollständigen Log-Upload verwenden
+
+*(„Buona funzionalità caro IK3QAR!" – DO5AMF)*
+
+### N1MM+
+
+**Einstellungen in N1MM+:**
+
+In N1MM+ unter `Config → Configure Ports, Mode Control, Winkey, etc. → Broadcast Data`:
+- `Radio Info` aktivieren (für TRX-Sync/QRG)
+- `Contact Info` aktivieren (für QSO-Sync)
+- IP: `127.0.0.1` (oder IP des KST4Contest-Computers)
+- Port: 12060
+
+Für den integrierten DX-Cluster-Server: N1MM+ als DX-Cluster-Client konfigurieren (Server: `127.0.0.1`, Port wie in KST4Contest eingestellt).
+
+### DXLog.net
+
+**Einstellungen in DXLog.net:**
+- UDP-Broadcast aktivieren
+- IP des KST4Contest-Computers eintragen (grün markierte Felder)
+- Port: 12060
+
+### WinTest
+
+WinTest wird ebenfalls unterstützt. KST4Contest empfängt WinTest-UDP-Pakete über einen dedizierten Listener. Die Konfiguration erfolgt analog zu den anderen Programmen.
+
+---
+
+## TRX-Frequenz-Synchronisation
+
+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.
+
+**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.
+
+---
+
+## Multi-Setup: 2 Radios, 2 Computer
+
+Für DM5M-typische Setups (2 Radios, 2 Computer, eine KST4Contest-Instanz oder zwei separate):
+
+**Variante A – Eine gemeinsame KST4Contest-Instanz:**
+- Beide Logprogramme senden QSO-Pakete an die IP des KST4Contest-Computers
+- Nur ein Logprogramm sendet Frequenzpakete (empfohlen: das VHF-Logprogramm)
+
+**Variante B – Zwei separate KST4Contest-Instanzen (empfohlen):**
+- Jedes Logprogramm kommuniziert mit seiner eigenen KST4Contest-Instanz via `127.0.0.1`
+- Zwei separate Chat-Logins
+- Bessere Trennung und weniger Konflikte
+
+---
+
+## Interne Datenbank
+
+KST4Contest speichert die Worked-Information in einer internen **SQLite-Datenbank**. Diese ist von der Logprogramm-Datenbank unabhängig und wird nur über den UDP-Broadcast befüllt.
+
+Vor jedem neuen Contest: Datenbank zurücksetzen! → [Konfiguration – Worked Station Database Settings](Konfiguration#worked-station-database-settings)
--- a/github_docs/de-Makros-und-Variablen.md
+++ b/github_docs/de-Makros-und-Variablen.md
@@ -0,0 +1,162 @@
+# Makros und Variablen
+
+> 🇬🇧 [English version](en-Macros-and-Variables) | 🇩🇪 Du liest gerade die deutsche Version
+
+KST4Contest bietet ein flexibles System aus Text-Snippets, Shortcuts und eingebauten Variablen, die den Chat-Workflow im Contest erheblich beschleunigen.
+
+---
+
+## Überblick
+
+| Typ | Aufruf | Zweck |
+|---|---|---|
+| **Shortcuts** | Button in der Toolbar | Schneller Text-Insert ins Sendfeld |
+| **Snippets** | Rechtsklick / Ctrl+1..0 | Text-Bausteine, optionaler PM-Versand |
+| **Variablen** | In allen Text-Feldern verwendbar | Dynamische Werte (QRG, Locator, AP-Daten) |
+
+---
+
+## Shortcuts (Schnellzugriff-Schaltflächen)
+
+Konfigurierbar in den Preferences → **Shortcut Settings**.
+
+- Jeder konfigurierte Text erzeugt **einen Button** in der Benutzeroberfläche.
+- Ein Klick fügt den Text in das **Sendfeld** ein.
+- **Alle Variablen** können in Shortcuts verwendet werden und werden beim Einfügen sofort aufgelöst.
+- Auch längere Texte möglich.
+
+**Tipp**: Häufig verwendete Abkürzungen wie „pse", „rrr", „tnx", „73" als Shortcuts anlegen.
+
+---
+
+## Snippets (Text-Bausteine)
+
+Konfigurierbar in den Preferences → **Snippet Settings**.
+
+### Aufruf
+
+- **Rechtsklick** auf ein Rufzeichen in der Benutzerliste
+- **Rechtsklick** in der CQ-Nachrichtentabelle
+- **Rechtsklick** in der PM-Nachrichtentabelle
+- **Tastaturkürzel**: `Ctrl+1` bis `Ctrl+0` für die ersten 10 Snippets
+
+### Verhalten mit ausgewähltem Rufzeichen
+
+Wenn in der Benutzerliste ein Rufzeichen ausgewählt ist, wird der Snippet als **Privatnachricht** adressiert:
+
+```
+/CQ RUFZEICHEN <Snippet-Text>
+```
+
+Anschließend kann mit **Enter** direkt gesendet werden – auch wenn das Sendfeld nicht den Fokus hat.
+
+### Hardware-Makro-Tastatur
+
+*(Idee von IU3OAR, Gianluca Costantino)*
+
+Die Tastenkombinationen `Ctrl+1` bis `Ctrl+0` können auf einer programmierbaren Makro-Tastatur belegt werden. Ein weiterer Tastendruck (auf eine „Enter"-Taste) sendet den Text sofort. Im Contest-Betrieb spart das erheblich Zeit.
+
+### Vordefinierte Standard-Snippets
+
+Beim ersten Start werden einige Snippets vorbelegt, z. B.:
+
+- `Hi OM, try sked?`
+- `I am calling cq ur dir, pse lsn to me at MYQRG`
+- `pse ur qrg?`
+- `rrr, I move to your qrg nw, pse ant dir me`
+
+Diese können in den Preferences angepasst oder gelöscht werden.
+
+---
+
+## Variablen
+
+Variablen werden in geschriebenen Texten (Snippets, Shortcuts, Beacon, Sendfeld) durch ihre aktuellen Werte ersetzt. Einfach den Variablennamen **großgeschrieben** in den Text einfügen.
+
+### MYQRG
+
+Wird durch die aktuelle Transceiverfrequenz ersetzt.
+
+- Quelle: TRX-Sync via UDP vom Logprogramm (wenn aktiviert)
+- Fallback: Manuell eingetragener Wert im MYQRG-Textfeld rechts neben dem Sendbutton
+- Format: `144.388.03`
+
+**Beispiel**: `calling cq at MYQRG` → `calling cq at 144.388.03`
+
+### MYQRGSHORT
+
+Wie MYQRG, aber nur die ersten 7 Zeichen.
+
+- Format: `144.388`
+
+**Beispiel**: `qrg: MYQRGSHORT` → `qrg: 144.388`
+
+### MYLOCATOR
+
+Wird durch den eigenen Maidenhead-Locator (6-stellig) ersetzt.
+
+- Format: `JO51IJ`
+
+**Beispiel**: `my loc: MYLOCATOR` → `my loc: JO51IJ`
+
+### MYLOCATORSHORT
+
+Wie MYLOCATOR, aber nur die ersten 4 Zeichen.
+
+- Format: `JO51`
+
+**Beispiel**: `loc: MYLOCATORSHORT` → `loc: JO51`
+
+### QRZNAME
+
+Wird durch den **Namen** der aktuell ausgewählten Station aus dem Chat-Namenfeld ersetzt.
+
+**Beispiel**: `Hi QRZNAME, sked?` → `Hi Gianluca, sked?`
+
+### FIRSTAP
+
+Wird durch Daten des ersten reflektierbaren Flugzeugs zur ausgewählten Station ersetzt (sofern vorhanden).
+
+- Bedingung: AirScout ist aktiv und ein Flugzeug ist verfügbar.
+- Format-Beispiel: `a very big AP in 1 min`
+
+**Beispiel**: `AP info: FIRSTAP` → `AP info: a very big AP in 1 min`
+
+### SECONDAP
+
+Wie FIRSTAP, aber für das zweite verfügbare Flugzeug.
+
+- Format-Beispiel: `Next big AP in 9 min`
+
+**Beispiel**: `also: SECONDAP` → `also: Next big AP in 9 min`
+
+### MYQTF *(geplant für v1.3)*
+
+Wird durch die aktuelle Antennenrichtung in Worten ersetzt (z. B. `north`, `north east`, `east`, …).
+
+- Quelle: Winkelwert im MYQTF-Eingabefeld (rechts neben dem MYQRG-Feld)
+
+---
+
+## Variablen im Beacon
+
+Alle Variablen können auch im **automatischen Beacon** (Intervall-Nachrichten) verwendet werden. Empfohlene Beacon-Konfiguration:
+
+```
+calling cq at MYQRG, loc MYLOCATOR, GL all!
+```
+
+Da KST4Contest QRG-Daten automatisch aus Chat-Nachrichten ausliest: Wenn andere Stationen ebenfalls KST4Contest nutzen, sehen sie die eigene QRG sofort in der QRG-Spalte der Benutzerliste.
+
+---
+
+## Beispiel-Workflow mit Makros im Contest
+
+1. Station in der Benutzerliste auswählen → Rufzeichen ist nun vorausgewählt.
+2. `Ctrl+1` drücken → Snippet „Hi OM, try sked?" wird als PM adressiert.
+3. Enter drücken → Nachricht wird gesendet.
+4. Station antwortet mit Frequenz → QRG-Spalte wird automatisch befüllt.
+5. `Ctrl+2` → Snippet „I am calling cq ur dir, pse lsn to me at 144.388" (MYQRG aufgelöst).
+6. Enter → Gesendet.
+
+Ohne manuelle Tipparbeit, ohne Fehler, ohne Unterbrechung des CQ-Rufens.
--- a/github_docs/en-AirScout-Integration.md
+++ b/github_docs/en-AirScout-Integration.md
@@ -0,0 +1,108 @@
+# AirScout Integration
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-AirScout-Integration)
+
+AirScout (by DL2ALF) is a program for detecting aircraft for aircraft scatter operation. KST4Contest is tightly integrated with AirScout and shows reflectable aircraft directly in the user list.
+
+> **Aircraft Scatter** enables very long-distance communication on VHF and higher – even for stations with low altitude above sea level or unfavourable topographic conditions.
+
+---
+
+## Downloading AirScout
+
+Download AirScout from:
+- http://airscout.eu/index.php/download
+
+---
+
+## Aircraft Data Feeds (ADSB)
+
+Public aircraft data feeds on the internet are often unreliable and limited in use. A recommended alternative is the dedicated ADSB feed service provided by **OV3T (Thomas)**:
+
+- https://airscatter.dk/
+- https://www.facebook.com/groups/825093981868542
+
+An account is required for this service. Please consider donating to Thomas – the server costs are not free!
+
+---
+
+## Setting Up AirScout
+
+### Step 1: Configure the ADSB Feed in AirScout
+
+1. Start AirScout.
+2. Enter your OV3T feed account details (username, password, URL) in the AirScout settings.
+3. Test the connection.
+
+### Step 2: Enable UDP Communication for KST4Contest
+
+In AirScout, enable the UDP interface:
+
+- Activate the corresponding checkbox in the AirScout settings (only one checkbox needed).
+- Do not change the default ports unless there is a specific reason.
+
+### Step 3: KST4Contest Settings
+
+In KST4Contest Preferences → **AirScout Settings**:
+- Enable AirScout communication
+- Leave IP and port at their default values (unless changed)
+
+---
+
+## Communication Between KST4Contest and AirScout (from v1.263)
+
+**Improvement in v1.263**: KST4Contest now only sends stations to AirScout whose QRB (distance) is less than the configured **maximum QRB**. The query interval has been extended from 12 seconds to **60 seconds**.
+
+**Benefits:**
+- Significantly less computation load for AirScout
+- Significantly less message traffic
+- The tracking issue with the "Show Path in AirScout" button is greatly improved
+- Less overall CPU usage
+
+Additionally: The name of the KST4Contest client and AirScout server was previously hardcoded (`KST` and `AS`). From v1.263, the names configured in the Preferences are used.
+
+---
+
+## Multiple KST4Contest Instances and AirScout
+
+> **Note**: If multiple KST4Contest instances are running simultaneously and AirScout communication is enabled on both, AirScout will respond **to both instances**.
+
+This is not a problem if:
+- Both instances use the same locator, **or**
+- Both instances have different login callsigns.
+
+Otherwise, it may result in incorrect AP data.
+
+---
+
+## AP Column in the User List
+
+After setup, an **AP column** appears in the user list showing up to two reflectable aircraft per station.
+
+Example display:
+
+| Station | AP Info |
+|---|---|
+| DF9QX | 2 Planes: 0 min / 0 min, 100% each |
+| F5DYD | 2 Planes: 14 min / 31 min, 50% each |
+
+AP information is also available in the **private messages window**.
+
+The percentage indicates the reflection potential (aircraft size, altitude, distance).
+
+---
+
+## AP Variables in Messages
+
+Aircraft data can be inserted directly into messages:
+
+- `FIRSTAP` → e.g. `a very big AP in 1 min`
+- `SECONDAP` → e.g. `Next big AP in 9 min`
+
+Details: [Macros and Variables](Macros-and-Variables#variables)
+
+---
+
+## "Show Path in AirScout" Button
+
+In the user list there is a button with an arrow showing the direction (QTF) to the selected station. Clicking it maximises AirScout and shows the path with reflectable aircraft to the selected contact.
--- a/github_docs/en-Changelog.md
+++ b/github_docs/en-Changelog.md
@@ -0,0 +1,156 @@
+# Changelog
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Changelog)
+
+Version history of KST4Contest / PraktiKST.
+
+---
+
+## v1.263 (2025-06-08)
+**AirScout Communication and Login Name**
+
+**Changed:**
+- AirScout communication fundamentally revised: Only stations with QRB < max-QRB are now sent to AirScout.
+- Query interval extended from 12 seconds to **60 seconds**.
+- Significantly less computation load and message traffic → more stable AirScout tracking.
+- Name of the AS client and AS server is now configurable from the Preferences (was previously hardcoded to "KST" / "AS").
+
+**Fixed:**
+- "Track in AirScout" button was very sluggish → greatly improved by new communication logic.
+- Name in chat is now saveable (bug fixed).
+- Visual corrections before and after login.
+- Bug fixed that was reported by 9A2HM (Kreso).
+
+---
+
+## v1.262 (2025-05-21)
+**Freeze Fix for Early Message Delivery**
+
+**Fixed:**
+- ON4KST sometimes delivers messages before login is complete. This caused errors in the message processing engine → now fixed.
+
+---
+
+## v1.26 (2025-05)
+**Multi-Channel Login and Dark Mode**
+
+**New:**
+- **Dark Mode**: Toggle via `Window → Use Dark Mode`.
+- **Multi-channel login**: Simultaneous login to two chat categories.
+- **Opposite station multi-callsign login tagging**: Support for stations with multiple callsigns.
+
+**Changed:**
+- Colouring mechanism revised: Colours can now be customised via CSS.
+
+**Fixed:**
+- Station tagging completely revised and corrected.
+
+---
+
+## v1.251 (2025-02)
+**Bugfix for UDP Broadcast Spot Info**
+
+**Fixed:**
+- Problem reading UDP broadcast spot information fixed (reported by Steve Clements – thank you!).
+- Station tagging (further improved).
+
+---
+
+## v1.25 (2025-02)
+**Wishlist Time**
+
+**New:**
+- **New settings tab: Messagehandling**
+  - Auto-reply to incoming messages configurable.
+  - Automatic reply with own CQ QRG when someone asks for it.
+  - Configurable default filter for the userinfo window *(for Gianluca :-) )*.
+- **Coloured PM rows**: New private messages appear red and fade every 30 seconds from yellow to white *(idea by IU3OAR, Gianluca)*.
+
+**Fixed:**
+- Stations with suffixes like "-2" and "-70" were not being marked as worked → now ignored, station is correctly marked.
+
+---
+
+## v1.24 (2024-11)
+**Wishlist + DX Cluster Spots**
+
+**New:**
+- Button to open the **QRZ.com profile** of the selected station.
+- Button to open the **QRZ-CQ profile** of the selected station.
+- **DX Cluster Server integration**: Direction warnings are sent as spots to the logging software (when QRG is known).
+
+*(Coloured PM row feature also added – tnx Gianluca)*
+
+---
+
+## v1.23 (2024-10)
+**Built-in DX Cluster Server**
+
+**New:**
+- KST4Contest now contains a **built-in DX cluster server**.
+- Generates DX cluster spots and sends them to the logging software when a direction warning is triggered and a QRG is known.
+- Spotter callsign must differ from the contest callsign (for correct filtering in the logging software).
+
+*(Idea by OM0AAO, Viliam Petrik – thank you!)*
+
+---
+
+## v1.22 (2024-05)
+**Usability Improvements and AirScout Button Fix**
+
+**New:**
+- New variables (tnx OM0AAO, Viliam Petrik):
+  - `MYLOCATORSHORT`
+  - `MYQRGSHORT`
+  - `QRZNAME`
+
+**Changed:**
+- Send field focus: After clicking a callsign in the user list, the send field immediately receives focus – no double-click needed *(tnx Gianluca)*.
+
+**Fixed:**
+- Worked-station filter is now live: Worked stations disappear immediately when the filter is activated *(tnx Gianluca)*.
+- QRB sorting was lexicographic → now numeric *(tnx Alessandro Murador)*.
+- AirScout "Show Path" button: Click now maximises AirScout and correctly shows the path.
+
+---
+
+## v1.21 (2024-04)
+**Usability Improvements**
+
+**Changed:**
+- Window sizes and divider positions are saved in the configuration file when clicking "Save Settings" and restored on startup.
+- Filter section as flowpane → better display on smaller screens.
+
+---
+
+## v1.2 (2024-04)
+**Band Selection and NOT-QRV Tags**
+
+**New:**
+- **Band selection**: Selectable in Preferences which bands are active. Only buttons and fields for selected bands appear in the UI. Save and restart required.
+- **NOT-QRV tags per station and band**: Stations can be marked as "not QRV" for each band. Combinable with the user list filter.
+- **QTF arrow**: The "Show path in AS" button now shows an arrow with the QTF of the selected station.
+
+---
+
+## Earlier Versions
+
+### v1.1
+First publicly released version. Core features:
+- Worked marking via Simplelogfile and UDP
+- Sked direction highlighting
+- QRG detection
+- Text snippets and shortcuts
+- AirScout interface (first version)
+- Interval beacon
+- PM catching for public messages containing your own callsign
+- Update notification service
+
+---
+
+## Planned Features
+
+- `MYQTF` variable (own antenna direction as text)
+- Lifetime for worked status (automatic reset)
+- Filtering the "Cluster & QSO of others" window to own QTF
+- Further topography-based calculations for direction warnings
--- a/github_docs/en-Configuration.md
+++ b/github_docs/en-Configuration.md
@@ -0,0 +1,135 @@
+# Configuration
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Konfiguration)
+
+After the first start, the **settings window** opens – this is the central starting point for all configuration. It is recommended to keep the settings window open during operation (e.g. to quickly toggle the beacon on and off).
+
+> **Important**: Always click **"Save Settings"** after any change! Settings are stored in `~/.praktikst/preferences.xml`. From v1.21 onwards, window sizes and divider positions are also saved when you click Save.
+
+---
+
+## Station Settings
+
+### Callsign and Locator
+
+Enter your callsign and Maidenhead locator (6 characters, e.g. `JN49IJ`). These values are used for distance and direction calculations.
+
+### Active Bands
+
+Use the **"my station uses band"** checkboxes to select which bands you are active on. Only selected bands will show buttons and table rows in the user interface. A restart is required after changing these settings.
+
+### Antenna Beamwidth
+
+Enter a realistic value for your antenna's beamwidth (in degrees). This value is used for the [Sked Direction Highlighting](Features#sked-direction-highlighting). A test value of 50° has proven useful; DM5M uses Quads with 69°.
+
+> **Do not** enter fantasy values – the direction calculations will become meaningless.
+
+### Default Maximum QRB
+
+Maximum distance (in km) for which direction warnings should be triggered. A realistic value for DM5M is 900 km. Stations beyond this distance are ignored for highlighting purposes.
+
+---
+
+## Log Sync Settings
+
+Two methods are available for automatically marking worked stations. Details: [Log Synchronisation](en-Log-Sync).
+
+### Universal File Based Callsign Interpreter (Simplelogfile)
+
+Interprets any log file using regex to find callsign patterns. No band information available. Suitable as a fallback or for unsupported logging programs.
+
+### Network Listener for Logger's QSO UDP Broadcast
+
+**Recommended method.** KST4Contest listens for UDP packets sent by the logging software when saving a QSO. Stations are marked including band information. UDP port: default **12060**.
+
+---
+
+## TRX Sync Settings
+
+Receives the current transceiver frequency from the logging software via UDP. Makes the `MYQRG` variable available automatically. Useful for:
+
+- Quickly inserting your own QRG into chat messages.
+- Automatic CQ beacon with current frequency.
+
+> **Note for multi-setup**: When running two logging programs on two computers but only one KST4Contest instance, only one logging program should send frequency packets. KST4Contest cannot distinguish between sources.
+
+---
+
+## AirScout Settings
+
+Configuration of the interface to AirScout for aircraft scatter detection. Details: [AirScout Integration](en-AirScout-Integration).
+
+---
+
+## Notification Settings
+
+Three notification types are available:
+
+1. **Simple sounds**: TADA sound for incoming messages, tick for sked direction detection, etc.
+2. **CW announcement**: The callsign of a station sending a private message is output as a CW signal.
+3. **Phonetic announcement**: The callsign is spoken phonetically.
+
+---
+
+## Shortcut Settings
+
+Configure quick-access buttons that appear directly in the main window. Clicking a button inserts the configured text into the send field. All [variables](Macros-and-Variables#variables) can be used.
+
+---
+
+## Snippet Settings
+
+Text snippets are accessible via:
+
+- **Right-click** on a callsign in the user list
+- **Right-click** in the CQ message table
+- **Right-click** in the PM message table
+- **Keyboard shortcuts**: `Ctrl+1` to `Ctrl+0` for the first 10 snippets
+
+If a callsign is selected in the user list, the snippet is addressed as a direct message:
+`/CQ CALLSIGN <snippet text>`
+
+---
+
+## Beacon Settings
+
+Configure an automatic interval message in the public chat channel. Recommended: use the `MYQRG` variable in the text so the current frequency is always up to date. Interval and text are freely configurable.
+
+> **Tip**: Enable the beacon while calling CQ and quickly disable it in the settings window when not calling.
+
+---
+
+## Messagehandling Settings (from v1.25)
+
+New settings section with the following options:
+
+- **Auto-reply to all incoming messages**: Configurable automatic reply to private messages.
+- **Auto-reply with CQ QRG**: When someone asks for your frequency, KST4Contest automatically replies with the `MYQRG` variable content.
+- **Default filter for the userinfo window**: Pre-configured message filter for the station info panel *(for Gianluca :-) )*.
+
+---
+
+## Worked Station Database Settings
+
+Reset the internal worked database before each contest! Contains:
+
+- Worked status for all stations (per band)
+- NOT-QRV tags (since v1.2)
+
+Use the **"Reinitialize"** button below the table. A planned feature is an automatic expiry time for the worked status.
+
+---
+
+## Dark Mode (from v1.26)
+
+Toggle via the menu: **Window → Use Dark Mode**. Colours can be individually customised via CSS.
+
+---
+
+## Saving Settings
+
+Click **"Save Settings"** after **every** change! Without saving, all changes are lost on next start.
+
+- Storage location: `~/.praktikst/preferences.xml`
+- From v1.21: Window sizes and divider positions are also saved.
+- If you encounter problems: delete the configuration file → KST4Contest creates a new one with default values.
--- a/github_docs/en-DX-Cluster-Server.md
+++ b/github_docs/en-DX-Cluster-Server.md
@@ -0,0 +1,76 @@
+# Built-in DX Cluster Server
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-DX-Cluster-Server)
+
+From **version 1.23**, KST4Contest includes a built-in DX cluster server. It sends spots directly to the logging software whenever a direction warning is triggered.
+
+*(Idea by OM0AAO, Viliam Petrik – thank you!)*
+
+---
+
+## What is the Built-in DX Cluster Server For?
+
+When KST4Contest detects that a station is requesting a sked from your direction and a QRG is known, it **automatically generates a DX cluster spot** and feeds it directly to the logging software's cluster client / band map.
+
+The logging software then displays the spot in the band map. Clicking the spot sets the transceiver's frequency and mode directly – without any manual typing.
+
+---
+
+## Setup
+
+### In KST4Contest
+
+In Preferences → **DX Cluster Server Settings**:
+
+1. Enter the **port** of the internal server (e.g. 7300 or 8000 – must match the logging software).
+2. Enter a **spotter callsign** – **this must be a different callsign than your contest callsign!**
+   - Reason: Logging programs filter spots from your own callsign as "already worked". If the spotter uses the same callsign, the spots will not be displayed.
+3. Enter the **assumed MHz**: For frequency references like ".205" in the chat, KST4Contest needs to decide whether 144.205, 432.205 or 1296.205 is meant. For single-band contests, simply enter the corresponding band centre. Full frequency references like "144.205" or "1296.338" in the chat are always correctly identified.
+
+### In UCXLog
+
+- Configure a DX cluster server connection:
+  - Host: `127.0.0.1` (or IP of the KST4Contest computer)
+  - Port: As configured in KST4Contest
+  - Password: can be left empty
+- Use the **"Send a test message to your log"** button to test the connection.
+
+### In N1MM+
+
+Similar settings:
+- Host: `127.0.0.1` (or IP of the KST4Contest computer)
+- Port: As configured in KST4Contest
+
+---
+
+## How It Works
+
+A spot is generated when **both** conditions are met:
+
+1. A **direction warning** has been triggered (station is making a sked in your direction).
+2. The **station's QRG is known** (read from the chat or manually entered).
+
+The generated spot contains:
+- Station's callsign
+- Frequency
+- Spot time
+
+The logging software can then display the spot in the band map and tune the TRX to that frequency with a mouse click.
+
+---
+
+## Multi-Computer Setup
+
+If KST4Contest runs on a separate computer (not the logging computer):
+
+- Host in the logging software: IP of the KST4Contest computer (not `127.0.0.1`)
+- Same configuration as for the QSO UDP broadcast packets (see [Log Synchronisation](en-Log-Sync))
+
+---
+
+## Tested Logging Software
+
+- **UCXLog** ✓
+- **N1MM+** ✓
+
+Further test reports are welcome – please send by email to DO5AMF.
--- a/github_docs/en-Features.md
+++ b/github_docs/en-Features.md
@@ -0,0 +1,171 @@
+# Features
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Funktionen)
+
+Overview of all main features of KST4Contest.
+
+---
+
+## Sked Direction Highlighting
+
+One of the core features: when a station makes a sked request **towards your direction**, it is highlighted **green and bold** in the user list.
+
+### How does it work?
+
+The calculation is based on the following logic:
+
+- When station A sends a sked request to station B, it is assumed that A is pointing its antenna towards B.
+- If the resulting direction from A to your own station is within half the beamwidth of your own antenna, A is highlighted.
+
+**Example** (beamwidth 69°, half-angle 34.5°):
+
+| Situation | Result for DO5AMF in JN49 |
+|---|---|
+| Sked from F5FEN → DM5M | ✅ Highlighted (F5FEN points towards DM5M, close to JN49) |
+| Sked from DM5M → F5FEN | ✅ Highlighted (DM5M replies towards F5FEN) |
+| F1DBN is uninvolved | ❌ No highlighting |
+| DO5AMF/P (different location) | ❌ No highlighting for sked reply |
+
+The calculation does not include topographic path calculations – this is a deliberate simplification. It may be added in a future version.
+
+> Configuration: [Configuration – Antenna Beamwidth](Configuration#antenna-beamwidth)
+
+---
+
+## Sked Direction Spots (Built-in DX Cluster)
+
+From **v1.23**: Direction warnings are forwarded as DX cluster spots to the logging software when a QRG is known. Details: [DX Cluster Server](en-DX-Cluster-Server).
+
+---
+
+## QRG Detection (QRG Reading)
+
+KST4Contest processes every line of text flowing through the channel and automatically extracts **frequency references**. These are displayed in the user list in the **QRG column**.
+
+Recognised formats: `144.205`, `432.088`, `.205` (with configured band assumption), etc.
+
+**Benefit**: Without asking, you can directly look up a station's calling frequency and decide whether a contact is possible.
+
+---
+
+## Worked Marking
+
+Worked stations are visually marked in the user list – per band. Based on [Log Synchronisation](en-Log-Sync) via UDP or Simplelogfile.
+
+Reset the database before each contest: [Configuration – Worked Station Database Settings](Configuration#worked-station-database-settings).
+
+---
+
+## NOT-QRV Tags (from v1.2)
+
+When a station indicates it is not QRV on a specific band, this can be manually marked:
+
+1. Select the station in the user list.
+2. Right-click → Set NOT-QRV for the appropriate band.
+
+These tags are stored in the internal database and persist after a KST4Contest restart. Can be reset via the settings.
+
+**Benefit**: Prevents repeated sked requests on bands where the station is not active – saves time for both sides.
+
+---
+
+## Direction Filter
+
+Shows only stations in the user list that are located in a specific direction. Toggle using the N / NE / E / SE / S / SW / W / NW buttons or by entering degrees manually.
+
+Useful: While calling CQ in a specific direction, only show stations in that direction.
+
+---
+
+## Distance Filter
+
+Hide stations beyond a maximum distance. The **"Show only QRB [km] <="** button is a toggle.
+
+---
+
+## Worked and NOT-QRV Filter
+
+Toggle buttons (one per band) to hide already-worked stations and/or NOT-QRV-tagged stations. The filter takes effect **immediately** without manually reactivating (live since v1.22).
+
+---
+
+## Coloured PM Rows (from v1.25)
+
+New private messages appear in **red**. The colour fades every 30 seconds from yellow to white – like a rainbow fade. This makes it immediately clear how recent a message is.
+
+*(Idea by IU3OAR, Gianluca Costantino – thank you!)*
+
+---
+
+## PM Catching
+
+Some users accidentally post direct messages publicly, e.g.:
+
+```
+(DM5M) pse ur qrg
+```
+
+KST4Contest detects such messages that contain your own callsign and automatically sorts them into the **private messages table**. No messages are missed this way.
+
+---
+
+## Multi-Channel Login (from v1.26)
+
+Simultaneous login to **two chat categories** (e.g. 144 MHz and 432 MHz). Both chats are monitored in parallel.
+
+---
+
+## Dark Mode (from v1.26)
+
+Toggle via: **Window → Use Dark Mode**
+
+For individual colour adjustments: edit the CSS file (path in the program settings).
+
+---
+
+## Opposite Station Multi-Callsign Login Tagging (from v1.26)
+
+Support for stations that are active in the chat with multiple callsigns simultaneously (e.g. expedition setups).
+
+---
+
+## QRZ.com and QRZ-CQ Profile Buttons (from v1.24)
+
+For selected stations in the user list, there are direct buttons to open the **QRZ.com profile** and the **QRZ-CQ profile** in the browser.
+
+---
+
+## Sked Reminders (Sked Reminder Service)
+
+For agreed skeds, automatic reminder PMs can be configured, sent X minutes before the agreed time. Reminders are activated from the FurtherInfo panel.
+
+---
+
+## Priority List / Score Service
+
+KST4Contest automatically calculates a **priority list** of the most interesting contacts, based on:
+
+- Direction detection
+- QRB (distance)
+- AP availability (AirScout)
+- Worked status
+
+The top candidates are shown in a separate list, helping you not to miss the most important stations during contest stress.
+
+---
+
+## Interval Beacon
+
+Automatic CQ messages in the public channel at a configurable interval. Recommended: use the `MYQRG` variable so the current frequency is always accurate. Details: [Configuration – Beacon Settings](Configuration#beacon-settings).
+
+---
+
+## Simplelogfile
+
+File-based log evaluation using regex. Details: [Log Synchronisation](Log-Sync#method-1-universal-file-based-callsign-interpreter-simplelogfile).
+
+---
+
+## Cluster & QSO of Others
+
+A separate window showing the QSO flow between other stations. Particularly interesting during quieter night-time hours of a contest. This window can be minimised when not needed. Future plan: filtering to stations in your selected QTF.
--- a/github_docs/en-Home.md
+++ b/github_docs/en-Home.md
@@ -0,0 +1,51 @@
+# KST4Contest – Wiki
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Home)
+
+**KST4Contest** (also known as *PraktiKST*) is a Java-based chat client for the [ON4KST Chat](http://www.on4kst.info/chat/), specifically designed for contest operation on the VHF/UHF/SHF bands (144 MHz and above).
+
+Developed by **DO5AMF (Marc Fröhlich)**, operator at DM5M.
+
+---
+
+## Quick Navigation
+
+| Page | Contents |
+|---|---|
+| [Installation](en-Installation) | Download, Java requirements, updates |
+| [Configuration](en-Configuration) | All settings in detail |
+| [Log Synchronisation](en-Log-Sync) | UCXLog, N1MM+, QARTest, DXLog.net, WinTest |
+| [AirScout Integration](en-AirScout-Integration) | Aircraft scatter detection |
+| [DX Cluster Server](en-DX-Cluster-Server) | Built-in DX cluster for your logging software |
+| [Features](en-Features) | All features at a glance |
+| [Macros and Variables](en-Macros-and-Variables) | Text snippets, shortcuts, variables |
+| [User Interface](en-User-Interface) | UI explained and how to operate it |
+| [Changelog](en-Changelog) | Version history |
+
+---
+
+## What is KST4Contest?
+
+The ON4KST Chat is the de-facto standard for skeds on the 144 MHz and higher bands. KST4Contest enhances the chat experience with contest-specific features:
+
+- **Worked marking**: Stations already worked are highlighted visually, synchronised directly from your logging software via UDP.
+- **Sked direction detection**: When a station calls another one from your direction, it is highlighted green and bold.
+- **QRG detection**: KST4Contest automatically reads frequencies from the chat traffic and shows them in the user list.
+- **AirScout interface**: Reflectable aircraft are shown directly in the user list.
+- **Built-in DX cluster server**: Spots are sent directly to your logging software.
+- **Dark mode** (from v1.26): Easy on the eyes during night-time operation.
+- **Multi-channel login** (from v1.26): Simultaneously logged into two chat categories.
+
+---
+
+## Contact & Support
+
+- **Email**: praktimarc+kst4contest@gmail.com *(for kst4contest topics only)*
+- **GitHub**: https://github.com/praktimarc/kst4contest
+- **Download**: https://do5amf.funkerportal.de/
+
+---
+
+## Acknowledgements
+
+Special thanks to: Gianluca Costantino (IU3OAR), Alessandro Murador (IZ3VTH), Reczetár István (HA1FV), OM0AAO (Viliam Petrik, DX cluster idea), DC9DJ (Konrad Neitzel, project structure), DO5ALF (Andreas, webmaster funkerportal.de), PE0WGA (Franz van Velzen, tester) and all other testers and contributors.
--- a/github_docs/en-Installation.md
+++ b/github_docs/en-Installation.md
@@ -0,0 +1,83 @@
+# Installation
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Installation)
+
+## Prerequisites
+
+### Java
+
+KST4Contest is a Java application. A current **Java Runtime Environment (JRE)** is required. The recommended version is Java 17 or higher.
+
+### ON4KST Account
+
+To use the chat client, you need a registered account with the ON4KST chat service:
+
+- Register at: http://www.on4kst.info/chat/register.php
+
+### Behavioural Etiquette
+
+The official language in the ON4KST Chat is **English**. Please use English even when communicating with stations from your own country. Common HAM abbreviations (agn, dir, pse, rrr, tnx, 73 …) are widely used and understood.
+
+### Sending Personal Messages
+
+To send a private message to another station, always use this format:
+
+```
+/CQ CALLSIGN message text
+```
+
+Example: `/CQ DL5ASG pse sked 144.205?`
+
+During contest operation (5–6 messages per second in the public channel), public messages directed at a specific callsign are easily missed. KST4Contest also catches such messages if they are accidentally posted publicly (see [Features – PM Catching](Features#pm-catching)).
+
+---
+
+## Download
+
+The latest version can be downloaded as a ZIP file:
+
+**https://do5amf.funkerportal.de/**
+
+The filename follows the pattern `kst4Contest_v<version>.zip`.
+
+---
+
+## Installation
+
+1. Download the ZIP file.
+2. Unzip into a folder of your choice.
+3. Run `praktiKST.exe` (Windows) or the corresponding start script.
+
+Settings are stored at `%USERPROFILE%\.praktikst\preferences.xml` (Windows).
+
+---
+
+## Updating
+
+KST4Contest includes an **automatic update notification service**: when a new version is available, a window will appear at startup showing:
+- A notification that a new version is available
+- A changelog
+- The download link for the latest package
+
+### Update Process
+
+Currently the only way to update is:
+
+1. Delete the old folder.
+2. Unzip the new package.
+
+Your settings file (`preferences.xml`) is preserved since it is stored in your user folder, not the program folder.
+
+---
+
+## Known Issues at Startup
+
+### Norton 360
+
+Norton 360 flags `praktiKST.exe` as dangerous (false positive). You need to add an exception:
+
+1. Open Norton 360.
+2. Security → History → Find the relevant event.
+3. Select "Restore & Add Exception".
+
+*(Reported by PE0WGA, Franz van Velzen – thank you!)*
--- a/github_docs/en-Log-Sync.md
+++ b/github_docs/en-Log-Sync.md
@@ -0,0 +1,111 @@
+# Log Synchronisation
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Log-Synchronisation)
+
+KST4Contest automatically marks worked stations in the chat user list. Two basic methods are available:
+
+---
+
+## Method 1: Universal File Based Callsign Interpreter (Simplelogfile)
+
+KST4Contest reads a log file and searches for callsign patterns using a regular expression. Binary log files are also supported – unreadable binary content is simply ignored.
+
+**Advantage**: Works with almost any logging program that writes a file.
+**Disadvantage**: No band information available – stations are only marked as "worked", not on which band.
+
+Enter the path to the log file in the Preferences. The file is only read, never modified (read-only).
+
+> **Tip**: The Simplelogfile function can also be used to mark stations that are definitely unreachable (e.g. personal notes). This will be replaced in a later version by a better tagging system.
+
+---
+
+## Method 2: Network Listener (UDP Broadcast) – Recommended
+
+When saving a QSO, the logging software sends a UDP packet to the broadcast address of the home network. KST4Contest receives this packet and marks the station including **band information** in its internal SQLite database.
+
+> **Important**: KST4Contest must be **running in parallel with the logging software**. QSOs logged while KST4Contest is not running will not be captured – except with QARTest (which can send the complete log).
+
+**Default UDP port**: 12060 (matches the default of most logging programs)
+
+---
+
+## Supported Logging Software
+
+### UCXLog (DL7UCX)
+
+UCXLog sends QSO UDP packets and transceiver frequency packets.
+
+**Settings in UCXLog:**
+- Enable UDP broadcast
+- Enter the IP address of the KST4Contest computer (for local operation: `127.0.0.1`)
+- Port: 12060 (default)
+
+Note the green-highlighted fields in the UCXLog settings: IP and port must be filled in.
+
+Note for multi-setup (2 computers, 2 radios, one KST4Contest instance): Both logging programs must send QSO packets to the IP of the KST4Contest computer. In this case, at least one IP is not `127.0.0.1`.
+
+### QARTest (IK3QAR)
+
+**Special feature**: QARTest can send the **complete log** to KST4Contest (button "Invia log completo" in the QARTest settings). This means QSOs logged before KST4Contest was started are also captured.
+
+**Settings in QARTest:**
+- Configure UDP broadcast and IP/port as with UCXLog
+- Use "Invia log completo" for a full log upload
+
+*(„Buona funzionalità caro IK3QAR!" – DO5AMF)*
+
+### N1MM+
+
+**Settings in N1MM+:**
+
+In N1MM+ under `Config → Configure Ports, Mode Control, Winkey, etc. → Broadcast Data`:
+- Enable `Radio Info` (for TRX sync / QRG)
+- Enable `Contact Info` (for QSO sync)
+- IP: `127.0.0.1` (or IP of the KST4Contest computer)
+- Port: 12060
+
+For the built-in DX cluster server: configure N1MM+ as a DX cluster client (server: `127.0.0.1`, port as set in KST4Contest).
+
+### DXLog.net
+
+**Settings in DXLog.net:**
+- Enable UDP broadcast
+- Enter the IP of the KST4Contest computer (green-highlighted fields)
+- Port: 12060
+
+### WinTest
+
+WinTest is also supported. KST4Contest receives WinTest UDP packets via a dedicated listener. Configuration is analogous to the other programs.
+
+---
+
+## TRX Frequency Synchronisation
+
+In addition to QSO synchronisation, UCXLog and other programs also transmit the **current transceiver frequency** via UDP. KST4Contest processes this information and makes it available as the `MYQRG` variable.
+
+**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.
+
+> **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.
+
+---
+
+## Multi-Setup: 2 Radios, 2 Computers
+
+For DM5M-style setups (2 radios, 2 computers, one KST4Contest instance or two separate):
+
+**Option A – One shared KST4Contest instance:**
+- Both logging programs send QSO packets to the IP of the KST4Contest computer
+- Only one logging program sends frequency packets (recommended: the VHF logging program)
+
+**Option B – Two separate KST4Contest instances (recommended):**
+- Each logging program communicates with its own KST4Contest instance via `127.0.0.1`
+- Two separate chat logins
+- Better separation and fewer conflicts
+
+---
+
+## Internal Database
+
+KST4Contest stores worked information in an internal **SQLite database**. This is independent of the logging program's database and is only populated via the UDP broadcast.
+
+Before each new contest: reset the database! → [Configuration – Worked Station Database Settings](Configuration#worked-station-database-settings)
--- a/github_docs/en-Macros-and-Variables.md
+++ b/github_docs/en-Macros-and-Variables.md
@@ -0,0 +1,162 @@
+# Macros and Variables
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Makros-und-Variablen)
+
+KST4Contest offers a flexible system of text snippets, shortcuts and built-in variables that significantly speed up the chat workflow during contests.
+
+---
+
+## Overview
+
+| Type | Access | Purpose |
+|---|---|---|
+| **Shortcuts** | Button in the toolbar | Quick text insert into the send field |
+| **Snippets** | Right-click / Ctrl+1..0 | Text building blocks, optional PM sending |
+| **Variables** | Usable in all text fields | Dynamic values (QRG, locator, AP data) |
+
+---
+
+## Shortcuts (Quick-Access Buttons)
+
+Configurable in Preferences → **Shortcut Settings**.
+
+- Each configured text creates **one button** in the user interface.
+- Clicking a button inserts the text into the **send field**.
+- **All variables** can be used in shortcuts and are resolved immediately when inserted.
+- Longer texts are also possible.
+
+**Tip**: Set up frequently used abbreviations like "pse", "rrr", "tnx", "73" as shortcuts.
+
+---
+
+## Snippets (Text Building Blocks)
+
+Configurable in Preferences → **Snippet Settings**.
+
+### Access
+
+- **Right-click** on a callsign in the user list
+- **Right-click** in the CQ message table
+- **Right-click** in the PM message table
+- **Keyboard shortcuts**: `Ctrl+1` to `Ctrl+0` for the first 10 snippets
+
+### Behaviour with a Selected Callsign
+
+When a callsign is selected in the user list, the snippet is addressed as a **private message**:
+
+```
+/CQ CALLSIGN <snippet text>
+```
+
+Then **Enter** can be pressed to send directly – even if the send field does not have focus.
+
+### Hardware Macro Keyboard
+
+*(Idea by IU3OAR, Gianluca Costantino)*
+
+The key combinations `Ctrl+1` to `Ctrl+0` can be assigned to a programmable macro keyboard. One key press triggers the snippet, another press (mapped to Enter) sends it immediately. In contest operation this saves considerable time.
+
+### Predefined Default Snippets
+
+On first start, some snippets are pre-configured, e.g.:
+
+- `Hi OM, try sked?`
+- `I am calling cq ur dir, pse lsn to me at MYQRG`
+- `pse ur qrg?`
+- `rrr, I move to your qrg nw, pse ant dir me`
+
+These can be customised or deleted in the Preferences.
+
+---
+
+## Variables
+
+Variables in written texts (snippets, shortcuts, beacon, send field) are replaced by their current values at runtime. Simply type the variable name in **uppercase** in the text.
+
+### MYQRG
+
+Replaced by the current transceiver frequency.
+
+- Source: TRX sync via UDP from the logging software (if enabled)
+- Fallback: Manually entered value in the MYQRG text field to the right of the send button
+- Format: `144.388.03`
+
+**Example**: `calling cq at MYQRG` → `calling cq at 144.388.03`
+
+### MYQRGSHORT
+
+Like MYQRG, but only the first 7 characters.
+
+- Format: `144.388`
+
+**Example**: `qrg: MYQRGSHORT` → `qrg: 144.388`
+
+### MYLOCATOR
+
+Replaced by your own Maidenhead locator (6 characters).
+
+- Format: `JO51IJ`
+
+**Example**: `my loc: MYLOCATOR` → `my loc: JO51IJ`
+
+### MYLOCATORSHORT
+
+Like MYLOCATOR, but only the first 4 characters.
+
+- Format: `JO51`
+
+**Example**: `loc: MYLOCATORSHORT` → `loc: JO51`
+
+### QRZNAME
+
+Replaced by the **name** of the currently selected station from the chat name field.
+
+**Example**: `Hi QRZNAME, sked?` → `Hi Gianluca, sked?`
+
+### FIRSTAP
+
+Replaced by data of the first reflectable aircraft to the selected station (if available).
+
+- Condition: AirScout is active and an aircraft is available.
+- Example format: `a very big AP in 1 min`
+
+**Example**: `AP info: FIRSTAP` → `AP info: a very big AP in 1 min`
+
+### SECONDAP
+
+Like FIRSTAP, but for the second available aircraft.
+
+- Example format: `Next big AP in 9 min`
+
+**Example**: `also: SECONDAP` → `also: Next big AP in 9 min`
+
+### MYQTF *(planned for v1.3)*
+
+Replaced by the current antenna direction in words (e.g. `north`, `north east`, `east`, …).
+
+- Source: Degree value in the MYQTF input field (to the right of the MYQRG field)
+
+---
+
+## Variables in the Beacon
+
+All variables can also be used in the **automatic beacon** (interval messages). Recommended beacon configuration:
+
+```
+calling cq at MYQRG, loc MYLOCATOR, GL all!
+```
+
+Since KST4Contest automatically reads QRG data from chat messages: if other stations also use KST4Contest, they will immediately see your QRG in the QRG column of their user list.
+
+---
+
+## Example Contest Workflow with Macros
+
+1. Select a station in the user list → callsign is now pre-selected.
+2. Press `Ctrl+1` → Snippet "Hi OM, try sked?" is addressed as a PM.
+3. Press Enter → Message sent.
+4. Station replies with frequency → QRG column is automatically filled.
+5. Press `Ctrl+2` → Snippet "I am calling cq ur dir, pse lsn to me at 144.388" (MYQRG resolved).
+6. Press Enter → Sent.
+
+No manual typing, no errors, no interruption to CQ calling.
--- a/github_docs/en-User-Interface.md
+++ b/github_docs/en-User-Interface.md
@@ -0,0 +1,105 @@
+# User Interface
+
+> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Benutzeroberflaeche)
+
+## Connecting to the Chat
+
+1. Select a **chat category** in the settings window (e.g. 144 MHz VHF, 432 MHz UHF, …).
+2. Click the **Connect** button.
+3. Wait for the connection to be established.
+
+> Disconnecting and reconnecting is only possible via the settings window. It is therefore recommended to keep the settings window open.
+
+---
+
+## Main Window Overview
+
+The main window consists of several areas:
+
+### PM Window (top left)
+
+Shows all received **private messages** as well as intercepted public messages containing your own callsign. New messages appear in **red** and fade every 30 seconds from yellow to white.
+
+### User List (Chat Members)
+
+The central table of all currently active chat users. Columns (depending on configuration):
+
+| Column | Content |
+|---|---|
+| Call | Station's callsign |
+| Name | Name from the chat name field |
+| Loc | Maidenhead locator |
+| QRB | Distance in km |
+| QTF | Direction in degrees |
+| QRG | Automatically detected frequency |
+| AP | AirScout aircraft data (when active) |
+| Band colours | Worked / NOT-QRV status per band |
+
+**Sorting**: Click column headers. QRB sorting is numerical (corrected in v1.22).
+
+### Send Field
+
+Text input for outgoing messages. After clicking a callsign in the user list, the send field automatically receives focus – start typing immediately without double-clicking (from v1.22).
+
+### MYQRG Field
+
+To the right of the send button. Shows the current own QRG, can also be entered manually.
+
+### MYQTF Field *(for v1.3)*
+
+Input field for the current antenna direction. Used for the planned `MYQTF` variable.
+
+---
+
+## Filters
+
+The filter bar (from v1.21 as a flowpane for small screens):
+
+- **Show only QTF**: Activate direction filter (N/NE/E/… buttons or degree input)
+- **Show only QRB [km] <=**: Activate distance filter (toggle button)
+- **Hide Worked [Band]**: Hide worked stations per band (one toggle per band)
+- **Hide NOT-QRV [Band]**: Hide NOT-QRV-tagged stations per band
+
+---
+
+## Station Info Panel (Further Info)
+
+Bottom right: Shows all messages of a selected station (CQ messages and PMs in one panel). A message filter can be pre-configured via the default filter in the Preferences.
+
+**Sked reminders** can also be activated here.
+
+---
+
+## Priority List
+
+Shows the top candidates calculated by the Score Service. Updates automatically in the background based on direction, distance and AP availability.
+
+---
+
+## Cluster & QSO of Others
+
+Separate window (can be minimised). Shows the communication flow between other stations – interesting during quieter contest periods.
+
+---
+
+## Menu
+
+### Window
+- **Use Dark Mode** (from v1.26): Toggle dark colour scheme on/off.
+
+---
+
+## Window Sizes and Dividers
+
+From **v1.21**, clicking **"Save Settings"** also saves window sizes and divider positions of all panels in the configuration file, which are restored on the next start.
+
+If you encounter display problems: delete the configuration file → KST4Contest creates new default values.
+
+---
+
+## Operating Tips
+
+- **Keep the settings window open**: Quick access to enable/disable the beacon.
+- **Right-click in the user list**: Opens the snippet menu and further actions (QRZ.com profile, set NOT-QRV tags).
+- **Enter from anywhere**: When text is in the send field, Enter sends directly – even if the focus is elsewhere.
+- **Stop the beacon**: Switch off the beacon while scanning frequencies to avoid flooding the chat with messages.