<p>Es wird eine Mindestauflösung von 1200px mal 720px empfohlen</p>
<p>KST4Contest wird für Windows, Linux und macOS als fertiges Programmpaket bereitgestellt. Für die offiziellen Release-Pakete muss Java nicht separat installiert werden: Die benötigte Java-Laufzeitumgebung ist bereits enthalten.</p>
<p>🇬🇧 <ahref="/manual/en/installation/">English version</a> | 🇩🇪 Du liest gerade die deutsche Version</p>
</blockquote>
<p>KST4Contest wird für Windows, Linux und macOS als fertiges Programmpaket bereitgestellt. Für die offiziellen Release-Pakete muss Java nicht separat installiert werden: Die benötigte Java-Laufzeitumgebung ist bereits enthalten.</p>
<p>Benötigt werden damit im Wesentlichen ein unterstütztes Betriebssystem, eine Internetverbindung und ein ON4KST-Account. Das klingt zunächst überschaubar – und ist es normalerweise auch.</p>
<li><ahref="https://www.on4kst.org/chat/login.php">ON4KST-Anmeldung und Registrierung</a></li>
</ul>
<h3id="verhaltensregeln-im-chat"tabindex="-1"><aclass="header-anchor"href="#verhaltensregeln-im-chat">Verhaltensregeln im Chat</a></h3>
<p>Die offizielle Sprache im ON4KST-Chat ist <strong>Englisch</strong>. 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.</p>
<p>Um eine Privatnachricht an eine andere Station zu senden, immer folgendes Format verwenden:</p>
<pre><code>/CQ RUFZEICHEN Nachrichtentext
</code></pre>
<p>Beispiel: <code>/CQ DL5ASG pse sked 144.205?</code></p>
<p>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 <ahref="Funktionen#catching-personal-messages">Funktionen – PM-Abfang</a>).</p>
<p>ON4KST gibt Englisch als gemeinsame Sprache im Chat vor. Das gilt auch dann, wenn beide beteiligten Stationen dieselbe Muttersprache sprechen. Im Contestbetrieb werden häufig die üblichen Amateurfunk-Abkürzungen wie <code>pse</code>, <code>agn</code>, <code>qrg</code>, <code>dir</code>, <code>rrr</code>, <code>tnx</code> oder <code>73</code> verwendet.</p>
<p>Die eigentliche Bedienung des Chats und das Senden persönlicher Nachrichten werden im Kapitel zur Benutzeroberfläche beschrieben. Für die Installation ist zunächst nur wichtig, dass der Account funktioniert.</p>
<p>Eine nutzbare Bildschirmfläche von ungefähr <strong>1200 × 720 Pixeln</strong> oder mehr wird empfohlen.</p>
<p>KST4Contest passt das Hauptfenster automatisch an die verfügbare Fläche des primären Bildschirms an. Das Programm kann deshalb auch auf kleineren Bildschirmen gestartet werden. Weniger Platz bleibt allerdings weniger Platz: In diesem Fall können nicht alle Tabellen, Filter und Zusatzinformationen gleichzeitig in sinnvoller Größe dargestellt werden.</p>
<p>Für die fertigen Pakete aus den <ahref="https://github.com/praktimarc/kst4contest/releases/latest">GitHub Releases</a> ist keine separate Java-Installation erforderlich. Die benötigte Laufzeitumgebung wird zusammen mit KST4Contest ausgeliefert.</p>
<p>Eine Java-Entwicklungsumgebung wird nur benötigt, wenn KST4Contest selbst aus dem Quellcode gebaut werden soll. Bei den AUR-Paketen <code>kst4contest</code> und <code>kst4contest-git</code> werden Java 21 und Maven als Build-Abhängigkeiten durch den Paketmanager berücksichtigt.</p>
<p><strong>Empfehlung für Linux:</strong> Die Flatpak-Installation ist der einfachste Weg, immer aktuell zu bleiben –<code>flatpak update</code> erledigt alle zukünftigen Updates automatisch. Das Repository ist GPG-signiert.</p>
<p>⚠️ <strong>Best-Effort-Support:</strong> macOS-Builds werden als zusätzliche Option bereitgestellt, sind aber <strong>nicht umfassend getestet</strong>. Wir bauen und veröffentlichen macOS-Binaries mit jedem Release, können allerdings nicht alle Szenarien unter macOS testen. Bei Problemen freuen wir uns über eine Rückmeldung – wir versuchen unser Bestes, können aber nicht den gleichen Support-Umfang wie für Windows und Linux garantieren.</p>
</blockquote>
<p>Die aktuelle Version kann als DMG-Disk-Image heruntergeladen werden (für Apple-Silicon- und Intel-Macs verfügbar):</p>
<p>Der Dateiname hat das Format <code>KST4Contest-v<Versionsnummer>-macos-<Architektur>.dmg</code>, wobei <code><Architektur></code> entweder <code>arm64</code> (Apple Silicon) oder <code>x86_64</code> (Intel) ist.</p>
yay -S kst4contest-git # immer aktueller git-Stand (1.42+)
</code></pre>
<p>Jeder AUR-Helper funktioniert (<code>paru</code>, <code>trizen</code> usw.). <code>kst4contest-bin</code> ist die einfachste Option — es installiert dasselbe vorgefertigte Binary wie der Release-Download.</p>
<p>Oder das Release-Paket manuell installieren:</p>
<p>Die Datei <code>de.x08.KST4Contest.flatpakref</code> aus dem <ahref="https://github.com/praktimarc/kst4contest/releases/latest">aktuellen Release</a> herunterladen und öffnen, oder:</p>
<p>Für den normalen Einsatz wird die <strong>Stable-Version</strong> empfohlen.</p>
<p>Beta- und Nightly-Versionen können Funktionen enthalten, die im Stable-Release noch nicht verfügbar sind. Sie können aber ebenso unfertige Bedienabläufe, geänderte Einstellungen oder neue Fehler enthalten. Das ist kein ungewöhnlicher Defektim Veröffentlichungsverfahren, sondern der Zweck eines Entwicklungskanals.</p>
<p>Wenn in diesem Manual eine Funktion ausdrücklich mit <strong>Nightly</strong> gekennzeichnet ist, gehört sie noch nicht zwingend zum aktuellen Stable-Release.</p>
<p>Die Release-Seite enthält die Programmpakete sowie die deutschen und englischen PDF-Handbücher.</p>
<h3id="welches-paket-wird-ben%C3%B6tigt%3F"tabindex="-1"><aclass="header-anchor"href="#welches-paket-wird-ben%C3%B6tigt%3F">Welches Paket wird benötigt?</a></h3>
<p>Lade Programmpakete nur aus den offiziellen GitHub Releases, dem KST4Contest-Flatpak-Repository oder den verlinkten AUR-Paketen herunter. Dateien aus anderen Quellen können anders gebaut, veraltet oder verändert worden sein.</p>
<hr>
<h2id="installation-unter-windows"tabindex="-1"><aclass="header-anchor"href="#installation-unter-windows">Installation unter Windows</a></h2>
<p>KST4Contest wird unter Windows als ZIP-Paket bereitgestellt. Ein klassischer Installer ist nicht erforderlich.</p>
<ol>
<li>Lade <code>praktiKST-v<Version>-windows-x64.zip</code> aus dem aktuellen Release herunter.</li>
<li>Entpacke die ZIP-Datei vollständig in einen eigenen Ordner.</li>
<li>Öffne den entpackten Ordner.</li>
<li>Starte <code>praktiKST.exe</code>.</li>
</ol>
<p>Starte das Programm nicht direkt aus der noch komprimierten ZIP-Datei. KST4Contest besteht aus mehreren Dateien und einer mitgelieferten Laufzeitumgebung. Windows kann diese Struktur nur zuverlässig verwenden, wenn das Archiv vorher vollständig entpackt wurde.</p>
<p>Die Programmeinstellungen befinden sich nicht im entpackten Programmordner, sondern im Benutzerverzeichnis:</p>
<p>Dadurch können neue Programmversionen in einen anderen Ordner entpackt werden, ohne dass die vorhandenen Einstellungen verloren gehen.</p>
<hr>
<h2id="installation-unter-linux"tabindex="-1"><aclass="header-anchor"href="#installation-unter-linux">Installation unter Linux</a></h2>
<p>Unter Linux stehen mehrere Paketformate zur Verfügung. Welches davon sinnvoll ist, hängt weniger von KST4Contest als von der verwendeten Distribution und der gewünschten Update-Methode ab.</p>
<table>
<thead>
<tr>
<th>Installationsart</th>
<th>Sinnvoll, wenn …</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Flatpak</strong></td>
<td>Updates zentral verwaltet werden sollen und Flatpak bereits verwendet wird</td>
</tr>
<tr>
<td><strong>AppImage</strong></td>
<td>KST4Contest ohne Installation als einzelne portable Datei gestartet werden soll</td>
</tr>
<tr>
<td><strong>DEB/RPM</strong></td>
<td>die Paketverwaltung der Distribution verwendet werden soll</td>
</tr>
<tr>
<td><strong>Arch-Paket/AUR</strong></td>
<td>Arch Linux, Manjaro oder EndeavourOS eingesetzt wird</td>
<p>Flatpak ist für die meisten Linux-Anwender der einfachste Weg, KST4Contest installiert und aktualisierbar zu halten. Das KST4Contest-Repository ist GPG-signiert und enthält die Kanäle Stable, Beta und Nightly.</p>
<h4id="stable-%C3%BCber-die-release-datei-installieren"tabindex="-1"><aclass="header-anchor"href="#stable-%C3%BCber-die-release-datei-installieren">Stable über die Release-Datei installieren</a></h4>
<p>Lade <code>de.x08.KST4Contest.flatpakref</code> aus dem aktuellen Release herunter und öffne die Datei mit der Softwareverwaltung der verwendeten Desktop-Umgebung.</p>
<p>Alternativ kann sie im Terminal installiert werden:</p>
<p>KST4Contest verwendet für alle drei Kanäle dieselbe App-ID. Eine parallele Installation mehrerer KST4Contest-Kanäle ist deshalb nicht vorgesehen.</p>
<p>Zum Wechsel von Stable auf Nightly beispielsweise:</p>
<p>Je nach Desktop-Umgebung kann die grafische Softwareverwaltung verfügbare Flatpak-Updates ebenfalls anzeigen oder automatisch installieren. Der Befehl <code>flatpak update</code> selbst führt das Update aus; er verspricht nicht, irgendwann von allein vorbeizukommen.</p>
<p>Alternativ kann die Datei in einer grafischen Paketverwaltung geöffnet werden.</p>
<h3id="fedora-und-kompatible-rpm-systeme"tabindex="-1"><aclass="header-anchor"href="#fedora-und-kompatible-rpm-systeme">Fedora und kompatible RPM-Systeme</a></h3>
<h3id="arch-linux%3A-installation-%C3%BCber-den-aur"tabindex="-1"><aclass="header-anchor"href="#arch-linux%3A-installation-%C3%BCber-den-aur">Arch Linux: Installation über den AUR</a></h3>
<p>Die drei Pakete stellen dieselbe Anwendung bereit und sind deshalb als gegenseitige Konflikte definiert. Installiere nur eine Variante gleichzeitig.</p>
<p>AUR-Updates werden berücksichtigt, wenn der verwendete AUR-Helper nach Paketaktualisierungen sucht, beispielsweise mit:</p>
<pre><codeclass="language-bash">yay -Syu
</code></pre>
<p>Sie erfolgen nicht allein deshalb automatisch, weil das Paket aus dem AUR stammt.</p>
<hr>
<h2id="installation-unter-macos"tabindex="-1"><aclass="header-anchor"href="#installation-unter-macos">Installation unter macOS</a></h2>
<blockquote>
<p><strong>Hinweis:</strong> Flatpak erlaubt nur eine installierte Version pro App-ID gleichzeitig. Um den Kanal zu wechseln, zuerst die aktuelle Version deinstallieren:</p>
<p><strong>Best-Effort-Support:</strong> Die macOS-Pakete werden zusammen mit den übrigen Releases gebaut, aber nicht in demselben Umfang getestet wie die Windows- und Linux-Versionen. Rückmeldungen sind willkommen; eine vollständig geprüfte Unterstützung aller macOS-Versionen und Hardwarevarianten kann derzeit jedoch nicht zugesagt werden.</p>
</blockquote>
<p>Updates erfolgen wie gewohnt mit <code>flatpak update</code>.</p>
<p>Die <code>flatpakref</code>-Dateien für Beta und Stable liegen jeweils im entsprechenden <ahref="https://github.com/praktimarc/kst4contest/releases">GitHub-Release</a>. Das Nightly-<code>flatpakref</code> (<code>de.x08.KST4Contest.nightly.flatpakref</code>) ist als Artifact im <ahref="https://github.com/praktimarc/kst4contest/actions">GitHub Actions</a>-Tab verfügbar (wird 14 Tage aufbewahrt) – der Remote-Weg oben ist für Nightly daher meist einfacher.</p>
<p>Für Apple-Silicon-Macs wird das Paket mit <code>arm64</code> benötigt. Für Intel-Macs ist das Paket mit <code>x86_64</code> vorgesehen.</p>
<ol>
<li>DMG-Datei für die eigene Architektur herunterladen (Apple Silicon oder Intel).</li>
<li>DMG-Datei öffnen.</li>
<li><code>KST4Contest.app</code> in den <strong>Programme</strong>-Ordner ziehen.</li>
<li>Beim ersten Start zeigt macOS ggf. eine Warnung, da die App nicht notarisiert ist. Zum Öffnen:
<ul>
<li>Rechtsklick (oder Ctrl-Klick) auf <code>KST4Contest.app</code> im Finder → <strong>Öffnen</strong> wählen.</li>
<li>Alternativ: <strong>Systemeinstellungen → Datenschutz & Sicherheit</strong> → <strong>Trotzdem öffnen</strong> klicken.</li>
</ul>
</li>
<li>KST4Contest aus dem Programme-Ordner oder dem Launchpad starten.</li>
<li>Lade die passende DMG-Datei herunter.</li>
<li>Öffne die DMG-Datei.</li>
<li>Ziehe <code>KST4Contest.app</code> in den Ordner <strong>Programme</strong>.</li>
<li>Starte KST4Contest aus dem Programme-Ordner oder über das Launchpad.</li>
</ol>
<p>Die Einstellungen werden unter <code>~/.praktikst/preferences.xml</code> gespeichert.</p>
<p>Die Anwendung ist derzeit nicht von Apple notarisiert. macOS kann den ersten Start deshalb blockieren.</p>
<p>Falls die Anwendung aus dem offiziellen GitHub Release stammt:</p>
<ol>
<li>Öffne den Programme-Ordner im Finder.</li>
<li>Klicke mit der rechten Maustaste oder mit gedrückter Ctrl-Taste auf <code>KST4Contest.app</code>.</li>
<li>Wähle <strong>Öffnen</strong>.</li>
<li>Bestätige den Start im angezeigten Dialog.</li>
</ol>
<p>Alternativ kann macOS unter <strong>Systemeinstellungen → Datenschutz & Sicherheit</strong> die Schaltfläche <strong>Trotzdem öffnen</strong> anbieten.</p>
<p>KST4Contest enthält einen <strong>automatischen Update-Hinweis-Dienst</strong>: Sobald eine neue Version verfügbar ist, erscheint beim Start ein Fenster mit:</p>
<ul>
<li>der Information, dass eine neue Version vorliegt,</li>
<li>Die neue <code>KST4Contest.app</code> in den <strong>Programme</strong>-Ordner ziehen und die alte Version ersetzen.</li>
</ol>
<h2id="wo-werden-die-einstellungen-gespeichert%3F"tabindex="-1"><aclass="header-anchor"href="#wo-werden-die-einstellungen-gespeichert%3F">Wo werden die Einstellungen gespeichert?</a></h2>
<p>KST4Contest speichert seine Einstellungen und weitere lokale Arbeitsdateien im Benutzerverzeichnis. Der Programmordner und das Datenverzeichnis sind voneinander getrennt.</p>
<p>Beachte die Schreibweise <code>.praktiKST</code> mit großem <code>KST</code>. Unter Linux und macOS wird zwischen Groß- und Kleinschreibung unterschieden. <code>.praktikst</code> wäre dort schlicht ein anderes Verzeichnis.</p>
<p>Ein Programmupdate entfernt dieses Verzeichnis nicht. Trotzdem ist es sinnvoll, vor größeren Versionswechseln oder umfangreichen Änderungen an der Konfiguration eine Sicherung davon anzulegen.</p>
<hr>
<h2id="bekannte-probleme-beim-start"tabindex="-1"><aclass="header-anchor"href="#bekannte-probleme-beim-start">Bekannte Probleme beim Start</a></h2>
<p>KST4Contest prüft beim Start, ob ein neueres Stable-Release verfügbar ist. Wenn eine neuere Version gefunden wird, erscheint ein Informationsfenster mit:</p>
<li>einem Link zur passenden GitHub-Release-Seite.</li>
</ul>
<p><imgsrc="update_window.png"alt="Update-Hinweis von KST4Contest"></p>
<p>Der Update-Checker installiert nichts selbst. Er informiert über die neue Version und öffnet die plattformneutrale Release-Seite. Dort muss das passende Paket für Windows, Linux oder macOS ausgewählt werden.</p>
<li>Entferne das bisherige AppImage erst, wenn die neue Version funktioniert.</li>
</ol>
<h3id="debian-und-ubuntu-aktualisieren"tabindex="-1"><aclass="header-anchor"href="#debian-und-ubuntu-aktualisieren">Debian und Ubuntu aktualisieren</a></h3>
<li>Lade die neue DMG-Datei für die vorhandene Architektur herunter.</li>
<li>Beende KST4Contest.</li>
<li>Öffne die DMG-Datei.</li>
<li>Ersetze <code>KST4Contest.app</code> im Programme-Ordner.</li>
<li>Starte die neue Version und prüfe die vorhandenen Einstellungen.</li>
</ol>
<p>Die Konfiguration unter <code>~/.praktiKST</code> bleibt davon unberührt.</p>
<hr>
<h2id="probleme-beim-ersten-start"tabindex="-1"><aclass="header-anchor"href="#probleme-beim-ersten-start">Probleme beim ersten Start</a></h2>
<h3id="windows-meldet-eine-unbekannte-anwendung"tabindex="-1"><aclass="header-anchor"href="#windows-meldet-eine-unbekannte-anwendung">Windows meldet eine unbekannte Anwendung</a></h3>
<p>KST4Contest ist derzeit nicht mit einem kommerziellen Windows-Code-Signing-Zertifikat signiert. Windows oder ein zusätzlich installiertes Sicherheitsprodukt kann deshalb vor einer unbekannten oder selten heruntergeladenen Anwendung warnen.</p>
<p>Prüfe in diesem Fall zuerst:</p>
<ul>
<li>Stammt die Datei aus dem <ahref="https://github.com/praktimarc/kst4contest/releases/latest">offiziellen KST4Contest-Release</a>?</li>
<li>Passt der Dateiname zum veröffentlichten Release?</li>
<li>Wurde die Datei vollständig heruntergeladen?</li>
<li>Nennt das Sicherheitsprogramm einen konkreten Erkennungsnamen oder nur eine allgemeine Reputationswarnung?</li>
</ul>
<p>Ein Warnhinweis ist allein weder ein sicherer Beweis für Schadsoftware noch automatisch ein Fehlalarm. Wenn die Herkunft der Datei unklar ist, sollte sie nicht gestartet oder aus der Quarantäne wiederhergestellt werden.</p>
<p>Einige Anwender haben insbesondere Quarantäne-Meldungen von Norton 360 gemeldet. Wenn sich eine Meldung reproduzieren lässt, erstelle bitte einen <ahref="https://github.com/praktimarc/kst4contest/issues">GitHub-Issue</a> und nenne:</p>
<ul>
<li>die KST4Contest-Version,</li>
<li>den vollständigen Dateinamen,</li>
<li>das verwendete Sicherheitsprodukt und dessen Version,</li>
<li>den angezeigten Erkennungsnamen,</li>
<li>möglichst einen Screenshot der Meldung.</li>
</ul>
<h3id="das-appimage-startet-nicht"tabindex="-1"><aclass="header-anchor"href="#das-appimage-startet-nicht">Das AppImage startet nicht</a></h3>
<p>Starte die Datei anschließend aus einem Terminal. Fehlermeldungen sind dort meist aussagekräftiger als ein Doppelklick, der lediglich nichts Sichtbares tut.</p>
<h3id="macos-blockiert-die-anwendung"tabindex="-1"><aclass="header-anchor"href="#macos-blockiert-die-anwendung">macOS blockiert die Anwendung</a></h3>
<p>Verwende die unter <ahref="#installation-unter-macos">Installation unter macOS</a> beschriebene Funktion <strong>Öffnen</strong> im Kontextmenü. Prüfe vorher, ob die DMG-Datei aus dem offiziellen GitHub Release stammt.</p>
<h3id="das-problem-bleibt-bestehen"tabindex="-1"><aclass="header-anchor"href="#das-problem-bleibt-bestehen">Das Problem bleibt bestehen</a></h3>
<p>Prüfe zunächst, ob das Problem bereits unter <ahref="https://github.com/praktimarc/kst4contest/issues">GitHub Issues</a> beschrieben wurde. Falls nicht, erstelle einen neuen Issue mit:</p>
<ul>
<li>Betriebssystem und Version,</li>
<li>verwendeter KST4Contest-Version,</li>
<li>Installationsart,</li>
<li>genauer Fehlermeldung,</li>
<li>den Schritten, mit denen sich das Problem reproduzieren lässt.</li>
</ul>
<p>„Geht nicht“ beschreibt den Zustand meistens korrekt, hilft bei der Fehlersuche aber nur begrenzt.</p>
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
github-actions[bot]