Compare commits
18 Commits
1f3aa031c3
...
fix-crash-
| Author | SHA1 | Date | |
|---|---|---|---|
| ced79fefd2 | |||
| c7311a5966 | |||
|
|
071ea800ae | ||
| e01cc3ca11 | |||
| aaa5c1088a | |||
| 178783aa8c | |||
| 68d171e793 | |||
| e4501e848a | |||
| b16dd1303a | |||
| e5b30c3049 | |||
| 318f3720b8 | |||
| db031bb5e3 | |||
| d635ee3fef | |||
| f93f3acbb0 | |||
| 9ec17332e2 | |||
| 6716751697 | |||
| d5b8508aa6 | |||
| c0b8aa61a9 |
258
.github/latex-manual/manual-template.tex
vendored
Normal file
@@ -0,0 +1,258 @@
|
||||
%% ============================================================
|
||||
%% KST4Contest – pandoc LaTeX manual template
|
||||
%% PDF engine: XeLaTeX
|
||||
%% Usage: pandoc --template=manual-template.tex --pdf-engine=xelatex
|
||||
%% ============================================================
|
||||
\documentclass[11pt,a4paper]{article}
|
||||
|
||||
%% ─── Font / encoding ──────────────────────────────────────────────────────
|
||||
\usepackage{fontspec}
|
||||
% Latin Modern handles all Western European characters (umlauts etc.)
|
||||
\defaultfontfeatures{Ligatures=TeX,Scale=MatchLowercase}
|
||||
|
||||
%% ─── Language ─────────────────────────────────────────────────────────────
|
||||
\usepackage{polyglossia}
|
||||
$if(polyglossia-lang)$
|
||||
\setmainlanguage{$polyglossia-lang$}
|
||||
$else$
|
||||
\setmainlanguage{english}
|
||||
$endif$
|
||||
|
||||
%% ─── Page layout ──────────────────────────────────────────────────────────
|
||||
\usepackage[a4paper, top=2.5cm, bottom=2.5cm, left=2.5cm, right=2.5cm]{geometry}
|
||||
|
||||
%% ─── Text decorations (strikethrough via ~~...~~ in Markdown → \st{}) ────
|
||||
\usepackage{soul}
|
||||
|
||||
%% ─── Colors ───────────────────────────────────────────────────────────────
|
||||
\usepackage[dvipsnames,svgnames,x11names]{xcolor}
|
||||
\definecolor{brand-green}{RGB}{7,166,54}
|
||||
\definecolor{link-blue}{RGB}{0,86,163}
|
||||
\definecolor{code-bg}{RGB}{245,247,250}
|
||||
\definecolor{code-border}{RGB}{180,200,225}
|
||||
\definecolor{blockquote-line}{RGB}{7,166,54}
|
||||
|
||||
%% ─── Hyperlinks ───────────────────────────────────────────────────────────
|
||||
\usepackage{hyperref}
|
||||
\hypersetup{
|
||||
colorlinks = true,
|
||||
linkcolor = link-blue,
|
||||
urlcolor = link-blue,
|
||||
filecolor = link-blue,
|
||||
citecolor = link-blue,
|
||||
pdftitle = {$title$},
|
||||
pdfauthor = {DO5AMF (Marc Fröhlich), DN9APW (Philipp Wagner)},
|
||||
pdfsubject = {KST4Contest User Manual},
|
||||
pdfkeywords = {KST4Contest, pratiKST, VHF, Contest, Ham Radio},
|
||||
bookmarks = true,
|
||||
bookmarksnumbered = true,
|
||||
bookmarksopen = true,
|
||||
bookmarksopenlevel = 2,
|
||||
pdfpagemode = UseOutlines,
|
||||
}
|
||||
|
||||
%% ─── Graphics ─────────────────────────────────────────────────────────────
|
||||
\usepackage{graphicx}
|
||||
\graphicspath{{./}{./github_docs/}}
|
||||
\makeatletter
|
||||
\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth\else\Gin@nat@width\fi}
|
||||
\def\maxheight{\ifdim\Gin@nat@height>0.65\textheight 0.65\textheight\else\Gin@nat@height\fi}
|
||||
\makeatother
|
||||
\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
|
||||
|
||||
%% ─── Tables ───────────────────────────────────────────────────────────────
|
||||
\usepackage{longtable}
|
||||
\usepackage{booktabs}
|
||||
\usepackage{array}
|
||||
\usepackage{calc}
|
||||
\usepackage{multirow}
|
||||
\setlength{\tabcolsep}{8pt}
|
||||
\renewcommand{\arraystretch}{1.35}
|
||||
% Pandoc pipe-table helpers
|
||||
\newcolumntype{L}[1]{>{\raggedright\arraybackslash}p{#1}}
|
||||
\newcolumntype{C}[1]{>{\centering\arraybackslash}p{#1}}
|
||||
\newcolumntype{R}[1]{>{\raggedleft\arraybackslash}p{#1}}
|
||||
|
||||
%% ─── Lists ────────────────────────────────────────────────────────────────
|
||||
\providecommand{\tightlist}{%
|
||||
\setlength{\itemsep}{2pt}\setlength{\parskip}{0pt}}
|
||||
|
||||
%% ─── Code blocks (--listings flag) ───────────────────────────────────
|
||||
\usepackage{listings}
|
||||
\lstset{
|
||||
basicstyle = \ttfamily\small,
|
||||
backgroundcolor = \color{code-bg},
|
||||
frame = single,
|
||||
framesep = 4pt,
|
||||
rulecolor = \color{code-border},
|
||||
breaklines = true,
|
||||
breakatwhitespace= false,
|
||||
showstringspaces = false,
|
||||
extendedchars = true,
|
||||
xleftmargin = 6pt,
|
||||
xrightmargin = 6pt,
|
||||
aboveskip = 8pt,
|
||||
belowskip = 8pt,
|
||||
literate = {→}{{\ensuremath{\rightarrow}}}1
|
||||
{←}{{\ensuremath{\leftarrow}}}1
|
||||
{↔}{{\ensuremath{\leftrightarrow}}}1,
|
||||
}
|
||||
|
||||
%% ─── Blockquotes ──────────────────────────────────────────────────────────
|
||||
\usepackage{mdframed}
|
||||
\newmdenv[
|
||||
topline = false,
|
||||
rightline = false,
|
||||
bottomline = false,
|
||||
leftline = true,
|
||||
linewidth = 3pt,
|
||||
linecolor = blockquote-line,
|
||||
backgroundcolor = code-bg,
|
||||
leftmargin = 0pt,
|
||||
rightmargin = 0pt,
|
||||
innerleftmargin = 12pt,
|
||||
innerrightmargin = 8pt,
|
||||
innertopmargin = 6pt,
|
||||
innerbottommargin= 6pt,
|
||||
skipabove = 8pt,
|
||||
skipbelow = 8pt,
|
||||
]{blockquotebox}
|
||||
|
||||
\renewenvironment{quote}
|
||||
{\begin{blockquotebox}\small\itshape}
|
||||
{\end{blockquotebox}}
|
||||
|
||||
%% ─── Section styling ──────────────────────────────────────────────────────
|
||||
\usepackage{titlesec}
|
||||
|
||||
\titleformat{\section}
|
||||
{\Large\bfseries\color{brand-green}}
|
||||
{}
|
||||
{0em}
|
||||
{}
|
||||
[\color{brand-green}\titlerule]
|
||||
\titlespacing{\section}{0pt}{20pt}{10pt}
|
||||
|
||||
\titleformat{\subsection}
|
||||
{\large\bfseries\color{brand-green}}
|
||||
{}
|
||||
{0em}
|
||||
{}
|
||||
\titlespacing{\subsection}{0pt}{14pt}{6pt}
|
||||
|
||||
\titleformat{\subsubsection}
|
||||
{\normalsize\bfseries}
|
||||
{}
|
||||
{0em}
|
||||
{}
|
||||
\titlespacing{\subsubsection}{0pt}{10pt}{4pt}
|
||||
|
||||
% Level 4 (####): displayed as a named block heading in dark-grey
|
||||
\titleformat{\paragraph}
|
||||
{\normalsize\bfseries\color{brand-green}}
|
||||
{}
|
||||
{0em}
|
||||
{}
|
||||
\titlespacing{\paragraph}{0pt}{8pt}{2pt}
|
||||
|
||||
% Level 5 (#####): slightly smaller, italic, lighter grey
|
||||
\titleformat{\subparagraph}
|
||||
{\small\bfseries\itshape\color{brand-green!85!black}}
|
||||
{}
|
||||
{0em}
|
||||
{}
|
||||
\titlespacing{\subparagraph}{0pt}{6pt}{1pt}
|
||||
|
||||
% Reserve two additional section levels for future use (###### and deeper).
|
||||
% Pandoc currently maps up to \subparagraph for standard Markdown headings.
|
||||
\titleclass{\subsubsubsection}{straight}[\subparagraph]
|
||||
\newcounter{subsubsubsection}[subparagraph]
|
||||
\renewcommand\thesubsubsubsection{\thesubparagraph.\arabic{subsubsubsection}}
|
||||
\titleformat{\subsubsubsection}
|
||||
{\small\bfseries\color{brand-green!75!black}}
|
||||
{}
|
||||
{0em}
|
||||
{}
|
||||
\titlespacing{\subsubsubsection}{0pt}{5pt}{1pt}
|
||||
|
||||
\titleclass{\subsubsubsubsection}{straight}[\subsubsubsection]
|
||||
\newcounter{subsubsubsubsection}[subsubsubsection]
|
||||
\renewcommand\thesubsubsubsubsection{\thesubsubsubsection.\arabic{subsubsubsubsection}}
|
||||
\titleformat{\subsubsubsubsection}
|
||||
{\small\itshape\color{brand-green!65!black}}
|
||||
{}
|
||||
{0em}
|
||||
{}
|
||||
\titlespacing{\subsubsubsubsection}{0pt}{4pt}{1pt}
|
||||
|
||||
\setcounter{secnumdepth}{6}
|
||||
\setcounter{tocdepth}{6}
|
||||
|
||||
%% ─── Header / Footer ──────────────────────────────────────────────────────
|
||||
\usepackage{fancyhdr}
|
||||
\pagestyle{fancy}
|
||||
\fancyhf{}
|
||||
\fancyhead[L]{\small\color{brand-green}\textbf{KST4Contest}}
|
||||
\fancyhead[R]{\small\color{brand-green}$if(version)$$version$$endif$}
|
||||
\fancyfoot[L]{\small\color{gray}DO5AMF \textbar\ DN9APW}
|
||||
\fancyfoot[C]{\small\color{gray}\thepage}
|
||||
\fancyfoot[R]{\small\color{gray}$title$}
|
||||
\renewcommand{\headrulewidth}{0.4pt}
|
||||
\renewcommand{\footrulewidth}{0.3pt}
|
||||
\renewcommand{\headrule}{\color{brand-green}\hrule width\headwidth height\headrulewidth}
|
||||
|
||||
%% ─── Paragraph spacing ────────────────────────────────────────────────────
|
||||
\usepackage{parskip}
|
||||
\setlength{\parskip}{6pt}
|
||||
\setlength{\parindent}{0pt}
|
||||
|
||||
%% ─── TOC styling ──────────────────────────────────────────────────────────
|
||||
\usepackage{tocloft}
|
||||
\renewcommand{\cfttoctitlefont}{\Large\bfseries\color{brand-green}}
|
||||
\renewcommand{\cftsecfont}{\bfseries\color{brand-green}}
|
||||
\renewcommand{\cftsecpagefont}{\bfseries\color{brand-green}}
|
||||
\renewcommand{\cftsubsecfont}{\color{brand-green}}
|
||||
\renewcommand{\cftsubsecpagefont}{\color{brand-green}}
|
||||
\renewcommand{\cftsubsubsecfont}{\color{brand-green!85!black}}
|
||||
\renewcommand{\cftsubsubsecpagefont}{\color{brand-green!85!black}}
|
||||
\renewcommand{\cftparafont}{\color{brand-green!75!black}}
|
||||
\renewcommand{\cftparapagefont}{\color{brand-green!75!black}}
|
||||
\renewcommand{\cftsubparafont}{\color{brand-green!65!black}}
|
||||
\renewcommand{\cftsubparapagefont}{\color{brand-green!65!black}}
|
||||
\setlength{\cftbeforesecskip}{4pt}
|
||||
|
||||
%% ─── Misc ─────────────────────────────────────────────────────────────────
|
||||
\usepackage{amsmath}
|
||||
\usepackage{microtype}
|
||||
% Pandoc helper macros
|
||||
\newcommand{\passthrough}[1]{#1}
|
||||
|
||||
%% ══════════════════════════════════════════════════════════════════════════
|
||||
\begin{document}
|
||||
|
||||
%% ─── Title page ───────────────────────────────────────────────────────────
|
||||
\begin{titlepage}
|
||||
\pagecolor{brand-green}
|
||||
\centering
|
||||
\vspace*{3.5cm}
|
||||
{\fontsize{52}{62}\selectfont\bfseries\color{white}KST4Contest}\\[0.4cm]
|
||||
{\fontsize{22}{28}\selectfont\color{white!75!brand-green}pratiKST (ON4KST Chat Client)}\\[2.8cm]
|
||||
\color{white!40!brand-green}\rule{10cm}{0.6pt}\\[1.8cm]
|
||||
{\LARGE\bfseries\color{white}$title$}\\[1cm]
|
||||
$if(version)${\large\color{white!80!brand-green}Version:\space$version$}\\[0.6cm]$endif$
|
||||
\vfill
|
||||
{\large\color{white}DO5AMF · Marc Fröhlich · DM5M · DN9APW · Philipp Wagner}\\[0.4cm]
|
||||
{\color{white!70!brand-green}\today}\\[2cm]
|
||||
\end{titlepage}
|
||||
|
||||
\pagecolor{white}
|
||||
\newpage
|
||||
|
||||
%% ─── Table of Contents ────────────────────────────────────────────────────
|
||||
\tableofcontents
|
||||
\newpage
|
||||
|
||||
%% ─── Main content ─────────────────────────────────────────────────────────
|
||||
$body$
|
||||
|
||||
\end{document}
|
||||
156
.github/latex-manual/strip-wiki-links.lua
vendored
Normal file
@@ -0,0 +1,156 @@
|
||||
--[[
|
||||
strip-wiki-links.lua – pandoc Lua filter for KST4Contest documentation
|
||||
-----------------------------------------------------------------------
|
||||
1. Removes language-switch blockquotes (GitHub Wiki navigation) that
|
||||
are not relevant in the printed PDF manual.
|
||||
2. Converts internal GitHub-wiki-style links to in-document anchors
|
||||
so links jump within the generated PDF.
|
||||
3. Replaces flag emoji and other symbols that XeLaTeX cannot render with
|
||||
plain-text equivalents.
|
||||
--]]
|
||||
|
||||
local PAGE_ANCHOR_MAP = {
|
||||
["de-Home"] = "kst4contest-wiki",
|
||||
["de-Installation"] = "installation",
|
||||
["de-Konfiguration"] = "konfiguration",
|
||||
["de-Funktionen"] = "funktionen",
|
||||
["de-Benutzeroberflaeche"] = "benutzeroberflache",
|
||||
["de-Makros-und-Variablen"] = "makros-und-variablen",
|
||||
["de-Log-Synchronisation"] = "log-synchronisation",
|
||||
["de-AirScout-Integration"] = "airscout-integration",
|
||||
["de-DX-Cluster-Server"] = "integrierter-dx-cluster-server",
|
||||
["de-Changelog"] = "changelog",
|
||||
|
||||
["en-Home"] = "kst4contest-wiki",
|
||||
["en-Installation"] = "installation",
|
||||
["en-Configuration"] = "configuration",
|
||||
["en-Features"] = "features",
|
||||
["en-User-Interface"] = "user-interface",
|
||||
["en-Macros-and-Variables"] = "macros-and-variables",
|
||||
["en-Log-Sync"] = "log-synchronisation",
|
||||
["en-AirScout-Integration"] = "airscout-integration",
|
||||
["en-DX-Cluster-Server"] = "built-in-dx-cluster-server",
|
||||
["en-Changelog"] = "changelog",
|
||||
|
||||
["Installation"] = "installation",
|
||||
["Konfiguration"] = "konfiguration",
|
||||
["Funktionen"] = "funktionen",
|
||||
["Benutzeroberflaeche"] = "benutzeroberflache",
|
||||
["Makros-und-Variablen"] = "makros-und-variablen",
|
||||
["Log-Synchronisation"] = "log-synchronisation",
|
||||
["AirScout-Integration"] = "airscout-integration",
|
||||
["DX-Cluster-Server"] = "integrierter-dx-cluster-server",
|
||||
["Changelog"] = "changelog",
|
||||
|
||||
["Configuration"] = "configuration",
|
||||
["Features"] = "features",
|
||||
["User-Interface"] = "user-interface",
|
||||
["Macros-and-Variables"] = "macros-and-variables",
|
||||
["Log-Sync"] = "log-synchronisation",
|
||||
}
|
||||
|
||||
local function normalize_anchor(text)
|
||||
local s = text:lower()
|
||||
s = s:gsub("%%20", "-")
|
||||
s = s:gsub("ä", "a"):gsub("ö", "o"):gsub("ü", "u"):gsub("ß", "ss")
|
||||
s = s:gsub("[^%w%s%-_]", "")
|
||||
s = s:gsub("[_%s]+", "-")
|
||||
s = s:gsub("%-+", "-")
|
||||
s = s:gsub("^%-", ""):gsub("%-$", "")
|
||||
return s
|
||||
end
|
||||
|
||||
local function normalize_page_key(page)
|
||||
local key = page:gsub("^%./", ""):gsub("^/", "")
|
||||
key = key:gsub("^github_docs/", "")
|
||||
key = key:gsub("%.md$", "")
|
||||
return key
|
||||
end
|
||||
|
||||
local function resolve_page_anchor(page)
|
||||
local key = normalize_page_key(page)
|
||||
return PAGE_ANCHOR_MAP[key] or normalize_anchor(key)
|
||||
end
|
||||
|
||||
local function convert_url_token(token)
|
||||
local url, trailing = token:match("^(https?://%S-)([%.%,%;%:%!%?]?)$")
|
||||
if not url then
|
||||
return nil
|
||||
end
|
||||
|
||||
local link = pandoc.Link({pandoc.Str(url)}, url)
|
||||
if trailing ~= "" then
|
||||
return {link, pandoc.Str(trailing)}
|
||||
end
|
||||
return link
|
||||
end
|
||||
|
||||
-- Map of emoji / special Unicode sequences → plain-text replacements.
|
||||
-- Add more entries here as needed.
|
||||
local EMOJI_MAP = {
|
||||
-- Flag sequences
|
||||
["\xF0\x9F\x87\xAC\xF0\x9F\x87\xA7"] = "[EN]", -- 🇬🇧
|
||||
["\xF0\x9F\x87\xA9\xF0\x9F\x87\xAA"] = "[DE]", -- 🇩🇪
|
||||
-- Status symbols
|
||||
["\xE2\x9C\x85"] = "[OK]", -- ✅
|
||||
["\xE2\x9D\x8C"] = "[--]", -- ❌
|
||||
-- Misc symbols used in tables / text
|
||||
["\xF0\x9F\x94\xB4"] = "[red]", -- 🔴
|
||||
["\xF0\x9F\x9F\xA1"] = "[yellow]", -- 🟡
|
||||
["\xF0\x9F\x9F\xA2"] = "[green]", -- 🟢
|
||||
}
|
||||
|
||||
--- Replace emoji in a plain string.
|
||||
local function replace_emoji(text)
|
||||
for pattern, replacement in pairs(EMOJI_MAP) do
|
||||
text = text:gsub(pattern, replacement)
|
||||
end
|
||||
return text
|
||||
end
|
||||
|
||||
--- Filter: remove language-switch blockquotes from PDF output.
|
||||
-- These blockquotes appear in every wiki page for GitHub navigation
|
||||
-- but are not needed in the printed manual.
|
||||
function BlockQuote(el)
|
||||
local text = pandoc.utils.stringify(el)
|
||||
if text:find("Du liest gerade die deutsche Version") or
|
||||
text:find("You are reading the English version") then
|
||||
return {}
|
||||
end
|
||||
return el
|
||||
end
|
||||
|
||||
--- Filter: convert internal wiki links to in-PDF anchor links.
|
||||
function Link(el)
|
||||
local target = el.target
|
||||
-- Keep external URLs unchanged.
|
||||
if target:match("^https?://") or target:match("^mailto:") then
|
||||
return el
|
||||
end
|
||||
|
||||
if target:match("^#") then
|
||||
local fragment = target:gsub("^#", "")
|
||||
return pandoc.Link(el.content, "#" .. normalize_anchor(fragment), el.title, el.attr)
|
||||
end
|
||||
|
||||
local page, fragment = target:match("^([^#]+)#(.+)$")
|
||||
if page and fragment then
|
||||
return pandoc.Link(el.content, "#" .. normalize_anchor(fragment), el.title, el.attr)
|
||||
end
|
||||
|
||||
return pandoc.Link(el.content, "#" .. resolve_page_anchor(target), el.title, el.attr)
|
||||
end
|
||||
|
||||
--- Filter: replace emoji sequences in plain Str elements.
|
||||
function Str(el)
|
||||
local linkified = convert_url_token(el.text)
|
||||
if linkified then
|
||||
return linkified
|
||||
end
|
||||
|
||||
local replaced = replace_emoji(el.text)
|
||||
if replaced ~= el.text then
|
||||
return pandoc.Str(replaced)
|
||||
end
|
||||
return el
|
||||
end
|
||||
107
.github/workflows/docs-pdf.yml
vendored
Normal file
@@ -0,0 +1,107 @@
|
||||
name: Build Documentation PDF
|
||||
|
||||
# Runs when documentation changes are pushed to main, or on manual trigger.
|
||||
# Also triggered as a dependency from the tagged-release workflow.
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
paths:
|
||||
- github_docs/**
|
||||
- .github/latex-manual/**
|
||||
- .github/workflows/docs-pdf.yml
|
||||
workflow_dispatch:
|
||||
|
||||
env:
|
||||
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
jobs:
|
||||
build-docs-pdf:
|
||||
name: Build Documentation PDF
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4.1.7
|
||||
|
||||
- name: Resolve version string
|
||||
run: |
|
||||
if [[ "${{ github.ref }}" == refs/tags/* ]]; then
|
||||
VERSION="${{ github.ref_name }}"
|
||||
else
|
||||
VERSION="$(grep -m1 '<version>' pom.xml | sed 's/.*<version>\(.*\)<\/version>.*/\1/')-${GITHUB_SHA::7}"
|
||||
fi
|
||||
echo "DOC_VERSION=$VERSION" >> "$GITHUB_ENV"
|
||||
|
||||
- name: Install pandoc and LaTeX toolchain
|
||||
run: |
|
||||
sudo apt-get update -qq
|
||||
sudo apt-get install -y --no-install-recommends \
|
||||
pandoc \
|
||||
texlive-xetex \
|
||||
texlive-fonts-recommended \
|
||||
texlive-latex-extra \
|
||||
texlive-plain-generic
|
||||
|
||||
- name: Build English PDF manual
|
||||
run: |
|
||||
mkdir -p dist
|
||||
pandoc \
|
||||
--from=markdown-yaml_metadata_block \
|
||||
--template=.github/latex-manual/manual-template.tex \
|
||||
--pdf-engine=xelatex \
|
||||
--lua-filter=.github/latex-manual/strip-wiki-links.lua \
|
||||
--resource-path=.:github_docs \
|
||||
--listings \
|
||||
--toc \
|
||||
--toc-depth=6 \
|
||||
-V title="User Manual" \
|
||||
-V polyglossia-lang=english \
|
||||
-V version="${DOC_VERSION}" \
|
||||
-o dist/KST4Contest-${DOC_VERSION}-manual-en.pdf \
|
||||
github_docs/en-Home.md \
|
||||
github_docs/en-Installation.md \
|
||||
github_docs/en-Configuration.md \
|
||||
github_docs/en-Features.md \
|
||||
github_docs/en-User-Interface.md \
|
||||
github_docs/en-Macros-and-Variables.md \
|
||||
github_docs/en-Log-Sync.md \
|
||||
github_docs/en-AirScout-Integration.md \
|
||||
github_docs/en-DX-Cluster-Server.md \
|
||||
github_docs/en-Changelog.md
|
||||
|
||||
- name: Build German PDF manual
|
||||
run: |
|
||||
pandoc \
|
||||
--from=markdown-yaml_metadata_block \
|
||||
--template=.github/latex-manual/manual-template.tex \
|
||||
--pdf-engine=xelatex \
|
||||
--lua-filter=.github/latex-manual/strip-wiki-links.lua \
|
||||
--resource-path=.:github_docs \
|
||||
--listings \
|
||||
--toc \
|
||||
--toc-depth=6 \
|
||||
-V title="Benutzerhandbuch" \
|
||||
-V polyglossia-lang=german \
|
||||
-V version="${DOC_VERSION}" \
|
||||
-o dist/KST4Contest-${DOC_VERSION}-manual-de.pdf \
|
||||
github_docs/de-Home.md \
|
||||
github_docs/de-Installation.md \
|
||||
github_docs/de-Konfiguration.md \
|
||||
github_docs/de-Funktionen.md \
|
||||
github_docs/de-Benutzeroberflaeche.md \
|
||||
github_docs/de-Makros-und-Variablen.md \
|
||||
github_docs/de-Log-Synchronisation.md \
|
||||
github_docs/de-AirScout-Integration.md \
|
||||
github_docs/de-DX-Cluster-Server.md \
|
||||
github_docs/de-Changelog.md
|
||||
|
||||
- name: Upload PDF artifacts
|
||||
uses: actions/upload-artifact@v4.3.4
|
||||
with:
|
||||
name: docs-pdf
|
||||
path: dist/KST4Contest-*-manual-*.pdf
|
||||
retention-days: 30
|
||||
21
.github/workflows/github-wiki.yml
vendored
Normal file
@@ -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
|
||||
114
.github/workflows/nightly-artifacts.yml
vendored
@@ -4,28 +4,35 @@ on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
- test-mac
|
||||
schedule:
|
||||
- cron: "20 2 * * *"
|
||||
workflow_dispatch:
|
||||
|
||||
env:
|
||||
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
|
||||
|
||||
jobs:
|
||||
build-windows-zip:
|
||||
name: Build Windows ZIP Artifact
|
||||
name: Build Windows ZIP
|
||||
runs-on: windows-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
uses: actions/checkout@v4.1.7
|
||||
|
||||
- name: Extract version from pom.xml
|
||||
- name: Resolve nightly version info
|
||||
shell: pwsh
|
||||
run: |
|
||||
$xml = [xml](Get-Content pom.xml)
|
||||
$version = $xml.project.version
|
||||
$shortSha = "${{ github.sha }}".Substring(0, 7)
|
||||
Add-Content -Path $env:GITHUB_ENV -Value "VERSION=$version"
|
||||
Add-Content -Path $env:GITHUB_ENV -Value "SHORT_SHA=$shortSha"
|
||||
Add-Content -Path $env:GITHUB_ENV -Value "ASSET_BASENAME=praktiKST-$version-$shortSha"
|
||||
|
||||
- name: Set up Java 17
|
||||
uses: actions/setup-java@v4
|
||||
uses: actions/setup-java@v4.1.0
|
||||
with:
|
||||
distribution: temurin
|
||||
java-version: "17"
|
||||
@@ -56,30 +63,33 @@ jobs:
|
||||
if (-not (Test-Path dist/praktiKST)) {
|
||||
throw "No Windows app-image produced by jpackage"
|
||||
}
|
||||
Compress-Archive -Path dist/praktiKST -DestinationPath dist/praktiKST-${{ env.VERSION }}-windows-x64.zip -Force
|
||||
Compress-Archive -Path dist/praktiKST -DestinationPath "dist/$env:ASSET_BASENAME-windows-x64.zip" -Force
|
||||
|
||||
- name: Upload Windows ZIP artifact
|
||||
uses: actions/upload-artifact@v4
|
||||
- name: Upload Windows artifact
|
||||
uses: actions/upload-artifact@v4.3.4
|
||||
with:
|
||||
name: nightly-windows-zip
|
||||
path: dist/praktiKST-${{ env.VERSION }}-windows-x64.zip
|
||||
name: windows-zip
|
||||
path: dist/praktiKST-*-windows-x64.zip
|
||||
retention-days: 14
|
||||
|
||||
build-linux-appimage:
|
||||
name: Build Linux AppImage Artifact
|
||||
name: Build Linux AppImage
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
uses: actions/checkout@v4.1.7
|
||||
|
||||
- name: Extract version from pom.xml
|
||||
- name: Resolve nightly version info
|
||||
run: |
|
||||
VERSION=$(grep -m1 '<version>' pom.xml | sed 's/.*<version>\(.*\)<\/version>.*/\1/')
|
||||
echo "VERSION=$VERSION" >> $GITHUB_ENV
|
||||
SHORT_SHA="${GITHUB_SHA::7}"
|
||||
echo "VERSION=$VERSION" >> "$GITHUB_ENV"
|
||||
echo "SHORT_SHA=$SHORT_SHA" >> "$GITHUB_ENV"
|
||||
echo "ASSET_BASENAME=praktiKST-${VERSION}-${SHORT_SHA}" >> "$GITHUB_ENV"
|
||||
|
||||
- name: Set up Java 17
|
||||
uses: actions/setup-java@v4
|
||||
uses: actions/setup-java@v4.1.0
|
||||
with:
|
||||
distribution: temurin
|
||||
java-version: "17"
|
||||
@@ -135,11 +145,77 @@ jobs:
|
||||
run: |
|
||||
wget -q -O target/appimagetool.AppImage https://github.com/AppImage/appimagetool/releases/download/continuous/appimagetool-x86_64.AppImage
|
||||
chmod +x target/appimagetool.AppImage
|
||||
APPIMAGE_EXTRACT_AND_RUN=1 ARCH=x86_64 target/appimagetool.AppImage target/praktiKST.AppDir dist/praktiKST-${{ env.VERSION }}-linux-x86_64.AppImage
|
||||
APPIMAGE_EXTRACT_AND_RUN=1 ARCH=x86_64 target/appimagetool.AppImage target/praktiKST.AppDir "dist/${ASSET_BASENAME}-linux-x86_64.AppImage"
|
||||
|
||||
- name: Upload Linux AppImage artifact
|
||||
uses: actions/upload-artifact@v4
|
||||
- name: Upload Linux artifact
|
||||
uses: actions/upload-artifact@v4.3.4
|
||||
with:
|
||||
name: nightly-linux-appimage
|
||||
path: dist/praktiKST-${{ env.VERSION }}-linux-x86_64.AppImage
|
||||
name: linux-appimage
|
||||
path: dist/praktiKST-*-linux-x86_64.AppImage
|
||||
retention-days: 14
|
||||
|
||||
build-macos-dmg:
|
||||
name: Build macOS DMG (${{ matrix.os }})
|
||||
runs-on: ${{ matrix.os }}
|
||||
strategy:
|
||||
matrix:
|
||||
os: [macos-latest, macos-15-intel]
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4.1.7
|
||||
|
||||
- name: Resolve nightly version info
|
||||
run: |
|
||||
VERSION=$(grep -m1 '<version>' pom.xml | sed 's/.*<version>\(.*\)<\/version>.*/\1/')
|
||||
SHORT_SHA="${GITHUB_SHA::7}"
|
||||
ARCH=$(uname -m)
|
||||
echo "VERSION=$VERSION" >> "$GITHUB_ENV"
|
||||
echo "SHORT_SHA=$SHORT_SHA" >> "$GITHUB_ENV"
|
||||
echo "ASSET_BASENAME=praktiKST-${VERSION}-${SHORT_SHA}" >> "$GITHUB_ENV"
|
||||
echo "ARCH=$ARCH" >> "$GITHUB_ENV"
|
||||
|
||||
- name: Set up Java 17
|
||||
uses: actions/setup-java@v4.1.0
|
||||
with:
|
||||
distribution: temurin
|
||||
java-version: "17"
|
||||
|
||||
- name: Ensure mvnw is executable
|
||||
run: chmod +x mvnw
|
||||
|
||||
- name: Build JAR and copy runtime dependencies
|
||||
run: |
|
||||
./mvnw -B -DskipTests package dependency:copy-dependencies -DincludeScope=runtime -DoutputDirectory=target/dist-libs
|
||||
cp "$(ls -t target/praktiKST-*.jar | head -n 1)" target/dist-libs/app.jar
|
||||
|
||||
- name: Build macOS DMG with jpackage
|
||||
run: |
|
||||
mkdir -p dist
|
||||
jpackage \
|
||||
--type dmg \
|
||||
--name praktiKST \
|
||||
--input target/dist-libs \
|
||||
--main-jar app.jar \
|
||||
--main-class kst4contest.view.Kst4ContestApplication \
|
||||
--module-path target/dist-libs \
|
||||
--add-modules javafx.controls,javafx.graphics,javafx.fxml,javafx.web,javafx.media,java.sql \
|
||||
--dest dist
|
||||
|
||||
env:
|
||||
MACOSX_DEPLOYMENT_TARGET: "13.0"
|
||||
|
||||
- name: Rename DMG artifact
|
||||
run: |
|
||||
DMG=$(ls dist/*.dmg | head -n 1)
|
||||
if [ -z "$DMG" ]; then
|
||||
echo "No DMG produced by jpackage" && exit 1
|
||||
fi
|
||||
mv "$DMG" "dist/${ASSET_BASENAME}-macos-${ARCH}.dmg"
|
||||
|
||||
- name: Upload macOS artifact
|
||||
uses: actions/upload-artifact@v4.3.4
|
||||
with:
|
||||
name: macos-dmg-${{ matrix.os }}
|
||||
path: dist/praktiKST-*-macos-*.dmg
|
||||
retention-days: 14
|
||||
|
||||
7
.github/workflows/pr-compile-check.yml
vendored
@@ -6,6 +6,9 @@ on:
|
||||
- main
|
||||
workflow_dispatch:
|
||||
|
||||
env:
|
||||
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
|
||||
|
||||
jobs:
|
||||
compile:
|
||||
name: Compile (Java 17)
|
||||
@@ -13,10 +16,10 @@ jobs:
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
uses: actions/checkout@v4.1.7
|
||||
|
||||
- name: Set up Java 17
|
||||
uses: actions/setup-java@v4
|
||||
uses: actions/setup-java@v4.1.0
|
||||
with:
|
||||
distribution: temurin
|
||||
java-version: "17"
|
||||
|
||||
179
.github/workflows/tagged-release.yml
vendored
@@ -9,6 +9,9 @@ on:
|
||||
permissions:
|
||||
contents: write
|
||||
|
||||
env:
|
||||
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
|
||||
|
||||
jobs:
|
||||
build-windows-zip:
|
||||
name: Build Windows ZIP
|
||||
@@ -16,10 +19,10 @@ jobs:
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
uses: actions/checkout@v4.1.7
|
||||
|
||||
- name: Set up Java 17
|
||||
uses: actions/setup-java@v4
|
||||
uses: actions/setup-java@v4.1.0
|
||||
with:
|
||||
distribution: temurin
|
||||
java-version: "17"
|
||||
@@ -53,7 +56,7 @@ jobs:
|
||||
Compress-Archive -Path dist/praktiKST -DestinationPath dist/praktiKST-${{ github.ref_name }}-windows-x64.zip -Force
|
||||
|
||||
- name: Upload Windows artifact
|
||||
uses: actions/upload-artifact@v4
|
||||
uses: actions/upload-artifact@v4.3.4
|
||||
with:
|
||||
name: windows-zip
|
||||
path: dist/praktiKST-${{ github.ref_name }}-windows-x64.zip
|
||||
@@ -64,10 +67,10 @@ jobs:
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
uses: actions/checkout@v4.1.7
|
||||
|
||||
- name: Set up Java 17
|
||||
uses: actions/setup-java@v4
|
||||
uses: actions/setup-java@v4.1.0
|
||||
with:
|
||||
distribution: temurin
|
||||
java-version: "17"
|
||||
@@ -126,39 +129,193 @@ jobs:
|
||||
APPIMAGE_EXTRACT_AND_RUN=1 ARCH=x86_64 target/appimagetool.AppImage target/praktiKST.AppDir dist/praktiKST-${{ github.ref_name }}-linux-x86_64.AppImage
|
||||
|
||||
- name: Upload Linux artifact
|
||||
uses: actions/upload-artifact@v4
|
||||
uses: actions/upload-artifact@v4.3.4
|
||||
with:
|
||||
name: linux-appimage
|
||||
path: dist/praktiKST-${{ github.ref_name }}-linux-x86_64.AppImage
|
||||
|
||||
build-macos-dmg:
|
||||
name: Build macOS DMG (${{ matrix.os }})
|
||||
runs-on: ${{ matrix.os }}
|
||||
strategy:
|
||||
matrix:
|
||||
os: [macos-latest, macos-15-intel]
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4.1.7
|
||||
|
||||
- name: Set up Java 17
|
||||
uses: actions/setup-java@v4.1.0
|
||||
with:
|
||||
distribution: temurin
|
||||
java-version: "17"
|
||||
|
||||
- name: Ensure mvnw is executable
|
||||
run: chmod +x mvnw
|
||||
|
||||
- name: Build JAR and copy runtime dependencies
|
||||
run: |
|
||||
./mvnw -B -DskipTests package dependency:copy-dependencies -DincludeScope=runtime -DoutputDirectory=target/dist-libs
|
||||
cp "$(ls -t target/praktiKST-*.jar | head -n 1)" target/dist-libs/app.jar
|
||||
|
||||
- name: Build macOS DMG with jpackage
|
||||
run: |
|
||||
mkdir -p dist
|
||||
jpackage \
|
||||
--type dmg \
|
||||
--name praktiKST \
|
||||
--input target/dist-libs \
|
||||
--main-jar app.jar \
|
||||
--main-class kst4contest.view.Kst4ContestApplication \
|
||||
--module-path target/dist-libs \
|
||||
--add-modules javafx.controls,javafx.graphics,javafx.fxml,javafx.web,javafx.media,java.sql \
|
||||
--dest dist
|
||||
|
||||
env:
|
||||
MACOSX_DEPLOYMENT_TARGET: "13.0"
|
||||
|
||||
- name: Rename DMG artifact
|
||||
run: |
|
||||
ARCH=$(uname -m)
|
||||
DMG=$(ls dist/*.dmg | head -n 1)
|
||||
if [ -z "$DMG" ]; then
|
||||
echo "No DMG produced by jpackage" && exit 1
|
||||
fi
|
||||
mv "$DMG" "dist/praktiKST-${{ github.ref_name }}-macos-${ARCH}.dmg"
|
||||
|
||||
- name: Upload macOS artifact
|
||||
uses: actions/upload-artifact@v4.3.4
|
||||
with:
|
||||
name: macos-dmg-${{ matrix.os }}
|
||||
path: dist/praktiKST-${{ github.ref_name }}-macos-*.dmg
|
||||
|
||||
build-docs-pdf:
|
||||
name: Build Documentation PDF
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4.1.7
|
||||
|
||||
- name: Install pandoc and LaTeX toolchain
|
||||
run: |
|
||||
sudo apt-get update -qq
|
||||
sudo apt-get install -y --no-install-recommends \
|
||||
pandoc \
|
||||
texlive-xetex \
|
||||
texlive-fonts-recommended \
|
||||
texlive-latex-extra \
|
||||
texlive-plain-generic
|
||||
|
||||
- name: Build English PDF manual
|
||||
run: |
|
||||
mkdir -p dist
|
||||
pandoc \
|
||||
--from=markdown-yaml_metadata_block \
|
||||
--template=.github/latex-manual/manual-template.tex \
|
||||
--pdf-engine=xelatex \
|
||||
--lua-filter=.github/latex-manual/strip-wiki-links.lua \
|
||||
--resource-path=.:github_docs \
|
||||
--listings \
|
||||
--toc \
|
||||
--toc-depth=3 \
|
||||
-V title="User Manual" \
|
||||
-V polyglossia-lang=english \
|
||||
-V version="${{ github.ref_name }}" \
|
||||
-o dist/KST4Contest-${{ github.ref_name }}-manual-en.pdf \
|
||||
github_docs/en-Home.md \
|
||||
github_docs/en-Installation.md \
|
||||
github_docs/en-Configuration.md \
|
||||
github_docs/en-Features.md \
|
||||
github_docs/en-User-Interface.md \
|
||||
github_docs/en-Macros-and-Variables.md \
|
||||
github_docs/en-Log-Sync.md \
|
||||
github_docs/en-AirScout-Integration.md \
|
||||
github_docs/en-DX-Cluster-Server.md \
|
||||
github_docs/en-Changelog.md
|
||||
|
||||
- name: Build German PDF manual
|
||||
run: |
|
||||
pandoc \
|
||||
--from=markdown-yaml_metadata_block \
|
||||
--template=.github/latex-manual/manual-template.tex \
|
||||
--pdf-engine=xelatex \
|
||||
--lua-filter=.github/latex-manual/strip-wiki-links.lua \
|
||||
--resource-path=.:github_docs \
|
||||
--listings \
|
||||
--toc \
|
||||
--toc-depth=3 \
|
||||
-V title="Benutzerhandbuch" \
|
||||
-V polyglossia-lang=german \
|
||||
-V version="${{ github.ref_name }}" \
|
||||
-o dist/KST4Contest-${{ github.ref_name }}-manual-de.pdf \
|
||||
github_docs/de-Home.md \
|
||||
github_docs/de-Installation.md \
|
||||
github_docs/de-Konfiguration.md \
|
||||
github_docs/de-Funktionen.md \
|
||||
github_docs/de-Benutzeroberflaeche.md \
|
||||
github_docs/de-Makros-und-Variablen.md \
|
||||
github_docs/de-Log-Synchronisation.md \
|
||||
github_docs/de-AirScout-Integration.md \
|
||||
github_docs/de-DX-Cluster-Server.md \
|
||||
github_docs/de-Changelog.md
|
||||
|
||||
- name: Upload PDF artifacts
|
||||
uses: actions/upload-artifact@v4.3.4
|
||||
with:
|
||||
name: docs-pdf
|
||||
path: dist/KST4Contest-${{ github.ref_name }}-manual-*.pdf
|
||||
|
||||
release-tag:
|
||||
name: Publish Tagged Release
|
||||
runs-on: ubuntu-latest
|
||||
needs:
|
||||
- build-windows-zip
|
||||
- build-linux-appimage
|
||||
- build-macos-dmg
|
||||
- build-docs-pdf
|
||||
|
||||
steps:
|
||||
- name: Download Windows artifact
|
||||
uses: actions/download-artifact@v4
|
||||
uses: actions/download-artifact@v4.1.3
|
||||
with:
|
||||
name: windows-zip
|
||||
path: release-assets/windows
|
||||
|
||||
- name: Download Linux artifact
|
||||
uses: actions/download-artifact@v4
|
||||
uses: actions/download-artifact@v4.1.3
|
||||
with:
|
||||
name: linux-appimage
|
||||
path: release-assets/linux
|
||||
|
||||
- name: Download macOS artifacts
|
||||
uses: actions/download-artifact@v4.1.3
|
||||
with:
|
||||
pattern: macos-dmg-*
|
||||
merge-multiple: true
|
||||
path: release-assets/macos
|
||||
|
||||
- name: Download PDF manuals
|
||||
uses: actions/download-artifact@v4.1.3
|
||||
with:
|
||||
name: docs-pdf
|
||||
path: release-assets/docs
|
||||
|
||||
- name: Create tagged release
|
||||
uses: ncipollo/release-action@v1
|
||||
with:
|
||||
token: ${{ secrets.GITHUB_TOKEN }}
|
||||
tag: ${{ github.ref_name }}
|
||||
name: Release ${{ github.ref_name }}
|
||||
name: ${{ startsWith(github.ref_name, 'beta-') && format('Beta {0}', github.ref_name) || format('Release {0}', github.ref_name) }}
|
||||
prerelease: ${{ startsWith(github.ref_name, 'beta-') }}
|
||||
allowUpdates: false
|
||||
replacesArtifacts: false
|
||||
makeLatest: true
|
||||
makeLatest: ${{ !startsWith(github.ref_name, 'beta-') }}
|
||||
generateReleaseNotes: true
|
||||
artifacts: release-assets/windows/praktiKST-${{ github.ref_name }}-windows-x64.zip,release-assets/linux/praktiKST-${{ github.ref_name }}-linux-x86_64.AppImage
|
||||
artifacts: >-
|
||||
release-assets/windows/praktiKST-${{ github.ref_name }}-windows-x64.zip,
|
||||
release-assets/linux/praktiKST-${{ github.ref_name }}-linux-x86_64.AppImage,
|
||||
release-assets/macos/praktiKST-${{ github.ref_name }}-macos-*.dmg,
|
||||
release-assets/docs/KST4Contest-${{ github.ref_name }}-manual-en.pdf,
|
||||
release-assets/docs/KST4Contest-${{ github.ref_name }}-manual-de.pdf
|
||||
|
||||
3
.gitignore
vendored
@@ -30,5 +30,8 @@ target/
|
||||
#builds
|
||||
build/
|
||||
|
||||
#pdf output directory
|
||||
dist/
|
||||
|
||||
#zip files for local backups
|
||||
*.zip
|
||||
40
README.md
@@ -1,2 +1,38 @@
|
||||
# kst4contest
|
||||
java based on4kst chatclient
|
||||
# KST4Contest
|
||||
|
||||
KST4Contest (also known as pratiKST) is a Java-based chat client for ON4KST, focused on VHF/UHF/SHF contest operation.
|
||||
|
||||
## Documentation
|
||||
|
||||
The full user documentation is maintained in the project wiki:
|
||||
|
||||
- https://github.com/praktimarc/kst4contest/wiki
|
||||
|
||||
Direct entry points:
|
||||
|
||||
- German start page: https://github.com/praktimarc/kst4contest/wiki/de-Home
|
||||
- English start page: https://github.com/praktimarc/kst4contest/wiki/en-Home
|
||||
|
||||
## Build
|
||||
|
||||
Compile locally with Maven Wrapper:
|
||||
|
||||
```bash
|
||||
./mvnw -B -DskipTests compile
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- Source code is under `src/`.
|
||||
- Documentation markdown pages for wiki/PDF are under `github_docs/`.
|
||||
|
||||
## Status of the latest CI:
|
||||
Wiki Publishing:
|
||||
|
||||
[](https://github.com/praktimarc/kst4contest/actions/workflows/github-wiki.yml)
|
||||
|
||||
[](https://github.com/praktimarc/kst4contest/actions/workflows/docs-pdf.yml)
|
||||
|
||||
Builds:
|
||||
|
||||
[](https://github.com/praktimarc/kst4contest/actions/workflows/nightly-artifacts.yml)
|
||||
@@ -1,2 +0,0 @@
|
||||
dr2x
|
||||
oe3cin
|
||||
15832
bugsept24.txt
53
github_docs/Home.md
Normal file
@@ -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://github.com/praktimarc/kst4contest/releases
|
||||
- **GitHub**: https://github.com/praktimarc/kst4contest
|
||||
- **Kontakt / Contact**: praktimarc+kst4contest@gmail.com
|
||||
BIN
github_docs/as_plane_feed_1.png
Normal file
|
After Width: | Height: | Size: 46 KiB |
BIN
github_docs/as_plane_feed_2.png
Normal file
|
After Width: | Height: | Size: 143 KiB |
BIN
github_docs/as_plane_feed_3.png
Normal file
|
After Width: | Height: | Size: 148 KiB |
BIN
github_docs/as_plane_feed_4.png
Normal file
|
After Width: | Height: | Size: 20 KiB |
BIN
github_docs/client_settings_window_logsync.png
Normal file
|
After Width: | Height: | Size: 110 KiB |
BIN
github_docs/client_settings_window_station.png
Normal file
|
After Width: | Height: | Size: 109 KiB |
116
github_docs/de-AirScout-Integration.md
Normal file
@@ -0,0 +1,116 @@
|
||||
# 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)
|
||||
|
||||
{ width=85% }
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
105
github_docs/de-Benutzeroberflaeche.md
Normal file
@@ -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.
|
||||
235
github_docs/de-Changelog.md
Normal file
@@ -0,0 +1,235 @@
|
||||
# Changelog
|
||||
|
||||
> 🇬🇧 [English version](en-Changelog) | 🇩🇪 Du liest gerade die deutsche Version
|
||||
|
||||
Versionsverlauf von KST4Contest / PraktiKST.
|
||||
|
||||
---
|
||||
|
||||
letzter Changelog bitte aus GitHub entnehmen. Der bisherige Changelog
|
||||
|
||||
## v1.40 (2026-02-16)
|
||||
**Großes Feature-Release: Score-System, AP-Timeline, Win-Test, PSTRotator**
|
||||
|
||||
**Neu:**
|
||||
- **Chatmember Score-System**: Jeder Chatmember erhält automatisch eine Prioritätsbewertung anhand von Antennenrichtung, Aktivitätszeit, Nachrichtenanzahl, aktiven Bändern, Frequenzen, Sked-Richtung und anderen Faktoren. Die Top-Kandidaten werden in einer eigenen Liste hervorgehoben.
|
||||
- **AP-Timeline**: Für jeden möglichen AP-Ankunftsminuten-Slot werden bis zu 4 hochbewertete Stationen angezeigt, die erreichbar wären. Bevorzugt werden APs mit dem höchsten Potenzial, nicht die schnellste Ankunft. Stationen, auf die die eigene Antenne nicht zeigt, werden transparent dargestellt.
|
||||
- **Win-Test-Unterstützung** (ab v1.31 als Beta, jetzt vollständig konfigurierbar): Log-Synchronisation, Frequenzauswertung und **Sked-Übergabe via UDP** vollständig integriert. In den Preferences aktivier-/deaktivierbar.
|
||||
- **PSTRotator-Interface** (ab v1.31 als Beta, jetzt vollständig konfigurierbar): Aktualisierung der Rotatorposition direkt aus KST4Contest. In den Preferences aktivier-/deaktivierbar.
|
||||
- **QSO-Sniffer**: Nachrichten von konfigurierbaren Rufzeichen-Listen werden automatisch in das PM-Fenster weitergeleitet.
|
||||
- **Band-Alert bei gearbeiteten Stationen**: Wenn eine Station geloggt wird, erscheint ein Hinweis, wenn diese Station ein weiteres Band aktiv hat, auf dem man selbst ebenfalls QRV ist.
|
||||
- **Sked-Erinnerungs-ALERT**: Pro Chatmember kann ein Sked-Alarm mit automatischen Nachrichten in konfigurierbaren Intervallen (2+1 / 5+2+1 / 10+5+2+1 Minuten vor dem Sked) eingerichtet werden, plus akustische und optische Benachrichtigung.
|
||||
- **Chat-Historie beim Start laden**: Beim Verbindungsaufbau wird die Serverhistorie geladen, um aktive Chatmember und letzte Nachrichten sofort sichtbar zu machen.
|
||||
- **Skedfail-Button**: Im FurtherInfo-Panel kann ein Sked-Misserfolg für einen Chatmember markiert werden, was dessen Score senkt.
|
||||
|
||||
**Geändert:**
|
||||
- AP-Notizen in DX-Cluster-Spots integriert.
|
||||
- Scrolling der Chatmember-Tabelle folgt automatisch der aktuellen Nachrichtenauswahl.
|
||||
- Generic Auto-Antwort und QRG-Auto-Antwort senden max. einmal pro 45 Sekunden pro Rufzeichen (verhindert Spam-Schleifen).
|
||||
- Speicherbare Einstellungen erweitert: ServerDNS/Port, PSTRotator-Interface, Win-Test-Interface, Callsign-Sniffer, Dark-Mode-Standard.
|
||||
- Datum in der Chat-Tabelle entfernt (nur Uhrzeit verbleibt – spart Platz).
|
||||
|
||||
**Behoben:**
|
||||
- Benutzerliste wird jetzt bei jedem Neu-Login automatisch sortiert.
|
||||
- Posonpill-Nachrichten beenden jetzt nur genau eine Client-Instanz (nicht alle und nicht wtKST).
|
||||
- wtKST: Absturz bei KST4Contest-Trennung behoben.
|
||||
- Mehrere Probleme mit Rufzeichen-Suffixen wie `/p`, `-2` etc. behoben.
|
||||
- `QTFDefault` wurde nicht korrekt gespeichert → behoben.
|
||||
- AirScout-Watchlist (ASWATCHLIST) wurde nicht korrekt aktualisiert → behoben.
|
||||
- Dark Mode: QRG-Felder wurden nicht vollständig angezeigt → behoben.
|
||||
- Versionsnummer-Anzeige korrigiert.
|
||||
|
||||
---
|
||||
|
||||
## v1.31 (2025-12-13)
|
||||
**Win-Test + PSTRotator Beta, QSO-Sniffer, DNS-Hotfix**
|
||||
|
||||
**Neu:**
|
||||
- **Win-Test-Unterstützung** (Beta, noch nicht deaktivierbar): Log-Synchronisation und Frequenzauswertung.
|
||||
- **PSTRotator-Unterstützung** (Beta, noch nicht deaktivierbar).
|
||||
- **QSO-Sniffer**: Nachrichten von konfigurierbaren Rufzeichen werden ins PM-Fenster weitergeleitet.
|
||||
|
||||
**Geändert:**
|
||||
- **DNS-Server geändert**: Von `www.on4kst.info` auf `www.on4kst.org` (Hotfix). Der DNS-Server ist ab sofort in den Preferences änderbar.
|
||||
|
||||
**Behoben:**
|
||||
- Endlosschleife im Fehlerfall friert den Client ein → behoben.
|
||||
|
||||
---
|
||||
|
||||
## v1.266 (2025-10-03)
|
||||
**AirScout-Fix für Rufzeichen mit Suffix**
|
||||
|
||||
**Behoben:**
|
||||
- AirScout-Interface funktionierte nicht, wenn das Login-Rufzeichen einen Suffix enthielt (z. B. `9A1W-2`). AirScout kann mit diesem Format nicht umgehen – es wird jetzt nur noch das Basis-Rufzeichen ohne Suffix an AirScout übergeben.
|
||||
|
||||
*(Fehler gemeldet und getestet von 9A2HM / Kreso – herzlichen Dank!)*
|
||||
|
||||
---
|
||||
|
||||
## v1.265 (2025-09-28)
|
||||
**Richtungs-Buttons bleiben aktiviert eingefärbt**
|
||||
|
||||
**Behoben:**
|
||||
- Richtungs-Buttons (N / NE / E usw.) behalten jetzt ihre Farbe, wenn sie aktiviert sind, sodass der Aktivierungsstatus auf einen Blick erkennbar ist.
|
||||
|
||||
---
|
||||
|
||||
## v1.264 (2025-08-02)
|
||||
**Simplelogfile: Rufzeichen-Erkennung verbessert**
|
||||
|
||||
**Behoben:**
|
||||
- Rufzeichen wie `S53CC`, `S51A` usw. wurden in der SimpleLogFile-Auswertung nicht als gearbeitet markiert → Erkennungsmuster verbessert.
|
||||
|
||||
*(Fehler gemeldet von Boris, S53CC – danke!)*
|
||||
|
||||
---
|
||||
|
||||
## 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)~~ ✅ **Umgesetzt in v1.40** (3-Tage-Lebensdauer, kein manuelles Zurücksetzen mehr nötig)
|
||||
- Filterung des „Cluster & QSO der anderen"-Fensters auf eigenes QTF
|
||||
- Weitere Topografie-basierte Berechnungen für die Richtungswarnung
|
||||
76
github_docs/de-DX-Cluster-Server.md
Normal file
@@ -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.
|
||||
237
github_docs/de-Funktionen.md
Normal file
@@ -0,0 +1,237 @@
|
||||
# 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 mit ALERT (ab v1.40)
|
||||
|
||||
Für jeden Chatmember kann ein Sked-Erinnerungsdienst mit automatischen Nachrichten aktiviert werden. Konfigurierbare Intervallmuster:
|
||||
|
||||
- **2+1 Minuten**: Nachrichten bei 2 min und 1 min vor dem Sked.
|
||||
- **5+2+1 Minuten**: Nachrichten bei 5, 2 und 1 min vor dem Sked.
|
||||
- **10+5+2+1 Minuten**: Nachrichten bei 10, 5, 2 und 1 min vor dem Sked.
|
||||
|
||||
Zusätzlich zu den Nachrichten an die Gegenstation gibt es eine **akustische und optische Benachrichtigung** für den eigenen Operator, sodass kein Sked vergessen wird.
|
||||
|
||||
Aktivierung: FurtherInfo-Panel der entsprechenden Station.
|
||||
|
||||
---
|
||||
|
||||
## QSO-Sniffer (ab v1.31)
|
||||
|
||||
Der QSO-Sniffer überwacht den Chat auf Nachrichten von einer konfigurierbaren Rufzeichen-Liste und leitet diese automatisch in das **PM-Fenster** weiter. So gehen keine relevanten Nachrichten im allgemeinen Chat-Rauschen unter.
|
||||
|
||||
Konfiguration: [Konfiguration – Sniffer-Einstellungen](de-Konfiguration#sniffer-einstellungen-ab-v131)
|
||||
|
||||
---
|
||||
|
||||
## Win-Test-Integration (ab v1.31, vollständig ab v1.40)
|
||||
|
||||
KST4Contest unterstützt [Win-Test](https://www.win-test.com/) vollständig als Logprogramm:
|
||||
|
||||
- **Log-Synchronisation**: Gearbeitete Stationen werden automatisch aus Win-Test übernommen und in der Benutzerliste markiert.
|
||||
- **Frequenz-Auswertung**: Die aktuelle TRX-Frequenz wird aus Win-Test-UDP-Paketen ausgewertet und befüllt die `MYQRG`-Variable.
|
||||
- **Sked-Übergabe (SKED Push via UDP)**: Vereinbarte Skeds aus KST4Contest können direkt an Win-Test übertragen werden, sodass das Rufzeichen der Gegenstation im Win-Test-Sked-Fenster erscheint.
|
||||
|
||||
Details zur Konfiguration: [Konfiguration – Win-Test-Netzwerk-Listener](de-Konfiguration#win-test-netzwerk-listener)
|
||||
|
||||
---
|
||||
|
||||
## PSTRotator-Interface (ab v1.31, vollständig ab v1.40)
|
||||
|
||||
KST4Contest kann die Antennenrichtung direkt über **PSTRotator** steuern. Wenn in der Benutzerliste eine Station ausgewählt wird, kann der Rotator automatisch auf den QTF zur ausgewählten Station gedreht werden.
|
||||
|
||||
Konfiguration: [Konfiguration – PSTRotator-Einstellungen](de-Konfiguration#pstrotator-einstellungen-ab-v131)
|
||||
|
||||
---
|
||||
|
||||
## Band-Alert bei neuen QSOs (ab v1.40)
|
||||
|
||||
Wenn eine Station geloggt wird, prüft KST4Contest automatisch, ob diese Station im Chat weitere aktive Bänder angezeigt hat, auf denen man selbst ebenfalls QRV ist. Falls ja, erscheint ein **Hinweis-Alert**, damit keine Multi-Band-Möglichkeit übersehen wird.
|
||||
|
||||
---
|
||||
|
||||
## Worked-Tag-Lebensdauer (ab v1.40)
|
||||
|
||||
Gearbeitete Stationen werden nach **3 Tagen** automatisch aus der Datenbank entfernt. Ein manuelles Zurücksetzen der Worked-Datenbank vor jedem Contest ist damit nicht mehr zwingend notwendig – die Datenbank hält sich selbst aktuell.
|
||||
|
||||
---
|
||||
|
||||
## Chatmember Score-System / Prioritätsliste (ab v1.40)
|
||||
|
||||
KST4Contest berechnet automatisch eine **Prioritätsbewertung** für jeden aktiven Chatmember. Der Score setzt sich zusammen aus:
|
||||
|
||||
- Antennenrichtung der Gegenstation (zeigt sie auf mich?)
|
||||
- QRB (Entfernung)
|
||||
- Aktivitätszeit und Nachrichtenanzahl
|
||||
- Aktive Bänder und Frequenzen
|
||||
- AP-Verfügbarkeit (AirScout)
|
||||
- Sked-Richtung
|
||||
- Sked-Erfolgsrate und Skedfail-Markierungen
|
||||
|
||||
Die Top-Kandidaten werden in einer eigenen Prioritätsliste hervorgehoben und helfen, im Contest-Stress die wichtigsten Stationen nicht zu übersehen.
|
||||
|
||||
Stationen, bei denen ein Sked gescheitert ist, können über den **Skedfail-Button** im FurtherInfo-Panel markiert werden – das senkt ihren Score vorübergehend.
|
||||
|
||||
---
|
||||
|
||||
## AP-Timeline (ab v1.40)
|
||||
|
||||
Eine visuelle Zeitleiste zeigt für jeden möglichen AP-Ankunftsminuten-Slot bis zu 4 hochbewertete Stationen, die per Aircraft Scatter erreichbar wären. Priorisierungskriterien:
|
||||
|
||||
- Bevorzugt werden APs mit dem **höchsten Reflexionspotenzial** (nicht unbedingt die schnellste Ankunft).
|
||||
- Stationen, auf die die eigene Antenne nicht zeigt, werden **transparent** dargestellt.
|
||||
|
||||
So kann der Contest-Operator auf einem Blick sehen, welche Stationen wann und über welche Flugzeuge erreichbar sein werden.
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
51
github_docs/de-Home.md
Normal file
@@ -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://github.com/praktimarc/kst4contest/releases/latest
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
114
github_docs/de-Installation.md
Normal file
@@ -0,0 +1,114 @@
|
||||
# Installation
|
||||
|
||||
> 🇬🇧 [English version](en-Installation) | 🇩🇪 Du liest gerade die deutsche Version
|
||||
|
||||
## Voraussetzungen
|
||||
|
||||
Es wird eine Mindestauflösung von 1200px mal 720px empfohlen
|
||||
|
||||
### 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
|
||||
|
||||
### Windows
|
||||
|
||||
Die aktuelle Version kann als ZIP-Datei heruntergeladen werden:
|
||||
|
||||
**https://github.com/praktimarc/kst4contest/releases/latest**
|
||||
|
||||
Der Dateiname hat das Format `praktiKST-v<Versionsnummer>-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<Versionsnummer>-linux-x86_64.AppImage`.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Installation
|
||||
|
||||
### Windows
|
||||
|
||||
1. ZIP-Datei herunterladen.
|
||||
2. ZIP-Datei in einen gewünschten Ordner entpacken.
|
||||
3. `praktiKST.exe` ausführen.
|
||||
|
||||
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<Versionsnummer>-linux-x86_64.AppImage`)
|
||||
4. AppImage ausführen.
|
||||
|
||||
Die Einstellungen werden unter `~/.praktikst/preferences.xml` 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
|
||||
|
||||
#### Windows
|
||||
|
||||
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.
|
||||
|
||||
#### Linux
|
||||
|
||||
Derzeit folgendermaßen:
|
||||
1. neues AppImage herunterladen
|
||||
2. neues AppImage ausführbar makieren
|
||||
3. (optional) altes AppImage löschen.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 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!)*
|
||||
200
github_docs/de-Konfiguration.md
Normal file
@@ -0,0 +1,200 @@
|
||||
# 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 unter Linux in `~/.praktikst/preferences.xml` und unter Windows in `%USERPROFILE%\.praktikst\preferences.xml` (bzw. `C:\Users\<Benutzername>\.praktikst\preferences.xml`) gespeichert. Ab v1.21 werden auch Fenstergrößen und Divider-Positionen beim Speichern gesichert.
|
||||
|
||||
---
|
||||
|
||||
## Station Settings (Stationseinstellungen)
|
||||
|
||||

|
||||
|
||||
### 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
|
||||
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## Server-Einstellungen (ab v1.31)
|
||||
|
||||
Der Chat-Server-DNS und -Port sind in den Preferences konfigurierbar:
|
||||
|
||||
- **Server-DNS**: Standard `www.on4kst.org` (ab v1.31 geändert von `www.on4kst.info`).
|
||||
- **Port**: Standardport des ON4KST-Servers.
|
||||
|
||||
Eine Änderung ist nur notwendig, wenn der Server umzieht oder ein alternativer Endpunkt genutzt wird.
|
||||
|
||||
---
|
||||
|
||||
## Log-Sync-Einstellungen
|
||||
|
||||
Drei 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**. (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.
|
||||
|
||||
---
|
||||
|
||||
## 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 :-) )*.
|
||||
|
||||
---
|
||||
|
||||
## Win-Test-Netzwerk-Listener (ab v1.31)
|
||||
|
||||
Dedizierter Empfänger für Win-Test-spezifische UDP-Pakete. Ermöglicht:
|
||||
|
||||
- **Log-Synchronisation**: Gearbeitete Stationen werden aus Win-Test übernommen und in der Benutzerliste markiert.
|
||||
- **Frequenz-Auswertung**: Die aktuelle TRX-Frequenz aus Win-Test befüllt die `MYQRG`-Variable.
|
||||
- **Sked-Übergabe (SKED Push)**: Skeds aus KST4Contest werden via UDP direkt an Win-Test übergeben. Der UDP-Broadcast-Standardport von Win-Test (9871) wird verwendet.
|
||||
|
||||
Einstellungen:
|
||||
- **Aktivieren/Deaktivieren**: Checkbox in den Preferences (ab v1.40).
|
||||
- **Port**: Konfigurierbarer UDP-Port für den Win-Test-Listener.
|
||||
- **Sked-UDP-Adresse und Port**: Zieladresse und Port für die SKED-Übergabe an Win-Test.
|
||||
|
||||
> **Hinweis**: Der Win-Test-Listener ist ein **zusätzlicher** Listener – der Standard-QSO-UDP-Broadcast-Listener auf Port 12060 bleibt davon unabhängig.
|
||||
|
||||
---
|
||||
|
||||
## PSTRotator-Einstellungen (ab v1.31)
|
||||
|
||||
KST4Contest kann die Antennenrichtung über PSTRotator steuern.
|
||||
|
||||
Einstellungen:
|
||||
- **Aktivieren/Deaktivieren**: Checkbox in den Preferences (ab v1.40).
|
||||
- **IP-Adresse**: IP-Adresse des PSTRotator-Rechners (Standard: `127.0.0.1` bei Betrieb auf demselben PC).
|
||||
- **Port**: Kommunikationsport von PSTRotator.
|
||||
|
||||
> **Hinweis**: Nach einem Klick auf den Richtungs-Button wartet KST4Contest kurz auf die Rotatorantwort. Bei langsamen Rotoren (z. B. SPID) kann es zu einer kleinen Verzögerung kommen.
|
||||
|
||||
---
|
||||
|
||||
## Sniffer-Einstellungen (ab v1.31)
|
||||
|
||||
Der QSO-Sniffer filtert Chat-Nachrichten von konfigurierbaren Rufzeichen und leitet sie ins PM-Fenster weiter.
|
||||
|
||||
Einstellungen:
|
||||
- **Rufzeichen-Liste**: Kommagetrennte Liste von Rufzeichen, deren Nachrichten immer in das PM-Fenster weitergeleitet werden sollen.
|
||||
|
||||
Anwendungsfall: Wichtige Stationen (z. B. DX-Peditionen oder feste Verbündete im Contest) im Auge behalten, ohne den Haupt-Chat ständig zu beobachten.
|
||||
|
||||
---
|
||||
|
||||
## Worked Station Database Settings (Gearbeitete-Stationen-Datenbank)
|
||||
|
||||
Die interne Worked-Datenbank enthält:
|
||||
|
||||
- Worked-Status aller Stationen (pro Band)
|
||||
- NOT-QRV-Tags (seit v1.2)
|
||||
|
||||
**Ab v1.40**: Einträge haben eine automatische Lebensdauer von **3 Tagen** – ein manuelles Zurücksetzen vor jedem Contest ist nicht mehr zwingend notwendig. Für ein vollständiges Reset kann trotzdem die Schaltfläche **„Reinitialize"** verwendet werden.
|
||||
|
||||
---
|
||||
|
||||
## 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: unter Linux `~/.praktikst/preferences.xml` und unter Windows `%USERPROFILE%\.praktikst\preferences.xml` (bzw. `C:\Users\<Benutzername>\.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.
|
||||
138
github_docs/de-Log-Synchronisation.md
Normal file
@@ -0,0 +1,138 @@
|
||||
# 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
|
||||
|
||||
### Win-Test
|
||||
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## 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)
|
||||
162
github_docs/de-Makros-und-Variablen.md
Normal file
@@ -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.
|
||||
BIN
github_docs/dxlog_net_logsync.png
Normal file
|
After Width: | Height: | Size: 13 KiB |
116
github_docs/en-AirScout-Integration.md
Normal file
@@ -0,0 +1,116 @@
|
||||
# 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)
|
||||
|
||||
{ width=85% }
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
235
github_docs/en-Changelog.md
Normal file
@@ -0,0 +1,235 @@
|
||||
# Changelog
|
||||
|
||||
> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Changelog)
|
||||
|
||||
Version history of KST4Contest / PraktiKST.
|
||||
|
||||
---
|
||||
|
||||
For the latest changelog, please refer to GitHub. The previous changelog is below.
|
||||
|
||||
## v1.40 (2026-02-16)
|
||||
**Major Feature Release: Score System, AP Timeline, Win-Test, PSTRotator**
|
||||
|
||||
**New:**
|
||||
- **Chatmember Score System**: Every chat member is automatically scored based on antenna direction, activity time, message count, active bands, frequencies, sked direction (degrees), and other factors. Top candidates are highlighted in a dedicated list.
|
||||
- **AP Timeline**: For each minute of possible aircraft arrival, up to 4 highly-scored stations are shown that should be workable. Aircraft with the highest potential are preferred over the fastest arrival. Chat members whose antenna is not pointing towards you are shown transparently.
|
||||
- **Win-Test Support** (Beta since v1.31, now fully configurable): Log synchronisation, frequency parsing and **sked handover via UDP** fully integrated. Can be enabled/disabled in Preferences.
|
||||
- **PSTRotator Interface** (Beta since v1.31, now fully configurable): Rotator position updates directly from KST4Contest. Can be enabled/disabled in Preferences.
|
||||
- **QSO Sniffer**: Messages from configurable callsign lists are automatically forwarded to the PM window.
|
||||
- **Band Alert for logged stations**: When a station is logged, a hint appears if that station has another active band that you are also QRV on.
|
||||
- **Sked Reminder ALERT**: A sked alarm with automatic messages in configurable intervals (2+1 / 5+2+1 / 10+5+2+1 minutes before the sked) can be set up for each chat member, plus acoustic and visual notification.
|
||||
- **Load chat history on startup**: Chat server history is loaded on connect to immediately see active members and recent messages.
|
||||
- **Skedfail button**: In the FurtherInfo panel, a sked failure can be marked for a chat member, which lowers their priority score.
|
||||
|
||||
**Changed:**
|
||||
- AP notes added to internal DX cluster spots.
|
||||
- Chat member table scrolling follows the current message selection automatically.
|
||||
- Generic auto-reply and QRG auto-reply now fire a maximum of once every 45 seconds per callsign (prevents spam and message ping-pong).
|
||||
- New saveable settings: ServerDNS/Port, PSTRotator interface, Win-Test interface, callsign sniffer, Dark Mode on by default.
|
||||
- Date column removed from chat table (time only – saves space).
|
||||
|
||||
**Fixed:**
|
||||
- User list now automatically sorted on every new member sign-on.
|
||||
- Posonpill messages now terminate exactly one client instance (no longer affects all instances or wtKST).
|
||||
- wtKST: crash on KST4Contest disconnection fixed.
|
||||
- Multiple issues with callsign suffixes like `/p`, `-2`, etc. fixed throughout.
|
||||
- `QTFDefault` was not saved correctly → fixed.
|
||||
- AirScout watchlist (ASWATCHLIST) was not being updated → fixed.
|
||||
- Dark Mode: QRG fields not displayed at full size → fixed.
|
||||
- Version number display corrected.
|
||||
|
||||
---
|
||||
|
||||
## v1.31 (2025-12-13)
|
||||
**Win-Test + PSTRotator Beta, QSO Sniffer, DNS Hotfix**
|
||||
|
||||
**New:**
|
||||
- **Win-Test support** (Beta, not yet deactivatable): Log synchronisation and frequency parsing.
|
||||
- **PSTRotator support** (Beta, not yet deactivatable).
|
||||
- **QSO Sniffer**: Messages from configurable callsigns are forwarded to the PM window.
|
||||
|
||||
**Changed:**
|
||||
- **DNS server changed**: From `www.on4kst.info` to `www.on4kst.org` (hotfix). The DNS server is now configurable in Preferences.
|
||||
|
||||
**Fixed:**
|
||||
- Endless loop in error case freezes the client → fixed.
|
||||
|
||||
---
|
||||
|
||||
## v1.266 (2025-10-03)
|
||||
**AirScout Fix for Callsigns with Suffix**
|
||||
|
||||
**Fixed:**
|
||||
- AirScout interface did not work when the login callsign contained a suffix (e.g. `9A1W-2`). AirScout cannot handle this format – only the base callsign without suffix is now passed to AirScout.
|
||||
|
||||
*(Bug reported and tested by 9A2HM / Kreso – many thanks!)*
|
||||
|
||||
---
|
||||
|
||||
## v1.265 (2025-09-28)
|
||||
**Direction Buttons Stay Coloured When Active**
|
||||
|
||||
**Fixed:**
|
||||
- Direction buttons (N / NE / E etc.) now keep their highlight colour when activated, making the active state immediately visible.
|
||||
|
||||
---
|
||||
|
||||
## v1.264 (2025-08-02)
|
||||
**Simplelogfile: Improved Callsign Recognition**
|
||||
|
||||
**Fixed:**
|
||||
- Callsigns like `S53CC`, `S51A`, etc. were not being marked as worked in the SimpleLogFile interpreter → recognition pattern improved.
|
||||
|
||||
*(Bug reported by Boris, S53CC – thank you!)*
|
||||
|
||||
---
|
||||
|
||||
## 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)~~ ✅ **Implemented in v1.40** (3-day lifetime, no manual reset needed anymore)
|
||||
- Filtering the "Cluster & QSO of others" window to own QTF
|
||||
- Further topography-based calculations for direction warnings
|
||||
200
github_docs/en-Configuration.md
Normal file
@@ -0,0 +1,200 @@
|
||||
# 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` on Linux and in `%USERPROFILE%\.praktikst\preferences.xml` (or `C:\Users\<Username>\.praktikst\preferences.xml`) on Windows. From v1.21 onwards, window sizes and divider positions are also saved when you click Save.
|
||||
|
||||
---
|
||||
|
||||
## Station Settings
|
||||
|
||||

|
||||
|
||||
### Login and Chat Categories
|
||||
|
||||
Enter your ON4KST chat credentials here (callsign and password).
|
||||
Also, select the **primary chat category** (e.g., IARU Region 1 VHF/Microwave).
|
||||
|
||||
With the option for a **second chat** (Multi-Channel Login), you can log in to another category simultaneously (e.g., UHF/SHF). Both chats will then be monitored in parallel. You can optionally specify a different login name for the second chat (useful for Opposite Station Multi-Callsign Logging).
|
||||
|
||||
### Callsign and Locator
|
||||
|
||||
Enter your own callsign and Maidenhead locator (6 characters, e.g., `JN49IJ`). These values are needed for distance and direction calculations.
|
||||
|
||||
### Active Bands
|
||||
|
||||
Use the **"my station uses band"** checkboxes to select the active bands. Buttons and table rows will only appear in the user interface for selected bands. The software must be restarted after making changes.
|
||||
|
||||
### 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 effective; DM5M uses quads with 69°.
|
||||
|
||||
> **Do not** enter fantasy values – the direction calculations will become useless.
|
||||
|
||||
### Default Maximum QRB
|
||||
|
||||
Maximum distance (in km) for which direction warnings should be triggered. A realistic value for DM5M is 900 km. Stations farther away are ignored for highlighting purposes.
|
||||
|
||||
---
|
||||
|
||||
## Server Settings (from v1.31)
|
||||
|
||||
The chat server DNS and port are configurable in the Preferences:
|
||||
|
||||
- **Server DNS**: Default `www.on4kst.org` (changed from `www.on4kst.info` in v1.31 hotfix).
|
||||
- **Port**: Default port of the ON4KST server.
|
||||
|
||||
A change is only needed if the server moves or an alternative endpoint is used.
|
||||
|
||||
---
|
||||
|
||||
## Log Sync Settings
|
||||
|
||||
Three 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 for callsign patterns. No band information is available. Suitable as a fallback or for log programs that are not directly supported.
|
||||
|
||||
### Network Listener for Logger's QSO UDP Broadcast
|
||||
|
||||
**Recommended method.** KST4Contest listens for UDP packets sent by the logging software to the broadcast address when a QSO is saved. Stations are marked with band information. UDP port: default **12060**. (Used by UCXLog, N1MM+, QARTest, DXLog.net, etc.).
|
||||
|
||||
### Win-Test Network Listener (Additional UDP Listener)
|
||||
|
||||
A dedicated network listener for Win-Test. KST4Contest receives and processes Win-Test-specific UDP packets (including sked handovers) on the configured port.
|
||||
|
||||
---
|
||||
|
||||
## TRX Sync Settings
|
||||
|
||||
Receives the current transceiver frequency from the logging software via UDP. This enables the automatic population of the `MYQRG` variable. 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 pronounced phonetically.
|
||||
|
||||
---
|
||||
|
||||
## Shortcut Settings
|
||||
|
||||
Configuration of 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
|
||||
|
||||
Configuration of an automatic interval beacon 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 when 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 own CQ QRG**: When someone asks for your QRG, KST4Contest automatically replies with the content of the `MYQRG` variable.
|
||||
- **Default filter for the userinfo window**: Pre-configured message filter for the station info window *(for Gianluca :-) )*.
|
||||
|
||||
---
|
||||
|
||||
## Win-Test Network Listener (from v1.31)
|
||||
|
||||
A dedicated listener for Win-Test-specific UDP packets. Enables:
|
||||
|
||||
- **Log synchronisation**: Worked stations are retrieved from Win-Test and marked in the user list.
|
||||
- **Frequency parsing**: The current TRX frequency from Win-Test populates the `MYQRG` variable.
|
||||
- **Sked handover (SKED push)**: Skeds from KST4Contest are passed directly to Win-Test via UDP. Win-Test's default UDP broadcast port (9871) is used.
|
||||
|
||||
Settings:
|
||||
- **Enable/Disable**: Checkbox in Preferences (from v1.40).
|
||||
- **Port**: Configurable UDP port for the Win-Test listener.
|
||||
- **Sked UDP address and port**: Target address and port for SKED handover to Win-Test.
|
||||
|
||||
> **Note**: The Win-Test listener is an **additional** listener – the standard QSO UDP broadcast listener on port 12060 remains independent.
|
||||
|
||||
---
|
||||
|
||||
## PSTRotator Settings (from v1.31)
|
||||
|
||||
KST4Contest can control antenna direction via PSTRotator.
|
||||
|
||||
Settings:
|
||||
- **Enable/Disable**: Checkbox in Preferences (from v1.40).
|
||||
- **IP address**: IP address of the PSTRotator computer (default: `127.0.0.1` when running on the same PC).
|
||||
- **Port**: Communication port of PSTRotator.
|
||||
|
||||
> **Note**: After clicking a direction button, KST4Contest waits briefly for the rotator response. With slow rotors (e.g. SPID) there may be a small delay.
|
||||
|
||||
---
|
||||
|
||||
## Sniffer Settings (from v1.31)
|
||||
|
||||
The QSO sniffer filters chat messages from configurable callsigns and forwards them to the PM window.
|
||||
|
||||
Settings:
|
||||
- **Callsign list**: Comma-separated list of callsigns whose messages are always forwarded to the PM window.
|
||||
|
||||
Use case: Keep track of important stations (e.g. DX expeditions or trusted contest allies) without constantly monitoring the main chat.
|
||||
|
||||
---
|
||||
|
||||
## Worked Station Database Settings
|
||||
|
||||
The internal worked database contains:
|
||||
|
||||
- Worked status of all stations (per band)
|
||||
- NOT-QRV tags (since v1.2)
|
||||
|
||||
**From v1.40**: Entries have an automatic lifetime of **3 days** – manually resetting before each contest is no longer strictly necessary. For a full reset, the **"Reinitialize"** button is still available.
|
||||
|
||||
---
|
||||
|
||||
## Dark Mode (from v1.26)
|
||||
|
||||
Toggle via the menu: **Window → Use Dark Mode**. The colors can be individually customized via CSS.
|
||||
|
||||
---
|
||||
|
||||
## Saving Settings
|
||||
|
||||
Click **"Save Settings"** after **every** change! Without saving, all changes will be lost on the next start.
|
||||
|
||||
- Storage location: `~/.praktikst/preferences.xml` on Linux and `%USERPROFILE%\.praktikst\preferences.xml` (or `C:\Users\<Username>\.praktikst\preferences.xml`) on Windows
|
||||
- From v1.21: Window sizes and divider positions are also saved.
|
||||
- If you encounter problems: delete the configuration file → KST4Contest will create a new one with default values.
|
||||
76
github_docs/en-DX-Cluster-Server.md
Normal file
@@ -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.
|
||||
235
github_docs/en-Features.md
Normal file
@@ -0,0 +1,235 @@
|
||||
# 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 with ALERT (from v1.40)
|
||||
|
||||
A sked reminder service with automatic messages can be activated for each chat member. Configurable interval patterns:
|
||||
|
||||
- **2+1 minutes**: Messages at 2 min and 1 min before the sked.
|
||||
- **5+2+1 minutes**: Messages at 5, 2 and 1 min before the sked.
|
||||
- **10+5+2+1 minutes**: Messages at 10, 5, 2 and 1 min before the sked.
|
||||
|
||||
In addition to the automated messages to the remote station, there is an **acoustic and visual notification** for your own operator so no sked is ever missed.
|
||||
|
||||
Activate from the FurtherInfo panel of the corresponding station.
|
||||
|
||||
---
|
||||
|
||||
## QSO Sniffer (from v1.31)
|
||||
|
||||
The QSO sniffer monitors the chat for messages from a configurable callsign list and automatically forwards them to the **PM window**. This prevents relevant messages from being lost in the general chat traffic.
|
||||
|
||||
Configuration: [Configuration – Sniffer Settings](en-Configuration#sniffer-settings-from-v131)
|
||||
|
||||
---
|
||||
|
||||
## Win-Test Integration (from v1.31, fully configurable from v1.40)
|
||||
|
||||
KST4Contest fully supports [Win-Test](https://www.win-test.com/) as a logging programme:
|
||||
|
||||
- **Log synchronisation**: Worked stations are automatically retrieved from Win-Test and marked in the user list.
|
||||
- **Frequency parsing**: The current TRX frequency is read from Win-Test UDP packets and populates the `MYQRG` variable.
|
||||
- **Sked handover (SKED push via UDP)**: Agreed skeds from KST4Contest can be pushed directly to Win-Test, so the remote callsign appears in Win-Test's sked window.
|
||||
|
||||
Details: [Configuration – Win-Test Network Listener](en-Configuration#win-test-network-listener)
|
||||
|
||||
---
|
||||
|
||||
## PSTRotator Interface (from v1.31, fully configurable from v1.40)
|
||||
|
||||
KST4Contest can control antenna direction directly via **PSTRotator**. When a station is selected in the user list, the rotator can automatically be turned to the QTF of the selected station.
|
||||
|
||||
Configuration: [Configuration – PSTRotator Settings](en-Configuration#pstrotator-settings-from-v131)
|
||||
|
||||
---
|
||||
|
||||
## Band Alert for New QSOs (from v1.40)
|
||||
|
||||
When a station is logged, KST4Contest automatically checks whether that station has shown any other active bands in the chat that you are also QRV on. If so, a **hint alert** appears so no multi-band opportunity is missed.
|
||||
|
||||
---
|
||||
|
||||
## Worked Tag Lifetime (from v1.40)
|
||||
|
||||
Worked stations are automatically removed from the database after **3 days**. Manually resetting the worked database before each contest is therefore no longer strictly necessary – the database keeps itself up to date.
|
||||
|
||||
---
|
||||
|
||||
## Chatmember Score System / Priority List (from v1.40)
|
||||
|
||||
KST4Contest automatically calculates a **priority score** for each active chat member. The score is derived from:
|
||||
|
||||
- Antenna direction of the remote station (is it pointing towards me?)
|
||||
- QRB (distance)
|
||||
- Activity time and message count
|
||||
- Active bands and frequencies
|
||||
- AP availability (AirScout)
|
||||
- Sked direction (degrees)
|
||||
- Sked success rate and skedfail markings
|
||||
|
||||
The top candidates are highlighted in a dedicated priority list, helping you not to miss the most important contacts during contest stress.
|
||||
|
||||
Stations with a failed sked can be marked using the **Skedfail button** in the FurtherInfo panel – this temporarily lowers their score.
|
||||
|
||||
---
|
||||
|
||||
## AP Timeline (from v1.40)
|
||||
|
||||
A visual timeline shows up to 4 highly-scored stations per minute slot that should be workable via aircraft scatter. Prioritisation criteria:
|
||||
|
||||
- **Highest reflection potential** is preferred (not necessarily the fastest arrival).
|
||||
- Stations towards which your antenna is not pointing are shown **transparently**.
|
||||
|
||||
This gives the contest operator a quick overview of which stations will be reachable via which aircraft and at what time.
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
51
github_docs/en-Home.md
Normal file
@@ -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, update |
|
||||
| [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 explanation and operation |
|
||||
| [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://github.com/praktimarc/kst4contest/releases/latest
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
114
github_docs/en-Installation.md
Normal file
@@ -0,0 +1,114 @@
|
||||
# Installation
|
||||
|
||||
> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Installation)
|
||||
|
||||
## Prerequisites
|
||||
|
||||
An resolution of 1200px by 720px is recommended
|
||||
|
||||
### ON4KST Account
|
||||
|
||||
To use the chat, a registered account with the ON4KST chat service is required:
|
||||
|
||||
- Register at: http://www.on4kst.info/chat/register.php
|
||||
|
||||
### Chat 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.
|
||||
|
||||
### Personal Messages
|
||||
|
||||
To send a private message to another station, always use the following format:
|
||||
|
||||
```
|
||||
/CQ CALLSIGN message text
|
||||
```
|
||||
|
||||
Example: `/CQ DL5ASG pse sked 144.205?`
|
||||
|
||||
During heavy chat traffic (5–6 messages per second in a contest), public messages directed at a specific callsign are easily missed. However, KST4Contest also catches such messages if they are accidentally posted publicly (see [Features – PM Catching](Features#catching-personal-messages)).
|
||||
|
||||
---
|
||||
|
||||
## Download
|
||||
|
||||
### Windows
|
||||
|
||||
The latest version can be downloaded as a ZIP file:
|
||||
|
||||
**https://github.com/praktimarc/kst4contest/releases/latest**
|
||||
|
||||
The filename has the format `praktiKST-v<version_number>-windows-x64.zip`.
|
||||
|
||||
### Linux
|
||||
|
||||
The latest version can be downloaded as an AppImage:
|
||||
|
||||
**https://github.com/praktimarc/kst4contest/releases/latest**
|
||||
|
||||
The filename has the format `praktiKST-v<version_number>-linux-x86_64.AppImage`.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Installation
|
||||
|
||||
### Windows
|
||||
|
||||
1. Download the ZIP file.
|
||||
2. Unzip the ZIP file into a folder of your choice.
|
||||
3. Run `praktiKST.exe`.
|
||||
|
||||
Settings are stored at `%USERPROFILE%\.praktikst\preferences.xml`.
|
||||
|
||||
### Linux
|
||||
1. Download the AppImage.
|
||||
2. Unzip the AppImage into a folder of your choice.
|
||||
3. Make the AppImage executable (in the terminal with `chmod +x praktiKST-v<version_number>-linux-x86_64.AppImage`)
|
||||
4. Run the AppImage.
|
||||
|
||||
Settings are stored at `~/.praktikst/preferences.xml`.
|
||||
|
||||
---
|
||||
|
||||
## Updating
|
||||
|
||||
KST4Contest includes an **automatic update notification service**: as soon as a new version is available, a window will appear at startup with:
|
||||
- information that a new version is available,
|
||||
- a changelog,
|
||||
- the download link for the new version.
|
||||
|
||||

|
||||
|
||||
### Update Process
|
||||
|
||||
#### Windows
|
||||
|
||||
Currently, there is only one way to update:
|
||||
|
||||
1. Delete the old folder.
|
||||
2. Unzip the new ZIP file.
|
||||
|
||||
The settings file (`preferences.xml`) is preserved because it is stored in the user folder, not the program folder.
|
||||
|
||||
#### Linux
|
||||
|
||||
Currently as follows:
|
||||
1. Download the new AppImage
|
||||
2. Mark the new AppImage as executable
|
||||
3. (optional) Delete the old AppImage.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Known Issues at Startup
|
||||
|
||||
### Norton 360
|
||||
|
||||
Norton 360 classifies `praktiKST.exe` as dangerous (false positive). An exception must be created for the file:
|
||||
|
||||
1. Open Norton 360.
|
||||
2. Security → History → Find the corresponding event.
|
||||
3. Select "Restore & Add Exception".
|
||||
|
||||
*(Reported by PE0WGA, Franz van Velzen – thank you!)*
|
||||
138
github_docs/en-Log-Sync.md
Normal file
@@ -0,0 +1,138 @@
|
||||
# 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
|
||||
|
||||
### Win-Test
|
||||
|
||||
Win-Test is supported with a dedicated UDP network listener that understands the native Win-Test network protocol.
|
||||
|
||||
**Advantages of Win-Test Integration:**
|
||||
- Automatic QSO synchronization to mark worked stations.
|
||||
- **Sked Handover (ADDSKED):** Using the "Create sked" button in the station info panel not only creates a sked in KST4Contest but also *sends it directly via UDP to the Win-Test network as an ADDSKED packet*.
|
||||
- You can choose between "AUTO", "SSB", or "CW" sked modes.
|
||||
|
||||
**Required Settings in KST4Contest:**
|
||||
- `UDP-Port for Win-Test listener` (Default: 9871).
|
||||
- Enable `Receive Win-Test network based UDP log messages`.
|
||||
- Enable `Win-Test sked transmission (push via ADDSKED to Win-Test network)`.
|
||||
- `KST station name in Win-Test network (src of SKED packets)`: Defines the station name KST4Contest uses in the WT network (e.g., "KST").
|
||||
- `Win-Test station name filter`: If a name is entered here (e.g., "STN1"), only QSOs from that specific Win-Test instance will be processed. Leave empty to accept all.
|
||||
- `Win-Test network broadcast address`: Is usually detected automatically and is required to send sked packets to the network.
|
||||
|
||||
**Settings in Win-Test:**
|
||||
- The network in Win-Test must be active.
|
||||
- Win-Test must be configured to send/receive its broadcasts on the corresponding port (default 9871).
|
||||
|
||||
---
|
||||
|
||||
## 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)
|
||||
162
github_docs/en-Macros-and-Variables.md
Normal file
@@ -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.
|
||||
105
github_docs/en-User-Interface.md
Normal file
@@ -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.
|
||||
BIN
github_docs/qartest_logsync.png
Normal file
|
After Width: | Height: | Size: 1.5 MiB |
BIN
github_docs/qrg_buttons.png
Normal file
|
After Width: | Height: | Size: 4.6 KiB |
BIN
github_docs/ucxlog_logsync.png
Normal file
|
After Width: | Height: | Size: 250 KiB |
BIN
github_docs/update_window.png
Normal file
|
After Width: | Height: | Size: 63 KiB |
2
pom.xml
@@ -6,7 +6,7 @@
|
||||
|
||||
<groupId>de.x08</groupId>
|
||||
<artifactId>praktiKST</artifactId>
|
||||
<version>1.40.0-nightly</version>
|
||||
<version>1.41.0-nightly</version>
|
||||
|
||||
<name>praktiKST</name>
|
||||
|
||||
|
||||
528
src/kstsimulator.py
Normal file
@@ -0,0 +1,528 @@
|
||||
import socket
|
||||
import threading
|
||||
import time
|
||||
import random
|
||||
import traceback
|
||||
from datetime import datetime, timedelta
|
||||
|
||||
# =====================================
|
||||
# KST-Server-Simulator / DO5AMF
|
||||
# Usage: change configuration below and
|
||||
# run. Enter 127.0.0.1 : 23001 as a
|
||||
# target in KST4Contest or another
|
||||
# KST chat client.
|
||||
# =====================================
|
||||
|
||||
# ==========================================
|
||||
# KONFIGURATION
|
||||
# ==========================================
|
||||
|
||||
PORT = 23001
|
||||
HOST = '127.0.0.1'
|
||||
|
||||
MSG_TO_USER_INTERVAL = 300.0
|
||||
LOGIN_LOGOUT_INTERVAL = 60.0
|
||||
KEEP_ALIVE_INTERVAL = 10.0
|
||||
CLIENT_WARMUP_TIME = 5.0
|
||||
|
||||
PROB_INACTIVE = 0.10
|
||||
PROB_REACTIVE = 0.20
|
||||
|
||||
# QSY Wahrscheinlichkeit (Wie oft wechselt ein User seine Frequenz?)
|
||||
# 0.05 = 5% Chance pro Nachricht, dass er die Frequenz ändert. Sonst bleibt er stabil.
|
||||
PROB_QSY = 0.05
|
||||
|
||||
BANDS_VHF = { "2m": (144.150, 144.400), "70cm": (432.100, 432.300) }
|
||||
BANDS_UHF = { "23cm": (1296.100, 1296.300), "3cm": (10368.100, 10368.250) }
|
||||
|
||||
CHANNELS_SETUP = {
|
||||
"2": {
|
||||
"NAME": "144/432 MHz",
|
||||
"NUM_USERS": 777,
|
||||
"BANDS": BANDS_VHF,
|
||||
"RATES": {"PUBLIC": 0.5, "DIRECTED": 3.0},
|
||||
"PERMANENT": [
|
||||
{"call": "DK5EW", "name": "Erwin", "loc": "JN47NX"},
|
||||
{"call": "DL1TEST", "name": "TestOp", "loc": "JO50XX"}
|
||||
]
|
||||
},
|
||||
"3": {
|
||||
"NAME": "Microwave",
|
||||
"NUM_USERS": 333,
|
||||
"BANDS": BANDS_UHF,
|
||||
"RATES": {"PUBLIC": 0.2, "DIRECTED": 0.5},
|
||||
"PERMANENT": [
|
||||
{"call": "ON4KST", "name": "Alain", "loc": "JO20HI"},
|
||||
{"call": "G4CBW", "name": "MwTest", "loc": "IO83AA"}
|
||||
]
|
||||
}
|
||||
}
|
||||
|
||||
COUNTRY_MAPPING = {
|
||||
"DL": ["JO", "JN"], "DA": ["JO", "JN"], "DF": ["JO", "JN"], "DJ": ["JO", "JN"], "DK": ["JO", "JN"], "DO": ["JO", "JN"],
|
||||
"F": ["JN", "IN", "JO"], "G": ["IO", "JO"], "M": ["IO", "JO"], "2E": ["IO", "JO"],
|
||||
"PA": ["JO"], "ON": ["JO"], "OZ": ["JO"], "SM": ["JO", "JP"], "LA": ["JO", "JP"],
|
||||
"OH": ["KP"], "SP": ["JO", "KO"], "OK": ["JO", "JN"], "OM": ["JN", "KN"],
|
||||
"HA": ["JN", "KN"], "S5": ["JN"], "9A": ["JN"], "HB9": ["JN"], "OE": ["JN"],
|
||||
"I": ["JN", "JM"], "IK": ["JN", "JM"], "IU": ["JN", "JM"], "EA": ["IN", "IM"],
|
||||
"CT": ["IM"], "EI": ["IO"], "GM": ["IO"], "GW": ["IO"], "YO": ["KN"],
|
||||
"YU": ["KN"], "LZ": ["KN"], "SV": ["KM", "KN"], "UR": ["KO", "KN"],
|
||||
"LY": ["KO"], "YL": ["KO"], "ES": ["KO"]
|
||||
}
|
||||
|
||||
NAMES = ["Hans", "Peter", "Jo", "Alain", "Mike", "Sven", "Ole", "Jean", "Bob", "Tom", "Giovanni", "Mario", "Frank", "Steve", "Dave"]
|
||||
|
||||
MSG_TEMPLATES_WITH_FREQ = [
|
||||
"QSY {freq}", "PSE QSY {freq}", "Calling CQ on {freq}", "I am QRV on {freq}",
|
||||
"Listening on {freq}", "Can you try {freq}?", "Signals strong on {freq}",
|
||||
"Scattering on {freq}", "Please go to {freq}", "Running test on {freq}",
|
||||
"Any takers for {freq}?", "Back to {freq}", "QRG {freq}?", "Aircraft scatter {freq}"
|
||||
]
|
||||
|
||||
MSG_TEMPLATES_TEXT_ONLY = [
|
||||
"TNX for QSO", "73 all", "Anyone for sked?", "Good conditions",
|
||||
"Nothing heard", "Rain scatter?", "Waiting for moonrise", "CQ Contest",
|
||||
"QRZ?", "My locator is {loc}", "Band is open"
|
||||
]
|
||||
|
||||
REPLY_TEMPLATES = [
|
||||
"Hello {user}, 599 here", "Rgr {user}, tnx for report", "Yes {user}, QSY?",
|
||||
"Sorry {user}, no copy", "Pse wait 5 min {user}", "Ok {user}, 73",
|
||||
"Locator is {loc}", "Go to {freq} please", "Rgr {user}, gl"
|
||||
]
|
||||
|
||||
# ==========================================
|
||||
# CLIENT WRAPPER
|
||||
# ==========================================
|
||||
|
||||
class ConnectedClient:
|
||||
def __init__(self, sock, addr):
|
||||
self.sock = sock
|
||||
self.addr = addr
|
||||
self.call = f"GUEST_{random.randint(1000,9999)}"
|
||||
self.channels = {"2"}
|
||||
self.login_time = time.time()
|
||||
self.lock = threading.Lock()
|
||||
|
||||
def send_safe(self, data_str):
|
||||
if not data_str: return True
|
||||
with self.lock:
|
||||
try:
|
||||
self.sock.sendall(data_str.encode('latin-1', errors='replace'))
|
||||
return True
|
||||
except:
|
||||
return False
|
||||
|
||||
def close(self):
|
||||
try: self.sock.close()
|
||||
except: pass
|
||||
|
||||
# ==========================================
|
||||
# LOGIK KLASSEN
|
||||
# ==========================================
|
||||
|
||||
class MessageFactory:
|
||||
@staticmethod
|
||||
def get_stable_frequency(user, band_name, min_f, max_f):
|
||||
"""Liefert eine stabile Frequenz für diesen User auf diesem Band"""
|
||||
# Wenn noch keine Frequenz da ist ODER Zufall zuschlägt (QSY)
|
||||
if band_name not in user['freqs'] or random.random() < PROB_QSY:
|
||||
freq_val = round(random.uniform(min_f, max_f), 3)
|
||||
user['freqs'][band_name] = f"{freq_val:.3f}"
|
||||
|
||||
return user['freqs'][band_name]
|
||||
|
||||
@staticmethod
|
||||
def get_chat_message(bands_config, user):
|
||||
try:
|
||||
# Entscheidung: Text mit Frequenz oder ohne?
|
||||
if random.random() < 0.7:
|
||||
# Wähle zufälliges Band aus den verfügbaren
|
||||
band_name = random.choice(list(bands_config.keys()))
|
||||
min_f, max_f = bands_config[band_name]
|
||||
|
||||
# Hole STABILE Frequenz für diesen User
|
||||
freq_str = MessageFactory.get_stable_frequency(user, band_name, min_f, max_f)
|
||||
|
||||
return random.choice(MSG_TEMPLATES_WITH_FREQ).format(freq=freq_str)
|
||||
else:
|
||||
return random.choice(MSG_TEMPLATES_TEXT_ONLY).format(loc=user['loc'])
|
||||
except: return "TNX 73"
|
||||
|
||||
@staticmethod
|
||||
def get_reply_msg(bands, target_call, my_loc):
|
||||
try:
|
||||
tmpl = random.choice(REPLY_TEMPLATES)
|
||||
freq_str = "QSY?"
|
||||
# Bei Replies simulieren wir oft nur "QSY?" ohne konkrete Frequenz,
|
||||
# oder nutzen eine zufällige, da der Kontext fehlt.
|
||||
if "{freq}" in tmpl and bands:
|
||||
band_name = random.choice(list(bands.keys()))
|
||||
min_f, max_f = bands[band_name]
|
||||
freq_str = f"{round(random.uniform(min_f, max_f), 3):.3f}"
|
||||
return tmpl.format(user=target_call, loc=my_loc, freq=freq_str)
|
||||
except: return "TNX 73"
|
||||
|
||||
class UserFactory:
|
||||
registry = {}
|
||||
|
||||
@classmethod
|
||||
def get_or_create_user(cls, channel_id, current_channel_users):
|
||||
# 1. Reuse existing
|
||||
candidates = [u for call, u in cls.registry.items() if call not in current_channel_users]
|
||||
if candidates and random.random() < 0.5:
|
||||
return random.choice(candidates)
|
||||
|
||||
# 2. Create new
|
||||
return cls._create_new_unique_user(channel_id, current_channel_users)
|
||||
|
||||
@classmethod
|
||||
def _create_new_unique_user(cls, channel_id, current_channel_users):
|
||||
while True:
|
||||
prefix = random.choice(list(COUNTRY_MAPPING.keys()))
|
||||
num = random.randint(0, 9)
|
||||
suffix = "".join(random.choices("ABCDEFGHIJKLMNOPQRSTUVWXYZ", k=random.randint(1,3)))
|
||||
call = f"{prefix}{num}{suffix}"
|
||||
|
||||
if call in current_channel_users: continue
|
||||
if call in cls.registry: return cls.registry[call]
|
||||
|
||||
valid_grids = COUNTRY_MAPPING[prefix]
|
||||
grid_prefix = random.choice(valid_grids)
|
||||
sq_num = f"{random.randint(0,99):02d}"
|
||||
sub = "".join(random.choices("ABCDEFGHIJKLMNOPQRSTUVWXYZ", k=2))
|
||||
loc = f"{grid_prefix}{sq_num}{sub}"
|
||||
|
||||
name = random.choice(NAMES)
|
||||
rand = random.random()
|
||||
if rand < PROB_INACTIVE: role = "INACTIVE"
|
||||
elif rand < (PROB_INACTIVE + PROB_REACTIVE): role = "REACTIVE"
|
||||
else: role = "ACTIVE"
|
||||
|
||||
# Neu V31: Frequenz-Gedächtnis
|
||||
user_data = {
|
||||
"call": call,
|
||||
"name": name,
|
||||
"loc": loc,
|
||||
"role": role,
|
||||
"freqs": {} # Speicher für { '2m': '144.300' }
|
||||
}
|
||||
|
||||
cls.registry[call] = user_data
|
||||
return user_data
|
||||
|
||||
@classmethod
|
||||
def register_permanent(cls, user_data):
|
||||
# Sicherstellen, dass auch Permanent User Freq-Memory haben
|
||||
if "freqs" not in user_data:
|
||||
user_data["freqs"] = {}
|
||||
cls.registry[user_data['call']] = user_data
|
||||
|
||||
# ==========================================
|
||||
# CHANNEL INSTANCE
|
||||
# ==========================================
|
||||
|
||||
class ChannelInstance:
|
||||
def __init__(self, cid, config, server):
|
||||
self.id = cid
|
||||
self.config = config
|
||||
self.server = server
|
||||
|
||||
self.users_pool = []
|
||||
self.online_users = {}
|
||||
self.history_chat = []
|
||||
|
||||
self.last_pub = time.time()
|
||||
self.last_dir = time.time()
|
||||
self.last_me = time.time()
|
||||
self.last_login = time.time()
|
||||
|
||||
self.rate_pub = 1.0 / config["RATES"]["PUBLIC"]
|
||||
self.rate_dir = 1.0 / config["RATES"]["DIRECTED"]
|
||||
|
||||
self._init_data()
|
||||
|
||||
def _init_data(self):
|
||||
print(f"[*] Init Channel {self.id} ({self.config['NAME']})...")
|
||||
|
||||
for u in self.config["PERMANENT"]:
|
||||
u_full = u.copy()
|
||||
u_full["role"] = "ACTIVE"
|
||||
UserFactory.register_permanent(u_full)
|
||||
self.online_users[u['call']] = u_full
|
||||
|
||||
for _ in range(self.config["NUM_USERS"]):
|
||||
new_u = UserFactory.get_or_create_user(self.id, self.online_users.keys())
|
||||
self.users_pool.append(new_u)
|
||||
|
||||
fill = int(self.config["NUM_USERS"] * 0.9)
|
||||
for i in range(fill):
|
||||
u = self.users_pool[i]
|
||||
if u['call'] not in self.online_users:
|
||||
self.online_users[u['call']] = u
|
||||
|
||||
print(f"[*] Channel {self.id} ready: {len(self.online_users)} Users.")
|
||||
self._prefill_history()
|
||||
|
||||
def _prefill_history(self):
|
||||
actives = [u for u in self.online_users.values() if u['role'] == "ACTIVE"]
|
||||
if not actives: return
|
||||
start = datetime.now() - timedelta(minutes=15)
|
||||
for i in range(30):
|
||||
msg_time = start + timedelta(seconds=i*30)
|
||||
ts = str(int(msg_time.timestamp()))
|
||||
sender = random.choice(actives)
|
||||
if i % 2 == 0:
|
||||
text = MessageFactory.get_chat_message(self.config["BANDS"], sender)
|
||||
frame = f"CH|{self.id}|{ts}|{sender['call']}|{sender['name']}|0|{text}|0|\r\n"
|
||||
else:
|
||||
target = random.choice(list(self.online_users.values()))
|
||||
text = MessageFactory.get_reply_msg(self.config["BANDS"], target['call'], sender['loc'])
|
||||
frame = f"CH|{self.id}|{ts}|{sender['call']}|{sender['name']}|0|{text}|{target['call']}|\r\n"
|
||||
self.history_chat.append(frame)
|
||||
|
||||
def tick(self, now):
|
||||
actives = [u for u in self.online_users.values() if u['role'] == "ACTIVE"]
|
||||
if not actives: return
|
||||
|
||||
# PUBLIC
|
||||
if now - self.last_pub > self.rate_pub:
|
||||
self.last_pub = now
|
||||
u = random.choice(actives)
|
||||
# V31: Nutzt jetzt get_chat_message, das das Freq-Memory abfragt
|
||||
text = MessageFactory.get_chat_message(self.config["BANDS"], u)
|
||||
ts = str(int(now))
|
||||
frame = f"CH|{self.id}|{ts}|{u['call']}|{u['name']}|0|{text}|0|\r\n"
|
||||
self._add_hist(frame)
|
||||
self.server.broadcast_to_channel(self.id, frame)
|
||||
|
||||
# DIRECTED
|
||||
if now - self.last_dir > self.rate_dir:
|
||||
self.last_dir = now
|
||||
if len(actives) > 5:
|
||||
u1 = random.choice(actives)
|
||||
u2 = random.choice(list(self.online_users.values()))
|
||||
if u1 != u2:
|
||||
if random.random() < 0.5:
|
||||
# Auch hier Frequenzstabilität beachten
|
||||
text = MessageFactory.get_chat_message(self.config["BANDS"], u1)
|
||||
else:
|
||||
text = MessageFactory.get_reply_msg(self.config["BANDS"], u2['call'], u1['loc'])
|
||||
ts = str(int(now))
|
||||
frame = f"CH|{self.id}|{ts}|{u1['call']}|{u1['name']}|0|{text}|{u2['call']}|\r\n"
|
||||
self.server.broadcast_to_channel(self.id, frame)
|
||||
if u2['role'] != "INACTIVE":
|
||||
threading.Thread(target=self._schedule_reply, args=(u2['call'], u1['call']), daemon=True).start()
|
||||
|
||||
# MSG TO YOU
|
||||
if now - self.last_me > MSG_TO_USER_INTERVAL:
|
||||
self.last_me = now
|
||||
target_client = self.server.get_random_subscriber(self.id)
|
||||
if target_client and actives:
|
||||
if not target_client.call.startswith("GUEST"):
|
||||
sender = random.choice(actives)
|
||||
text = MessageFactory.get_chat_message(self.config["BANDS"], sender)
|
||||
print(f"[SIM Ch{self.id}] MSG TO YOU ({target_client.call})")
|
||||
self.process_msg(sender['call'], sender['name'], text, target_client.call)
|
||||
|
||||
# LOGIN/LOGOUT
|
||||
if now - self.last_login > LOGIN_LOGOUT_INTERVAL:
|
||||
self.last_login = now
|
||||
if random.choice(['IN', 'OUT']) == 'OUT' and len(self.online_users) > 20:
|
||||
cands = [c for c in self.online_users if c not in [p['call'] for p in self.config["PERMANENT"]]]
|
||||
if cands:
|
||||
l = random.choice(cands)
|
||||
del self.online_users[l]
|
||||
self.server.broadcast_to_channel(self.id, f"UR6|{self.id}|{l}|\r\n")
|
||||
else:
|
||||
candidates = [u for u in self.users_pool if u['call'] not in self.online_users]
|
||||
if candidates:
|
||||
n = random.choice(candidates)
|
||||
self.online_users[n['call']] = n
|
||||
self.server.broadcast_to_channel(self.id, f"UA5|{self.id}|{n['call']}|{n['name']}|{n['loc']}|2|\r\n")
|
||||
|
||||
def process_msg(self, sender, name, text, target):
|
||||
ts = str(int(time.time()))
|
||||
frame = f"CH|{self.id}|{ts}|{sender}|{name}|0|{text}|{target}|\r\n"
|
||||
if target == "0": self._add_hist(frame)
|
||||
self.server.broadcast_to_channel(self.id, frame)
|
||||
if target in self.online_users:
|
||||
threading.Thread(target=self._schedule_reply, args=(target, sender), daemon=True).start()
|
||||
|
||||
def _schedule_reply(self, sim_sender, real_target):
|
||||
if sim_sender not in self.online_users: return
|
||||
u = self.online_users[sim_sender]
|
||||
if u['role'] == "INACTIVE": return
|
||||
|
||||
time.sleep(random.uniform(2.0, 5.0))
|
||||
if sim_sender in self.online_users:
|
||||
text = MessageFactory.get_reply_msg(self.config["BANDS"], real_target, u['loc'])
|
||||
ts = str(int(time.time()))
|
||||
|
||||
if self.server.is_real_user(real_target):
|
||||
print(f"[REPLY Ch{self.id}] {sim_sender} -> {real_target}")
|
||||
|
||||
frame = f"CH|{self.id}|{ts}|{sim_sender}|{u['name']}|0|{text}|{real_target}|\r\n"
|
||||
self.server.broadcast_to_channel(self.id, frame)
|
||||
|
||||
def _add_hist(self, frame):
|
||||
self.history_chat.append(frame)
|
||||
if len(self.history_chat) > 50: self.history_chat.pop(0)
|
||||
|
||||
def get_full_init_blob(self):
|
||||
blob = ""
|
||||
for u in self.online_users.values():
|
||||
blob += f"UA0|{self.id}|{u['call']}|{u['name']}|{u['loc']}|0|\r\n"
|
||||
for h in self.history_chat: blob += h
|
||||
blob += f"UE|{self.id}|{len(self.online_users)}|\r\n"
|
||||
return blob.encode('latin-1', errors='replace')
|
||||
|
||||
# ==========================================
|
||||
# SERVER
|
||||
# ==========================================
|
||||
|
||||
class KSTServerV31:
|
||||
def __init__(self):
|
||||
self.lock = threading.Lock()
|
||||
self.running = True
|
||||
self.clients = {}
|
||||
self.channels = {}
|
||||
|
||||
for cid, cfg in CHANNELS_SETUP.items():
|
||||
self.channels[cid] = ChannelInstance(cid, cfg, self)
|
||||
|
||||
def start(self):
|
||||
threading.Thread(target=self._sim_loop, daemon=True).start()
|
||||
|
||||
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
|
||||
s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
|
||||
try:
|
||||
s.bind((HOST, PORT))
|
||||
s.listen(5)
|
||||
s.settimeout(1.0)
|
||||
print(f"[*] ON4KST V31 (Stable Frequencies) running on {HOST}:{PORT}")
|
||||
|
||||
while self.running:
|
||||
try:
|
||||
sock, addr = s.accept()
|
||||
print(f"[*] CONNECT: {addr}")
|
||||
threading.Thread(target=self._handle_client, args=(sock,), daemon=True).start()
|
||||
except socket.timeout: continue
|
||||
except OSError: break
|
||||
except KeyboardInterrupt:
|
||||
print("\n[!] Stop.")
|
||||
finally:
|
||||
self.running = False
|
||||
try: s.close()
|
||||
except: pass
|
||||
|
||||
def _handle_client(self, sock):
|
||||
client_obj = ConnectedClient(sock, None)
|
||||
with self.lock:
|
||||
self.clients[sock] = client_obj
|
||||
|
||||
buffer = ""
|
||||
try:
|
||||
while self.running:
|
||||
try: data = sock.recv(2048)
|
||||
except: break
|
||||
if not data: break
|
||||
|
||||
buffer += data.decode('latin-1', errors='replace')
|
||||
while '\n' in buffer:
|
||||
line, buffer = buffer.split('\n', 1)
|
||||
line = line.strip()
|
||||
if not line: continue
|
||||
|
||||
parts = line.split('|')
|
||||
cmd = parts[0]
|
||||
|
||||
if cmd == 'LOGIN' or cmd == 'LOGINC':
|
||||
if len(parts) > 1:
|
||||
client_obj.call = parts[1].strip().upper()
|
||||
print(f"[LOGIN] {client_obj.call} (Ch 2)")
|
||||
|
||||
client_obj.send_safe(f"LOGSTAT|100|2|PySimV31|KEY|Conf|3|\r\n")
|
||||
if cmd == 'LOGIN':
|
||||
self._send_channel_init(client_obj, "2")
|
||||
|
||||
elif cmd == 'SDONE':
|
||||
self._send_channel_init(client_obj, "2")
|
||||
|
||||
elif cmd.startswith('ACHAT'):
|
||||
if len(parts) >= 2:
|
||||
new_chan = parts[1]
|
||||
if new_chan in self.channels:
|
||||
client_obj.channels.add(new_chan)
|
||||
print(f"[ACHAT] {client_obj.call} -> Ch {new_chan}")
|
||||
self._send_channel_init(client_obj, new_chan)
|
||||
|
||||
elif cmd == 'MSG':
|
||||
if len(parts) >= 4:
|
||||
cid = parts[1]
|
||||
target = parts[2]
|
||||
text = parts[3]
|
||||
if text.lower().startswith("/cq"):
|
||||
spl = text.split(' ', 2)
|
||||
if len(spl) >= 3:
|
||||
target = spl[1]; text = spl[2]
|
||||
if cid in self.channels:
|
||||
self.channels[cid].process_msg(client_obj.call, "Me", text, target)
|
||||
|
||||
elif cmd == 'CK': pass
|
||||
except Exception as e:
|
||||
print(f"[!] Err: {e}")
|
||||
finally:
|
||||
with self.lock:
|
||||
if sock in self.clients: del self.clients[sock]
|
||||
client_obj.close()
|
||||
|
||||
def _send_channel_init(self, client_obj, cid):
|
||||
if cid in self.channels:
|
||||
full_blob = self.channels[cid].get_full_init_blob()
|
||||
client_obj.send_safe(full_blob.decode('latin-1'))
|
||||
|
||||
def broadcast_to_channel(self, cid, frame):
|
||||
now = time.time()
|
||||
with self.lock:
|
||||
targets = list(self.clients.values())
|
||||
|
||||
for c in targets:
|
||||
if cid in c.channels:
|
||||
if now - c.login_time > CLIENT_WARMUP_TIME:
|
||||
c.send_safe(frame)
|
||||
|
||||
def get_random_subscriber(self, cid):
|
||||
with self.lock:
|
||||
subs = [c for c in self.clients.values() if cid in c.channels and not c.call.startswith("GUEST")]
|
||||
return random.choice(subs) if subs else None
|
||||
|
||||
def is_real_user(self, call):
|
||||
with self.lock:
|
||||
for c in self.clients.values():
|
||||
if c.call.upper() == call.upper() and not c.call.startswith("GUEST"):
|
||||
return True
|
||||
return False
|
||||
|
||||
def _sim_loop(self):
|
||||
print("[*] Sim Loop running...")
|
||||
last_ka = time.time()
|
||||
while self.running:
|
||||
now = time.time()
|
||||
time.sleep(0.02)
|
||||
|
||||
for c in self.channels.values():
|
||||
c.tick(now)
|
||||
|
||||
if now - last_ka > KEEP_ALIVE_INTERVAL:
|
||||
last_ka = now
|
||||
self.broadcast_global("CK|\r\n")
|
||||
|
||||
def broadcast_global(self, frame):
|
||||
with self.lock:
|
||||
targets = list(self.clients.values())
|
||||
for c in targets:
|
||||
c.send_safe(frame)
|
||||
|
||||
if __name__ == '__main__':
|
||||
KSTServerV31().start()
|
||||
@@ -23,6 +23,7 @@ import kst4contest.locatorUtils.DirectionUtils;
|
||||
import kst4contest.logic.PriorityCalculator;
|
||||
import kst4contest.model.*;
|
||||
import kst4contest.test.MockKstServer;
|
||||
import kst4contest.utils.BoundedDequeObservableList;
|
||||
import kst4contest.utils.PlayAudioUtils;
|
||||
import kst4contest.view.Kst4ContestApplication;
|
||||
|
||||
@@ -824,7 +825,84 @@ public class ChatController implements ThreadStatusCallback, PstRotatorEventList
|
||||
Platform.runLater(() -> {
|
||||
this.activeSkeds.add(sked);
|
||||
scoreService.requestRecompute("sked-added");
|
||||
}); //TODO: Addsked muss noch genutzt werden
|
||||
});
|
||||
|
||||
// Push sked to Win-Test via UDP if enabled
|
||||
if (chatPreferences.isLogsynch_wintestNetworkSkedPushEnabled()
|
||||
&& chatPreferences.isLogsynch_wintestNetworkListenerEnabled()) {
|
||||
pushSkedToWinTest(sked);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Pushes a sked to Win-Test via UDP broadcast (LOCKSKED / ADDSKED / UNLOCKSKED).
|
||||
* Runs on a background thread to avoid blocking the UI.
|
||||
*/
|
||||
private void pushSkedToWinTest(ContestSked sked) {
|
||||
new Thread(() -> {
|
||||
try {
|
||||
InetAddress broadcastAddr = InetAddress.getByName(
|
||||
chatPreferences.getLogsynch_wintestNetworkBroadcastAddress());
|
||||
int port = chatPreferences.getLogsynch_wintestNetworkPort();
|
||||
String stationName = chatPreferences.getLogsynch_wintestNetworkStationNameOfKST();
|
||||
|
||||
WinTestSkedSender sender = new WinTestSkedSender(stationName, broadcastAddr, port, this);
|
||||
|
||||
// Get current frequency from QRG property (set by Win-Test STATUS or user)
|
||||
double freqKHz = 144300.0; // fallback default
|
||||
try {
|
||||
String qrgStr = chatPreferences.getMYQRGFirstCat().get();
|
||||
if (qrgStr != null && !qrgStr.isBlank()) {
|
||||
// QRG is in display format like "144.300.00" – strip dots → "14430000" → / 100 → 144300.0 kHz
|
||||
String cleaned = qrgStr.trim().replace(".", "");
|
||||
freqKHz = Double.parseDouble(cleaned) / 100.0;
|
||||
}
|
||||
} catch (NumberFormatException ignored) { }
|
||||
|
||||
// Build notes string with target locator/azimuth info like reference: [JO02OB - 279°]
|
||||
String targetLocator = resolveSkedTargetLocator(sked.getTargetCallsign());
|
||||
String notes = "sked via KST4Contest";
|
||||
if (targetLocator != null && !targetLocator.isBlank() && sked.getTargetAzimuth() > 0) {
|
||||
notes = String.format("[%s - %.0f°] %s", targetLocator, sked.getTargetAzimuth(), notes);
|
||||
} else if (targetLocator != null && !targetLocator.isBlank()) {
|
||||
notes = String.format("[%s] %s", targetLocator, notes);
|
||||
} else if (sked.getTargetAzimuth() > 0) {
|
||||
notes = String.format("[%.0f°] %s", sked.getTargetAzimuth(), notes);
|
||||
}
|
||||
|
||||
// Determine mode: -1 = auto-detect, 0 = CW, 1 = SSB
|
||||
String modeStr = chatPreferences.getLogsynch_wintestSkedMode();
|
||||
int modeOverride = -1; // AUTO
|
||||
if ("CW".equalsIgnoreCase(modeStr)) modeOverride = 0;
|
||||
else if ("SSB".equalsIgnoreCase(modeStr)) modeOverride = 1;
|
||||
|
||||
sender.pushSkedToWinTest(sked, freqKHz, notes, modeOverride);
|
||||
} catch (Exception e) {
|
||||
System.out.println("[ChatController] Error pushing sked to Win-Test: " + e.getMessage());
|
||||
e.printStackTrace();
|
||||
}
|
||||
}, "WinTestSkedPush").start();
|
||||
}
|
||||
|
||||
private String resolveSkedTargetLocator(String targetCallsignRaw) {
|
||||
if (targetCallsignRaw == null || targetCallsignRaw.isBlank()) {
|
||||
return null;
|
||||
}
|
||||
|
||||
String normalizedTargetCall = normalizeCallRaw(targetCallsignRaw);
|
||||
synchronized (getLst_chatMemberList()) {
|
||||
for (ChatMember member : getLst_chatMemberList()) {
|
||||
if (member == null || member.getCallSignRaw() == null) continue;
|
||||
if (!normalizeCallRaw(member.getCallSignRaw()).equals(normalizedTargetCall)) continue;
|
||||
|
||||
String locator = member.getQra();
|
||||
if (locator != null && !locator.isBlank()) {
|
||||
return locator.trim().toUpperCase(Locale.ROOT);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
public StationMetricsService getStationMetricsService() {
|
||||
@@ -930,7 +1008,8 @@ public class ChatController implements ThreadStatusCallback, PstRotatorEventList
|
||||
// ******All abstract types below here are used by the messageprocessor!
|
||||
// ***************
|
||||
|
||||
private ObservableList<ChatMessage> lst_globalChatMessageList = FXCollections.observableArrayList(); //All chatmessages will be put in there, later create filtered message lists
|
||||
private static final int MAX_CHAT_MESSAGES = 10000;
|
||||
private final BoundedDequeObservableList<ChatMessage> lst_globalChatMessageList = new BoundedDequeObservableList<>(MAX_CHAT_MESSAGES); //All chatmessages will be put in there, later create filtered message lists
|
||||
// private ObservableList<ChatMessage> lst_toAllMessageList = FXCollections.observableArrayList(); // directed to all
|
||||
// (beacon)
|
||||
private FilteredList<ChatMessage> lst_toAllMessageList = new FilteredList<>(lst_globalChatMessageList); // directed to all
|
||||
@@ -1075,13 +1154,14 @@ public class ChatController implements ThreadStatusCallback, PstRotatorEventList
|
||||
this.lst_selectedCallSignInfofilteredMessageList = lst_selectedCallSignInfofilteredMessageList;
|
||||
}
|
||||
|
||||
public void addChatMessage(ChatMessage message) {
|
||||
lst_globalChatMessageList.addFirst(message);
|
||||
}
|
||||
|
||||
public ObservableList<ChatMessage> getLst_globalChatMessageList() {
|
||||
return lst_globalChatMessageList;
|
||||
}
|
||||
|
||||
public void setLst_globalChatMessageList(ObservableList<ChatMessage> lst_globalChatMessageList) {
|
||||
this.lst_globalChatMessageList = lst_globalChatMessageList;
|
||||
}
|
||||
|
||||
public String getHostname() {
|
||||
return hostname;
|
||||
|
||||
@@ -772,7 +772,7 @@ public class MessageBusManagementThread extends Thread {
|
||||
dummy.setCallSign("ALL");
|
||||
newMessageArrived.setReceiver(dummy);
|
||||
|
||||
this.client.getLst_globalChatMessageList().add(0, newMessageArrived); // sdtout to all message-List
|
||||
this.client.addChatMessage(newMessageArrived); // sdtout to all message-List
|
||||
|
||||
} else {
|
||||
//message is directed to another chatmember, process as such!
|
||||
@@ -817,7 +817,7 @@ public class MessageBusManagementThread extends Thread {
|
||||
if (newMessageArrived.getReceiver().getCallSign()
|
||||
.equals(this.client.getChatPreferences().getStn_loginCallSign())) {
|
||||
|
||||
this.client.getLst_globalChatMessageList().add(0, newMessageArrived);
|
||||
this.client.addChatMessage(newMessageArrived);
|
||||
|
||||
if (this.client.getChatPreferences().isNotify_playSimpleSounds()) {
|
||||
this.client.getPlayAudioUtils().playNoiseLauncher('P');
|
||||
@@ -960,7 +960,7 @@ public class MessageBusManagementThread extends Thread {
|
||||
String originalMessage = newMessageArrived.getMessageText();
|
||||
newMessageArrived
|
||||
.setMessageText("(>" + newMessageArrived.getReceiver().getCallSign() + ")" + originalMessage);
|
||||
this.client.getLst_globalChatMessageList().add(0,newMessageArrived);
|
||||
this.client.addChatMessage(newMessageArrived);
|
||||
|
||||
// if you sent the message to another station, it will be sorted in to
|
||||
// the "to me message list" with modified messagetext, added rxers callsign
|
||||
@@ -1024,7 +1024,7 @@ public class MessageBusManagementThread extends Thread {
|
||||
newMessageArrived.getSender().setInAngleAndRange(false);
|
||||
}
|
||||
|
||||
this.client.getLst_globalChatMessageList().add(0, newMessageArrived);
|
||||
this.client.addChatMessage(newMessageArrived);
|
||||
// System.out.println("MSGBS bgfx: tx call = " + newMessageArrived.getSender().getCallSign() + " / rx call = " + newMessageArrived.getReceiver().getCallSign());
|
||||
}
|
||||
} catch (NullPointerException referenceDeletedByUserLeftChatDuringMessageprocessing) {
|
||||
@@ -1364,7 +1364,7 @@ public class MessageBusManagementThread extends Thread {
|
||||
dummy.setCallSign("ALL");
|
||||
newMessageArrived.setReceiver(dummy);
|
||||
|
||||
this.client.getLst_globalChatMessageList().add(0, newMessageArrived); // sdtout to all message-List
|
||||
this.client.addChatMessage(newMessageArrived); // sdtout to all message-List
|
||||
|
||||
} else {
|
||||
//message is directed to another chatmember, process as such!
|
||||
@@ -1408,7 +1408,7 @@ public class MessageBusManagementThread extends Thread {
|
||||
if (newMessageArrived.getReceiver().getCallSign()
|
||||
.equals(this.client.getChatPreferences().getStn_loginCallSign())) {
|
||||
|
||||
this.client.getLst_globalChatMessageList().add(0, newMessageArrived);
|
||||
this.client.addChatMessage(newMessageArrived);
|
||||
|
||||
System.out.println("Historic message directed to me: " + newMessageArrived.getReceiver().getCallSign() + ".");
|
||||
|
||||
@@ -1421,7 +1421,7 @@ public class MessageBusManagementThread extends Thread {
|
||||
String originalMessage = newMessageArrived.getMessageText();
|
||||
newMessageArrived
|
||||
.setMessageText("(>" + newMessageArrived.getReceiver().getCallSign() + ")" + originalMessage);
|
||||
this.client.getLst_globalChatMessageList().add(0,newMessageArrived);
|
||||
this.client.addChatMessage(newMessageArrived);
|
||||
|
||||
// if you sent the message to another station, it will be sorted in to
|
||||
// the "to me message list" with modified messagetext, added rxers callsign
|
||||
@@ -1441,7 +1441,7 @@ public class MessageBusManagementThread extends Thread {
|
||||
newMessageArrived.getSender().setInAngleAndRange(false);
|
||||
}
|
||||
|
||||
this.client.getLst_globalChatMessageList().add(0, newMessageArrived);
|
||||
this.client.addChatMessage(newMessageArrived);
|
||||
// System.out.println("MSGBS bgfx: tx call = " + newMessageArrived.getSender().getCallSign() + " / rx call = " + newMessageArrived.getReceiver().getCallSign());
|
||||
}
|
||||
} catch (NullPointerException referenceDeletedByUserLeftChatDuringMessageprocessing) {
|
||||
@@ -1514,7 +1514,7 @@ public class MessageBusManagementThread extends Thread {
|
||||
|
||||
|
||||
for (int i = 0; i < 10; i++) {
|
||||
client.getLst_globalChatMessageList().add(pwErrorMsg);
|
||||
client.addChatMessage(pwErrorMsg);
|
||||
// client.getLst_toMeMessageList().add(pwErrorMsg);
|
||||
// client.getLst_toAllMessageList().add(pwErrorMsg);
|
||||
}
|
||||
|
||||
@@ -204,7 +204,26 @@ public class ReadUDPByWintestThread extends Thread {
|
||||
mode = "cw";
|
||||
}
|
||||
|
||||
String formattedQRG = String.format(Locale.US, "%.1f", freqFloat);
|
||||
// Format as MMM.KKK.HH display format (e.g. 144.300.00) consistent with UCX thread
|
||||
// freqFloat is in kHz (e.g. 144300.0), convert to Hz-string for formatting
|
||||
long freqHzTimes100 = Math.round(freqFloat * 100.0); // e.g. 14430000
|
||||
String hzStr = String.valueOf(freqHzTimes100);
|
||||
String formattedQRG;
|
||||
if (hzStr.length() == 8) {
|
||||
// 144MHz range: 14430000 -> 144.300.00
|
||||
formattedQRG = String.format("%s.%s.%s", hzStr.substring(0, 3), hzStr.substring(3, 6), hzStr.substring(6, 8));
|
||||
} else if (hzStr.length() == 9) {
|
||||
// 1296MHz range: 129600000 -> 1296.000.00
|
||||
formattedQRG = String.format("%s.%s.%s", hzStr.substring(0, 4), hzStr.substring(4, 7), hzStr.substring(7, 9));
|
||||
} else if (hzStr.length() == 7) {
|
||||
// 70MHz range: 7010000 -> 70.100.00
|
||||
formattedQRG = String.format("%s.%s.%s", hzStr.substring(0, 2), hzStr.substring(2, 5), hzStr.substring(5, 7));
|
||||
} else if (hzStr.length() == 6) {
|
||||
// 50MHz range: 5030000 but 6 digits: 503000 -> 5.030.00
|
||||
formattedQRG = String.format("%s.%s.%s", hzStr.substring(0, 1), hzStr.substring(1, 4), hzStr.substring(4, 6));
|
||||
} else {
|
||||
formattedQRG = String.format(Locale.US, "%.1f", freqFloat); // fallback
|
||||
}
|
||||
this.client.getChatPreferences().getMYQRGFirstCat().set(formattedQRG);
|
||||
|
||||
System.out.println("[WinTest STATUS] stn=" + stn + ", mode=" + mode + ", qrg=" + formattedQRG);
|
||||
|
||||
80
src/main/java/kst4contest/controller/WinTestMessage.java
Normal file
@@ -0,0 +1,80 @@
|
||||
package kst4contest.controller;
|
||||
|
||||
import java.nio.charset.StandardCharsets;
|
||||
|
||||
/**
|
||||
* Represents a Win-Test network protocol message.
|
||||
* <p>
|
||||
* Ported from the C# wtMessage class in wtKST.
|
||||
* <p>
|
||||
* Win-Test uses a simple ASCII-based UDP protocol with a checksum byte.
|
||||
* Message format (for sending):
|
||||
* <pre>
|
||||
* MESSAGETYPE: "src" "dst" data{checksum}\0
|
||||
* </pre>
|
||||
* The checksum is calculated over all bytes before the checksum position,
|
||||
* then OR'd with 0x80.
|
||||
*/
|
||||
public class WinTestMessage {
|
||||
|
||||
/** Win-Test message types relevant for SKED management. */
|
||||
public enum MessageType {
|
||||
LOCKSKED,
|
||||
UNLOCKSKED,
|
||||
ADDSKED,
|
||||
DELETESKED,
|
||||
UPDATESKED
|
||||
}
|
||||
|
||||
private final MessageType type;
|
||||
private final String src;
|
||||
private final String dst;
|
||||
private final String data;
|
||||
|
||||
public WinTestMessage(MessageType type, String src, String dst, String data) {
|
||||
this.type = type;
|
||||
this.src = src;
|
||||
this.dst = dst;
|
||||
this.data = data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Serializes this message to bytes for UDP transmission.
|
||||
* <p>
|
||||
* Format: {@code MESSAGETYPE: "src" "dst" data{checksum}\0}
|
||||
* <p>
|
||||
* The '?' placeholder is replaced by the calculated checksum,
|
||||
* followed by a NUL terminator.
|
||||
* Degree signs (°) are escaped as \260 per Win-Test convention.
|
||||
*/
|
||||
public byte[] toBytes() {
|
||||
String escapedData = data.replace("°", "\\260");
|
||||
|
||||
// Format: MESSAGETYPE: "src" "dst" data?\0
|
||||
// The '?' is a placeholder for the checksum byte
|
||||
String raw = type.name() + ": \"" + src + "\" \"" + dst + "\" " + escapedData + "?\0";
|
||||
|
||||
byte[] bytes = raw.getBytes(StandardCharsets.US_ASCII);
|
||||
|
||||
// Calculate checksum over everything before the checksum position (length - 2)
|
||||
int sum = 0;
|
||||
for (int i = 0; i < bytes.length - 2; i++) {
|
||||
sum += (bytes[i] & 0xFF);
|
||||
}
|
||||
byte checksum = (byte) ((sum | 0x80) & 0xFF);
|
||||
bytes[bytes.length - 2] = checksum;
|
||||
|
||||
return bytes;
|
||||
}
|
||||
|
||||
// Getters for debugging/logging
|
||||
public MessageType getType() { return type; }
|
||||
public String getSrc() { return src; }
|
||||
public String getDst() { return dst; }
|
||||
public String getData() { return data; }
|
||||
|
||||
@Override
|
||||
public String toString() {
|
||||
return type.name() + ": src=" + src + " dst=" + dst + " data=" + data;
|
||||
}
|
||||
}
|
||||
187
src/main/java/kst4contest/controller/WinTestSkedSender.java
Normal file
@@ -0,0 +1,187 @@
|
||||
package kst4contest.controller;
|
||||
|
||||
import kst4contest.model.Band;
|
||||
import kst4contest.model.ContestSked;
|
||||
import kst4contest.model.ThreadStateMessage;
|
||||
|
||||
import java.net.*;
|
||||
import java.nio.charset.StandardCharsets;
|
||||
|
||||
/**
|
||||
* Sends SKED entries to Win-Test via UDP broadcast.
|
||||
* <p>
|
||||
* Ported from the C# wtSked class in wtKST.
|
||||
* <p>
|
||||
* Win-Test expects a LOCKSKED / ADDSKED / UNLOCKSKED sequence
|
||||
* to safely insert a new sked into its schedule window.
|
||||
*/
|
||||
public class WinTestSkedSender {
|
||||
|
||||
private final String stationName;
|
||||
private final InetAddress broadcastAddress;
|
||||
private final int port;
|
||||
private final ThreadStatusCallback callback;
|
||||
|
||||
private static final String THREAD_NICKNAME = "WT-SkedSend";
|
||||
|
||||
/**
|
||||
* @param stationName our station name in the Win-Test network (e.g. "KST4Contest")
|
||||
* @param broadcastAddress UDP broadcast address (e.g. 255.255.255.255 or subnet broadcast)
|
||||
* @param port Win-Test network port (default 9871)
|
||||
* @param callback optional callback for status reporting (may be null)
|
||||
*/
|
||||
public WinTestSkedSender(String stationName, InetAddress broadcastAddress, int port,
|
||||
ThreadStatusCallback callback) {
|
||||
this.stationName = stationName;
|
||||
this.broadcastAddress = broadcastAddress;
|
||||
this.port = port;
|
||||
this.callback = callback;
|
||||
}
|
||||
|
||||
/**
|
||||
* Pushes a ContestSked into Win-Test by sending the LOCKSKED / ADDSKED / UNLOCKSKED
|
||||
* sequence via UDP broadcast.
|
||||
*
|
||||
* @param sked the sked to push
|
||||
* @param frequencyKHz current operating frequency in kHz (e.g. 144321.0)
|
||||
* @param notes free-text notes (e.g. "[JO62QM - 123°] sked via KST")
|
||||
*/
|
||||
public void pushSkedToWinTest(ContestSked sked, double frequencyKHz, String notes, int modeOverride) {
|
||||
try {
|
||||
sendLockSked();
|
||||
sendAddSked(sked, frequencyKHz, notes, modeOverride);
|
||||
sendUnlockSked();
|
||||
|
||||
reportStatus("Sked pushed to WT: " + sked.getTargetCallsign(), false);
|
||||
System.out.println("[WinTestSkedSender] Sked pushed: " + sked.getTargetCallsign()
|
||||
+ " at " + frequencyKHz + " kHz, band=" + sked.getBand());
|
||||
} catch (Exception e) {
|
||||
reportStatus("ERROR pushing sked: " + e.getMessage(), true);
|
||||
System.out.println("[WinTestSkedSender] Error pushing sked: " + e.getMessage());
|
||||
e.printStackTrace();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Sends a LOCKSKED message to lock the Win-Test sked window.
|
||||
*/
|
||||
private void sendLockSked() throws Exception {
|
||||
WinTestMessage msg = new WinTestMessage(
|
||||
WinTestMessage.MessageType.LOCKSKED,
|
||||
stationName, "",
|
||||
"\"" + stationName + "\"");
|
||||
sendUdp(msg);
|
||||
}
|
||||
|
||||
/**
|
||||
* Sends an UNLOCKSKED message to unlock the Win-Test sked window.
|
||||
*/
|
||||
private void sendUnlockSked() throws Exception {
|
||||
WinTestMessage msg = new WinTestMessage(
|
||||
WinTestMessage.MessageType.UNLOCKSKED,
|
||||
stationName, "",
|
||||
"\"" + stationName + "\"");
|
||||
sendUdp(msg);
|
||||
}
|
||||
|
||||
/**
|
||||
* Sends an ADDSKED message with the sked details.
|
||||
* <p>
|
||||
* Win-Test ADDSKED data format (from wtKST):
|
||||
* <pre>
|
||||
* {epoch_seconds} {freq_in_0.1kHz} {bandId} {mode} "{callsign}" "{notes}"
|
||||
* </pre>
|
||||
* <p>
|
||||
* Win-Test uses a timestamp reference of 1970-01-01 00:01:00 UTC (60s offset from Unix epoch).
|
||||
* The C# code adds 60 seconds to compensate.
|
||||
*/
|
||||
private void sendAddSked(ContestSked sked, double frequencyKHz, String notes, int modeOverride) throws Exception {
|
||||
// Win-Test timestamp: epoch seconds with 60s offset
|
||||
long epochSeconds = sked.getSkedTimeEpoch() / 1000;
|
||||
long wtTimestamp = epochSeconds + 60;
|
||||
|
||||
// Frequency in 0.1 kHz units (Win-Test convention): multiply kHz by 10
|
||||
long freqTenthKHz = Math.round(frequencyKHz * 10.0);
|
||||
|
||||
// Win-Test band ID
|
||||
int bandId = toWinTestBandId(sked.getBand());
|
||||
|
||||
// Mode: -1 = auto-detect from frequency, 0 = CW, 1 = SSB
|
||||
int mode;
|
||||
if (modeOverride >= 0) {
|
||||
mode = modeOverride;
|
||||
} else {
|
||||
mode = isInSsbSegment(frequencyKHz) ? 1 : 0;
|
||||
}
|
||||
|
||||
String data = wtTimestamp
|
||||
+ " " + freqTenthKHz
|
||||
+ " " + bandId
|
||||
+ " " + mode
|
||||
+ " \"" + sked.getTargetCallsign() + "\""
|
||||
+ " \"" + (notes != null ? notes : "") + "\"";
|
||||
|
||||
WinTestMessage msg = new WinTestMessage(
|
||||
WinTestMessage.MessageType.ADDSKED,
|
||||
stationName, "",
|
||||
data);
|
||||
sendUdp(msg);
|
||||
}
|
||||
|
||||
/**
|
||||
* Sends a WinTestMessage via UDP broadcast.
|
||||
*/
|
||||
private void sendUdp(WinTestMessage msg) throws Exception {
|
||||
try (DatagramSocket socket = new DatagramSocket()) {
|
||||
socket.setBroadcast(true);
|
||||
socket.setReuseAddress(true);
|
||||
|
||||
byte[] bytes = msg.toBytes();
|
||||
DatagramPacket packet = new DatagramPacket(bytes, bytes.length, broadcastAddress, port);
|
||||
socket.send(packet);
|
||||
|
||||
System.out.println("[WinTestSkedSender] sent: " + msg);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Maps the kst4contest Band enum to Win-Test band IDs.
|
||||
* <p>
|
||||
* Win-Test band IDs (reverse-engineered from wtKST):
|
||||
* 10=50MHz, 11=70MHz, 12=144MHz, 14=432MHz, 16=1.2GHz,
|
||||
* 17=2.3GHz, 18=3.4GHz, 19=5.7GHz, 20=10GHz, 21=24GHz,
|
||||
* 22=47GHz, 23=76GHz
|
||||
*/
|
||||
public static int toWinTestBandId(Band band) {
|
||||
if (band == null) return 12; // default to 144 MHz
|
||||
return switch (band) {
|
||||
case B_144 -> 12;
|
||||
case B_432 -> 14;
|
||||
case B_1296 -> 16;
|
||||
case B_2320 -> 17;
|
||||
case B_3400 -> 18;
|
||||
case B_5760 -> 19;
|
||||
case B_10G -> 20;
|
||||
case B_24G -> 21;
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Very simple SSB segment heuristic.
|
||||
* A more complete implementation would check actual mode from Win-Test STATUS.
|
||||
*/
|
||||
private boolean isInSsbSegment(double frequencyKHz) {
|
||||
// SSB segments (kHz ranges)
|
||||
if (frequencyKHz >= 144300 && frequencyKHz <= 144399) return true; // 2m SSB
|
||||
if (frequencyKHz >= 432200 && frequencyKHz <= 432399) return true; // 70cm SSB
|
||||
if (frequencyKHz >= 1296200 && frequencyKHz <= 1296399) return true; // 23cm SSB
|
||||
return false;
|
||||
}
|
||||
|
||||
private void reportStatus(String text, boolean isError) {
|
||||
if (callback != null) {
|
||||
callback.onThreadStatus(THREAD_NICKNAME,
|
||||
new ThreadStateMessage(THREAD_NICKNAME, !isError, text, isError));
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -201,6 +201,9 @@ public class ChatPreferences {
|
||||
int logsynch_wintestNetworkStationIDOfKST = 55555;
|
||||
int logsynch_wintestNetworkPort = 9871;
|
||||
boolean logsynch_wintestNetworkListenerEnabled = true; // default true = bisheriges Verhalten
|
||||
String logsynch_wintestNetworkBroadcastAddress = "255.255.255.255"; // UDP broadcast address for sending to Win-Test
|
||||
boolean logsynch_wintestNetworkSkedPushEnabled = false; // push SKEDs to Win-Test via UDP
|
||||
String logsynch_wintestSkedMode = "SSB"; // CW, SSB or AUTO
|
||||
|
||||
|
||||
|
||||
@@ -454,6 +457,30 @@ public class ChatPreferences {
|
||||
this.logsynch_wintestNetworkListenerEnabled = logsynch_wintestNetworkListenerEnabled;
|
||||
}
|
||||
|
||||
public String getLogsynch_wintestNetworkBroadcastAddress() {
|
||||
return logsynch_wintestNetworkBroadcastAddress;
|
||||
}
|
||||
|
||||
public void setLogsynch_wintestNetworkBroadcastAddress(String logsynch_wintestNetworkBroadcastAddress) {
|
||||
this.logsynch_wintestNetworkBroadcastAddress = logsynch_wintestNetworkBroadcastAddress;
|
||||
}
|
||||
|
||||
public boolean isLogsynch_wintestNetworkSkedPushEnabled() {
|
||||
return logsynch_wintestNetworkSkedPushEnabled;
|
||||
}
|
||||
|
||||
public void setLogsynch_wintestNetworkSkedPushEnabled(boolean logsynch_wintestNetworkSkedPushEnabled) {
|
||||
this.logsynch_wintestNetworkSkedPushEnabled = logsynch_wintestNetworkSkedPushEnabled;
|
||||
}
|
||||
|
||||
public String getLogsynch_wintestSkedMode() {
|
||||
return logsynch_wintestSkedMode;
|
||||
}
|
||||
|
||||
public void setLogsynch_wintestSkedMode(String logsynch_wintestSkedMode) {
|
||||
this.logsynch_wintestSkedMode = logsynch_wintestSkedMode;
|
||||
}
|
||||
|
||||
public String getStn_loginLocatorSecondCat() {
|
||||
return stn_loginLocatorSecondCat;
|
||||
}
|
||||
@@ -1299,6 +1326,18 @@ public class ChatPreferences {
|
||||
logsynch_wintestNetworkListenerEnabled.setTextContent(this.logsynch_wintestNetworkListenerEnabled + "");
|
||||
logsynch.appendChild(logsynch_wintestNetworkListenerEnabled);
|
||||
|
||||
Element logsynch_wintestNetworkBroadcastAddress = doc.createElement("logsynch_wintestNetworkBroadcastAddress");
|
||||
logsynch_wintestNetworkBroadcastAddress.setTextContent(this.logsynch_wintestNetworkBroadcastAddress);
|
||||
logsynch.appendChild(logsynch_wintestNetworkBroadcastAddress);
|
||||
|
||||
Element logsynch_wintestNetworkSkedPushEnabled = doc.createElement("logsynch_wintestNetworkSkedPushEnabled");
|
||||
logsynch_wintestNetworkSkedPushEnabled.setTextContent(this.logsynch_wintestNetworkSkedPushEnabled + "");
|
||||
logsynch.appendChild(logsynch_wintestNetworkSkedPushEnabled);
|
||||
|
||||
Element logsynch_wintestSkedMode = doc.createElement("logsynch_wintestSkedMode");
|
||||
logsynch_wintestSkedMode.setTextContent(this.logsynch_wintestSkedMode);
|
||||
logsynch.appendChild(logsynch_wintestSkedMode);
|
||||
|
||||
|
||||
/**
|
||||
* trxSynchUCX
|
||||
@@ -1858,6 +1897,20 @@ public class ChatPreferences {
|
||||
logsynch_wintestNetworkListenerEnabled,
|
||||
"logsynch_wintestNetworkListenerEnabled");
|
||||
|
||||
logsynch_wintestNetworkBroadcastAddress = getText(
|
||||
logsynchEl,
|
||||
logsynch_wintestNetworkBroadcastAddress,
|
||||
"logsynch_wintestNetworkBroadcastAddress");
|
||||
|
||||
logsynch_wintestNetworkSkedPushEnabled = getBoolean(
|
||||
logsynchEl,
|
||||
logsynch_wintestNetworkSkedPushEnabled,
|
||||
"logsynch_wintestNetworkSkedPushEnabled");
|
||||
|
||||
logsynch_wintestSkedMode = getText(
|
||||
logsynchEl,
|
||||
logsynch_wintestSkedMode,
|
||||
"logsynch_wintestSkedMode");
|
||||
|
||||
System.out.println(
|
||||
"[ChatPreferences, info]: file based worked-call interpreter: " + logsynch_fileBasedWkdCallInterpreterEnabled);
|
||||
|
||||
168
src/main/java/kst4contest/utils/BoundedDequeObservableList.java
Normal file
@@ -0,0 +1,168 @@
|
||||
package kst4contest.utils;
|
||||
|
||||
import javafx.collections.ObservableListBase;
|
||||
|
||||
import java.util.Arrays;
|
||||
|
||||
/**
|
||||
* A bounded ObservableList backed by a circular buffer (ring buffer).
|
||||
* <p>
|
||||
* Provides O(1) {@link #addFirst} and {@link #addLast} as well as O(1)
|
||||
* random access via {@link #get}. When the list reaches {@code maxCapacity},
|
||||
* adding a new element at the front automatically evicts the oldest element
|
||||
* at the back — and vice versa.
|
||||
* <p>
|
||||
* This is a drop-in replacement for {@code FXCollections.observableArrayList()}
|
||||
* wherever elements are prepended frequently, e.g. chat message lists.
|
||||
*/
|
||||
public class BoundedDequeObservableList<E> extends ObservableListBase<E> {
|
||||
|
||||
private final int maxCapacity;
|
||||
private final Object[] elements;
|
||||
private int head = 0;
|
||||
private int size = 0;
|
||||
|
||||
public BoundedDequeObservableList(int maxCapacity) {
|
||||
if (maxCapacity <= 0) throw new IllegalArgumentException("maxCapacity must be > 0");
|
||||
this.maxCapacity = maxCapacity;
|
||||
this.elements = new Object[maxCapacity];
|
||||
}
|
||||
|
||||
// ── read access ──────────────────────────────────────────────────────────
|
||||
|
||||
@Override
|
||||
public int size() {
|
||||
return size;
|
||||
}
|
||||
|
||||
@Override
|
||||
@SuppressWarnings("unchecked")
|
||||
public E get(int index) {
|
||||
checkIndex(index);
|
||||
return (E) elements[physicalIndex(index)];
|
||||
}
|
||||
|
||||
// ── O(1) deque operations ─────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Inserts {@code element} at index 0 (newest-first order).
|
||||
* If the list is already at capacity the oldest element (last index) is
|
||||
* removed first — both changes are reported as a single compound change.
|
||||
*/
|
||||
public void addFirst(E element) {
|
||||
beginChange();
|
||||
if (size == maxCapacity) {
|
||||
// evict last element
|
||||
int lastPhysical = physicalIndex(size - 1);
|
||||
@SuppressWarnings("unchecked")
|
||||
E evicted = (E) elements[lastPhysical];
|
||||
elements[lastPhysical] = null;
|
||||
size--;
|
||||
nextRemove(size, evicted); // index after decrement == old last index
|
||||
}
|
||||
head = (head - 1 + maxCapacity) % maxCapacity;
|
||||
elements[head] = element;
|
||||
size++;
|
||||
nextAdd(0, 1);
|
||||
endChange();
|
||||
}
|
||||
|
||||
/**
|
||||
* Appends {@code element} at the last index (oldest-first order).
|
||||
* If the list is already at capacity the newest element (index 0) is
|
||||
* removed first.
|
||||
*/
|
||||
public void addLast(E element) {
|
||||
beginChange();
|
||||
if (size == maxCapacity) {
|
||||
// evict first element
|
||||
@SuppressWarnings("unchecked")
|
||||
E evicted = (E) elements[head];
|
||||
elements[head] = null;
|
||||
head = (head + 1) % maxCapacity;
|
||||
size--;
|
||||
nextRemove(0, evicted);
|
||||
}
|
||||
elements[physicalIndex(size)] = element;
|
||||
size++;
|
||||
nextAdd(size - 1, size);
|
||||
endChange();
|
||||
}
|
||||
|
||||
// ── standard List mutation (O(n) — use addFirst/addLast for hot path) ─────
|
||||
|
||||
@Override
|
||||
public void add(int index, E element) {
|
||||
if (index == 0) {
|
||||
addFirst(element);
|
||||
return;
|
||||
}
|
||||
if (index == size) {
|
||||
addLast(element);
|
||||
return;
|
||||
}
|
||||
checkIndexForAdd(index);
|
||||
beginChange();
|
||||
if (size == maxCapacity) {
|
||||
int lastPhysical = physicalIndex(size - 1);
|
||||
@SuppressWarnings("unchecked")
|
||||
E evicted = (E) elements[lastPhysical];
|
||||
elements[lastPhysical] = null;
|
||||
size--;
|
||||
nextRemove(size, evicted);
|
||||
}
|
||||
// shift elements [index .. size-1] one position towards the end
|
||||
for (int i = size; i > index; i--) {
|
||||
elements[physicalIndex(i)] = elements[physicalIndex(i - 1)];
|
||||
}
|
||||
elements[physicalIndex(index)] = element;
|
||||
size++;
|
||||
nextAdd(index, index + 1);
|
||||
endChange();
|
||||
}
|
||||
|
||||
@Override
|
||||
public E remove(int index) {
|
||||
checkIndex(index);
|
||||
beginChange();
|
||||
@SuppressWarnings("unchecked")
|
||||
E removed = (E) elements[physicalIndex(index)];
|
||||
// shift elements [index+1 .. size-1] one position towards the front
|
||||
for (int i = index; i < size - 1; i++) {
|
||||
elements[physicalIndex(i)] = elements[physicalIndex(i + 1)];
|
||||
}
|
||||
elements[physicalIndex(size - 1)] = null;
|
||||
size--;
|
||||
nextRemove(index, removed);
|
||||
endChange();
|
||||
return removed;
|
||||
}
|
||||
|
||||
@Override
|
||||
public E set(int index, E element) {
|
||||
checkIndex(index);
|
||||
beginChange();
|
||||
@SuppressWarnings("unchecked")
|
||||
E old = (E) elements[physicalIndex(index)];
|
||||
elements[physicalIndex(index)] = element;
|
||||
nextSet(index, old);
|
||||
endChange();
|
||||
return old;
|
||||
}
|
||||
|
||||
// ── helpers ───────────────────────────────────────────────────────────────
|
||||
|
||||
private int physicalIndex(int virtualIndex) {
|
||||
return (head + virtualIndex) % maxCapacity;
|
||||
}
|
||||
|
||||
private void checkIndex(int index) {
|
||||
if (index < 0 || index >= size)
|
||||
throw new IndexOutOfBoundsException("Index: " + index + ", Size: " + size);
|
||||
}
|
||||
|
||||
private void checkIndexForAdd(int index) {
|
||||
if (index < 0 || index > size)
|
||||
throw new IndexOutOfBoundsException("Index: " + index + ", Size: " + size);
|
||||
}
|
||||
}
|
||||
@@ -391,6 +391,22 @@ public class Kst4ContestApplication extends Application implements StatusUpdateL
|
||||
ChoiceBox<Integer> cbSkedMinutes = new ChoiceBox<>(FXCollections.observableArrayList(2, 3, 4, 5, 6,7,8,9, 10,11,12,13,14, 15, 20));
|
||||
cbSkedMinutes.getSelectionModel().select(Integer.valueOf(5));
|
||||
|
||||
ChoiceBox<String> cbSkedMode = new ChoiceBox<>(FXCollections.observableArrayList("AUTO", "SSB", "CW"));
|
||||
String configuredSkedMode = this.chatcontroller.getChatPreferences().getLogsynch_wintestSkedMode();
|
||||
if (configuredSkedMode == null || configuredSkedMode.isBlank()) {
|
||||
configuredSkedMode = "AUTO";
|
||||
}
|
||||
String configuredSkedModeUpper = configuredSkedMode.trim().toUpperCase(java.util.Locale.ROOT);
|
||||
if (!"AUTO".equals(configuredSkedModeUpper)
|
||||
&& !"SSB".equals(configuredSkedModeUpper)
|
||||
&& !"CW".equals(configuredSkedModeUpper)) {
|
||||
configuredSkedModeUpper = "AUTO";
|
||||
}
|
||||
cbSkedMode.setValue(configuredSkedModeUpper);
|
||||
cbSkedMode.setTooltip(new Tooltip("Mode for Win-Test ADDSKED packets"));
|
||||
cbSkedMode.setOnAction(e ->
|
||||
chatcontroller.getChatPreferences().setLogsynch_wintestSkedMode(cbSkedMode.getValue()));
|
||||
|
||||
ChoiceBox<String> cbReminderOffsets = new ChoiceBox<>(FXCollections.observableArrayList("2+1", "5+2+1", "10+5+2+1"));
|
||||
cbReminderOffsets.getSelectionModel().select("2+1");
|
||||
|
||||
@@ -403,6 +419,10 @@ public class Kst4ContestApplication extends Application implements StatusUpdateL
|
||||
ChatMember sel = chatcontroller.getScoreService().selectedChatMemberProperty().get();
|
||||
if (sel == null) return;
|
||||
|
||||
if (cbSkedMode.getValue() != null) {
|
||||
chatcontroller.getChatPreferences().setLogsynch_wintestSkedMode(cbSkedMode.getValue());
|
||||
}
|
||||
|
||||
int minutes = cbSkedMinutes.getValue() == null ? 5 : cbSkedMinutes.getValue();
|
||||
long skedTime = System.currentTimeMillis() + minutes * 60_000L;
|
||||
|
||||
@@ -425,6 +445,8 @@ public class Kst4ContestApplication extends Application implements StatusUpdateL
|
||||
new Label("Sked in"),
|
||||
cbSkedMinutes,
|
||||
new Label("min"),
|
||||
new Label("Mode"),
|
||||
cbSkedMode,
|
||||
btnCreateSked,
|
||||
chkPmReminders,
|
||||
cbReminderOffsets
|
||||
@@ -5360,7 +5382,7 @@ public class Kst4ContestApplication extends Application implements StatusUpdateL
|
||||
FlowPane chatMemberTableFilterQRBHBox = new FlowPane();
|
||||
chatMemberTableFilterQRBHBox.setAlignment(Pos.CENTER_LEFT);
|
||||
chatMemberTableFilterQRBHBox.setHgap(2);
|
||||
chatMemberTableFilterQRBHBox.setPrefWidth(210);
|
||||
chatMemberTableFilterQRBHBox.setPrefWidth(225);
|
||||
|
||||
TextField chatMemberTableFilterMaxQrbTF = new TextField(chatcontroller.getChatPreferences().getStn_maxQRBDefault() + "");
|
||||
chatMemberTableFilterMaxQrbTF.setFocusTraversable(false);
|
||||
@@ -5409,7 +5431,7 @@ public class Kst4ContestApplication extends Application implements StatusUpdateL
|
||||
// HBox chatMemberTableFilterQTFHBox = new HBox();
|
||||
FlowPane chatMemberTableFilterQTFHBox = new FlowPane();
|
||||
chatMemberTableFilterQTFHBox.setAlignment(Pos.CENTER_LEFT);
|
||||
chatMemberTableFilterQTFHBox.setPrefWidth(490);
|
||||
chatMemberTableFilterQTFHBox.setPrefWidth(525);
|
||||
chatMemberTableFilterQTFHBox.setHgap(2);
|
||||
|
||||
CheckBox chatMemberTableFilterQtfEnableChkbx = new CheckBox("Show only QTF:");
|
||||
@@ -6190,7 +6212,7 @@ public class Kst4ContestApplication extends Application implements StatusUpdateL
|
||||
*
|
||||
****************************************************************************/
|
||||
settingsStage = new Stage();
|
||||
settingsStage.setTitle("Change Client seetings");
|
||||
settingsStage.setTitle("Change Client Settings");
|
||||
|
||||
BorderPane optionsPanel = new BorderPane();
|
||||
|
||||
@@ -6860,6 +6882,86 @@ public class Kst4ContestApplication extends Application implements StatusUpdateL
|
||||
grdPnlLog.add(lblUDPByWintest, 0, 8);
|
||||
grdPnlLog.add(txtFldUDPPortforWintest, 1, 8);
|
||||
|
||||
// --- Win-Test SKED push settings ---
|
||||
Label lblEnableSkedPush = new Label("Push SKEDs to Win-Test via UDP (ADDSKED)");
|
||||
CheckBox chkBxEnableSkedPush = new CheckBox();
|
||||
chkBxEnableSkedPush.setSelected(
|
||||
this.chatcontroller.getChatPreferences().isLogsynch_wintestNetworkSkedPushEnabled()
|
||||
);
|
||||
chkBxEnableSkedPush.selectedProperty().addListener((obs, oldVal, newVal) -> {
|
||||
chatcontroller.getChatPreferences().setLogsynch_wintestNetworkSkedPushEnabled(newVal);
|
||||
System.out.println("[Main.java, Info]: Win-Test SKED push enabled: " + newVal);
|
||||
});
|
||||
|
||||
Label lblWtStationName = new Label("KST station name in Win-Test network (src of SKED packets)");
|
||||
TextField txtFldWtStationName = new TextField(
|
||||
this.chatcontroller.getChatPreferences().getLogsynch_wintestNetworkStationNameOfKST()
|
||||
);
|
||||
txtFldWtStationName.setFocusTraversable(false);
|
||||
txtFldWtStationName.focusedProperty().addListener((obs, oldVal, newVal) -> {
|
||||
if (!newVal) { // focus lost
|
||||
chatcontroller.getChatPreferences()
|
||||
.setLogsynch_wintestNetworkStationNameOfKST(txtFldWtStationName.getText().trim());
|
||||
System.out.println("[Main.java, Info]: Win-Test KST station name set to: "
|
||||
+ txtFldWtStationName.getText().trim());
|
||||
}
|
||||
});
|
||||
|
||||
Label lblWtStationFilter = new Label("Win-Test station name filter (e.g. STN1, empty = accept all)");
|
||||
TextField txtFldWtStationFilter = new TextField(
|
||||
this.chatcontroller.getChatPreferences().getLogsynch_wintestNetworkStationNameOfWintestClient1()
|
||||
);
|
||||
txtFldWtStationFilter.setFocusTraversable(false);
|
||||
txtFldWtStationFilter.focusedProperty().addListener((obs, oldVal, newVal) -> {
|
||||
if (!newVal) {
|
||||
chatcontroller.getChatPreferences()
|
||||
.setLogsynch_wintestNetworkStationNameOfWintestClient1(txtFldWtStationFilter.getText().trim());
|
||||
System.out.println("[Main.java, Info]: Win-Test station filter set to: "
|
||||
+ txtFldWtStationFilter.getText().trim());
|
||||
}
|
||||
});
|
||||
|
||||
Label lblWtBroadcastAddr = new Label("UDP broadcast address for Win-Test (default = internet interface broadcast)");
|
||||
TextField txtFldWtBroadcastAddr = new TextField(
|
||||
this.chatcontroller.getChatPreferences().getLogsynch_wintestNetworkBroadcastAddress()
|
||||
);
|
||||
txtFldWtBroadcastAddr.setFocusTraversable(false);
|
||||
txtFldWtBroadcastAddr.focusedProperty().addListener((obs, oldVal, newVal) -> {
|
||||
if (!newVal) {
|
||||
chatcontroller.getChatPreferences()
|
||||
.setLogsynch_wintestNetworkBroadcastAddress(txtFldWtBroadcastAddr.getText().trim());
|
||||
System.out.println("[Main.java, Info]: Win-Test broadcast address set to: "
|
||||
+ txtFldWtBroadcastAddr.getText().trim());
|
||||
}
|
||||
});
|
||||
|
||||
grdPnlLog.add(lblEnableSkedPush, 0, 9);
|
||||
grdPnlLog.add(chkBxEnableSkedPush, 1, 9);
|
||||
|
||||
grdPnlLog.add(lblWtStationName, 0, 11);
|
||||
grdPnlLog.add(txtFldWtStationName, 1, 11);
|
||||
grdPnlLog.add(lblWtStationFilter, 0, 12);
|
||||
grdPnlLog.add(txtFldWtStationFilter, 1, 12);
|
||||
|
||||
// Auto-detect subnet broadcast if preference is still the default
|
||||
String currentBroadcast = this.chatcontroller.getChatPreferences().getLogsynch_wintestNetworkBroadcastAddress();
|
||||
if ("255.255.255.255".equals(currentBroadcast)) {
|
||||
try {
|
||||
String detected = detectPreferredWintestBroadcastAddress();
|
||||
if (detected != null && !detected.isBlank()) {
|
||||
this.chatcontroller.getChatPreferences().setLogsynch_wintestNetworkBroadcastAddress(detected);
|
||||
System.out.println("[Main.java, Info]: Auto-detected WT broadcast: " + detected);
|
||||
}
|
||||
} catch (Exception ex) {
|
||||
System.out.println("[Main.java, Warning]: Could not auto-detect broadcast: " + ex.getMessage());
|
||||
}
|
||||
}
|
||||
// Re-read (may have been auto-detected)
|
||||
txtFldWtBroadcastAddr.setText(this.chatcontroller.getChatPreferences().getLogsynch_wintestNetworkBroadcastAddress());
|
||||
|
||||
grdPnlLog.add(lblWtBroadcastAddr, 0, 13);
|
||||
grdPnlLog.add(txtFldWtBroadcastAddr, 1, 13);
|
||||
|
||||
VBox vbxLog = new VBox();
|
||||
vbxLog.setPadding(new Insets(10, 10, 10, 10));
|
||||
vbxLog.getChildren().addAll(grdPnlLog);
|
||||
@@ -8525,6 +8627,75 @@ public class Kst4ContestApplication extends Application implements StatusUpdateL
|
||||
}
|
||||
}
|
||||
|
||||
private String detectPreferredWintestBroadcastAddress() {
|
||||
String internetRouteBroadcast = detectInternetRouteBroadcastAddress();
|
||||
if (internetRouteBroadcast != null && !internetRouteBroadcast.isBlank()) {
|
||||
return internetRouteBroadcast;
|
||||
}
|
||||
return detectFirstUsableBroadcastAddress();
|
||||
}
|
||||
|
||||
private String detectInternetRouteBroadcastAddress() {
|
||||
java.net.DatagramSocket routeProbe = null;
|
||||
try {
|
||||
routeProbe = new java.net.DatagramSocket();
|
||||
routeProbe.connect(java.net.InetAddress.getByName("8.8.8.8"), 53);
|
||||
|
||||
java.net.InetAddress localAddress = routeProbe.getLocalAddress();
|
||||
if (localAddress == null || localAddress.isAnyLocalAddress() || localAddress.isLoopbackAddress()) {
|
||||
return null;
|
||||
}
|
||||
|
||||
java.net.NetworkInterface networkInterface = java.net.NetworkInterface.getByInetAddress(localAddress);
|
||||
if (networkInterface == null || !networkInterface.isUp()) {
|
||||
return null;
|
||||
}
|
||||
|
||||
for (java.net.InterfaceAddress interfaceAddress : networkInterface.getInterfaceAddresses()) {
|
||||
if (!(interfaceAddress.getAddress() instanceof java.net.Inet4Address)) {
|
||||
continue;
|
||||
}
|
||||
if (!localAddress.equals(interfaceAddress.getAddress())) {
|
||||
continue;
|
||||
}
|
||||
if (interfaceAddress.getBroadcast() != null) {
|
||||
return interfaceAddress.getBroadcast().getHostAddress();
|
||||
}
|
||||
}
|
||||
|
||||
for (java.net.InterfaceAddress interfaceAddress : networkInterface.getInterfaceAddresses()) {
|
||||
if (interfaceAddress.getBroadcast() != null && interfaceAddress.getAddress() instanceof java.net.Inet4Address) {
|
||||
return interfaceAddress.getBroadcast().getHostAddress();
|
||||
}
|
||||
}
|
||||
} catch (Exception ignored) {
|
||||
// Fallback to generic detection if internet-route probing fails
|
||||
} finally {
|
||||
if (routeProbe != null && !routeProbe.isClosed()) {
|
||||
routeProbe.close();
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
private String detectFirstUsableBroadcastAddress() {
|
||||
try {
|
||||
for (java.net.NetworkInterface networkInterface : java.util.Collections.list(java.net.NetworkInterface.getNetworkInterfaces())) {
|
||||
if (!networkInterface.isUp() || networkInterface.isLoopback() || networkInterface.isVirtual() || networkInterface.isPointToPoint()) {
|
||||
continue;
|
||||
}
|
||||
for (java.net.InterfaceAddress interfaceAddress : networkInterface.getInterfaceAddresses()) {
|
||||
if (interfaceAddress.getBroadcast() != null && interfaceAddress.getAddress() instanceof java.net.Inet4Address) {
|
||||
return interfaceAddress.getBroadcast().getHostAddress();
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch (Exception ignored) {
|
||||
// Keep configured value if no interface can be detected
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
module praktiKST {
|
||||
requires javafx.controls;
|
||||
requires javafx.fxml;
|
||||
requires javafx.web;
|
||||
requires jdk.xml.dom;
|
||||
requires java.sql;
|
||||
requires javafx.media;
|
||||
|
||||