mirror of
https://github.com/praktimarc/kst4contest.git
synced 2026-07-13 08:07:11 +02:00
221 lines
7.9 KiB
Markdown
221 lines
7.9 KiB
Markdown
# 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
|
||
|
||
Mehrere Paketformate stehen auf der Releases-Seite zur Verfügung:
|
||
|
||
**https://github.com/praktimarc/kst4contest/releases/latest**
|
||
|
||
| Format | Dateiname | Geeignet für |
|
||
|---|---|---|
|
||
| AppImage | `KST4Contest-v<Version>-linux-x86_64.AppImage` | Alle Distributionen |
|
||
| Debian-Paket | `KST4Contest-v<Version>-debian-amd64.deb` | Debian, Ubuntu, Linux Mint, … |
|
||
| RPM-Paket | `KST4Contest-v<Version>-fedora-x86_64.rpm` | Fedora, RHEL, openSUSE, … |
|
||
| Arch-Paket | `KST4Contest-v<Version>-archlinux-x86_64.pkg.tar.zst` | Arch Linux, Manjaro, … |
|
||
| Flatpak | `de.x08.KST4Contest.flatpakref` | Alle Distributionen mit Flatpak |
|
||
|
||
> **Empfehlung für Linux:** Die Flatpak-Installation ist der einfachste Weg, immer aktuell zu bleiben – `flatpak update` erledigt alle zukünftigen Updates automatisch. Das Repository ist GPG-signiert.
|
||
|
||
### macOS
|
||
|
||
> ⚠️ **Best-Effort-Support:** macOS-Builds werden als zusätzliche Option bereitgestellt, sind aber **nicht umfassend getestet**. Wir bauen und veröffentlichen macOS-Binaries mit jedem Release, können allerdings nicht alle Szenarien unter macOS testen. Bei Problemen freuen wir uns über eine Rückmeldung – wir versuchen unser Bestes, können aber nicht den gleichen Support-Umfang wie für Windows und Linux garantieren.
|
||
|
||
Die aktuelle Version kann als DMG-Disk-Image heruntergeladen werden (für Apple-Silicon- und Intel-Macs verfügbar):
|
||
|
||
**https://github.com/praktimarc/kst4contest/releases/latest**
|
||
|
||
Der Dateiname hat das Format `KST4Contest-v<Versionsnummer>-macos-<Architektur>.dmg`, wobei `<Architektur>` entweder `arm64` (Apple Silicon) oder `x86_64` (Intel) ist.
|
||
|
||
|
||
---
|
||
|
||
## 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
|
||
|
||
Die Einstellungen werden immer unter `~/.praktikst/preferences.xml` gespeichert.
|
||
|
||
#### AppImage
|
||
|
||
1. AppImage herunterladen.
|
||
2. Ausführbar machen: `chmod +x KST4Contest-v<Version>-linux-x86_64.AppImage`
|
||
3. Starten.
|
||
|
||
#### Debian / Ubuntu
|
||
|
||
```bash
|
||
sudo apt install ./KST4Contest-v<Version>-debian-amd64.deb
|
||
```
|
||
|
||
Oder die `.deb`-Datei im Dateimanager doppelklicken.
|
||
|
||
#### Fedora / RHEL
|
||
|
||
```bash
|
||
sudo dnf install ./KST4Contest-v<Version>-fedora-x86_64.rpm
|
||
```
|
||
|
||
#### Arch Linux
|
||
|
||
```bash
|
||
sudo pacman -U KST4Contest-v<Version>-archlinux-x86_64.pkg.tar.zst
|
||
```
|
||
|
||
#### Flatpak
|
||
|
||
Die Datei `de.x08.KST4Contest.flatpakref` aus dem [aktuellen Release](https://github.com/praktimarc/kst4contest/releases/latest) herunterladen und öffnen, oder:
|
||
```bash
|
||
flatpak install de.x08.KST4Contest.flatpakref
|
||
```
|
||
|
||
Oder den Remote manuell hinzufügen (empfohlen für Nightly/Beta-Zugriff):
|
||
```bash
|
||
flatpak remote-add --if-not-exists kst4contest https://praktimarc.github.io/kst4contest/kst4contest.flatpakrepo
|
||
flatpak install kst4contest de.x08.KST4Contest
|
||
```
|
||
|
||
#### Flatpak-Kanäle (nightly / beta / stable)
|
||
|
||
Das Flatpak-Repository enthält drei Kanäle, die alle im selben Remote liegen:
|
||
|
||
| Kanal | Inhalt | Wird gebaut bei |
|
||
|---|---|---|
|
||
| `stable` | Aktuelle stabile Version | Jedem normalen Release-Tag |
|
||
| `beta` | Vorab-Version | Tags mit `beta-` Präfix |
|
||
| `nightly` | Entwicklungsstand (main-Branch) | Täglich / jedem Push auf main |
|
||
|
||
Remote einmalig hinzufügen, dann den gewünschten Kanal installieren:
|
||
|
||
```bash
|
||
flatpak remote-add --if-not-exists kst4contest https://praktimarc.github.io/kst4contest/kst4contest.flatpakrepo
|
||
|
||
# Stable (Standard)
|
||
flatpak install kst4contest de.x08.KST4Contest
|
||
|
||
# Beta
|
||
flatpak install kst4contest de.x08.KST4Contest//beta
|
||
|
||
# Nightly
|
||
flatpak install kst4contest de.x08.KST4Contest//nightly
|
||
```
|
||
|
||
> **Hinweis:** Flatpak erlaubt nur eine installierte Version pro App-ID gleichzeitig. Um den Kanal zu wechseln, zuerst die aktuelle Version deinstallieren:
|
||
> ```bash
|
||
> flatpak uninstall de.x08.KST4Contest
|
||
> flatpak install kst4contest de.x08.KST4Contest//nightly
|
||
> ```
|
||
|
||
Updates erfolgen wie gewohnt mit `flatpak update`.
|
||
|
||
Die `flatpakref`-Dateien für Beta und Stable liegen jeweils im entsprechenden [GitHub-Release](https://github.com/praktimarc/kst4contest/releases). Das Nightly-`flatpakref` (`de.x08.KST4Contest.nightly.flatpakref`) ist als Artifact im [GitHub Actions](https://github.com/praktimarc/kst4contest/actions)-Tab verfügbar (wird 14 Tage aufbewahrt) – der Remote-Weg oben ist für Nightly daher meist einfacher.
|
||
|
||
### macOS
|
||
1. DMG-Datei für die eigene Architektur herunterladen (Apple Silicon oder Intel).
|
||
2. DMG-Datei öffnen.
|
||
3. `KST4Contest.app` in den **Programme**-Ordner ziehen.
|
||
4. Beim ersten Start zeigt macOS ggf. eine Warnung, da die App nicht notarisiert ist. Zum Öffnen:
|
||
- Rechtsklick (oder Ctrl-Klick) auf `KST4Contest.app` im Finder → **Öffnen** wählen.
|
||
- Alternativ: **Systemeinstellungen → Datenschutz & Sicherheit** → **Trotzdem öffnen** klicken.
|
||
5. KST4Contest aus dem Programme-Ordner oder dem Launchpad starten.
|
||
|
||
Die Einstellungen werden unter `~/.praktikst/preferences.xml` gespeichert.
|
||
|
||
---
|
||
|
||
## Update
|
||
|
||
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
|
||
|
||
- **AppImage**: Neues AppImage herunterladen, ausführbar machen (`chmod +x`), altes optional löschen.
|
||
- **Debian/Ubuntu**: `sudo apt install ./KST4Contest-v<Version>-debian-amd64.deb`
|
||
- **Fedora/RHEL**: `sudo dnf upgrade ./KST4Contest-v<Version>-fedora-x86_64.rpm`
|
||
- **Arch Linux**: `sudo pacman -U KST4Contest-v<Version>-archlinux-x86_64.pkg.tar.zst`
|
||
- **Flatpak (Repository)**: `flatpak update` – aktualisiert alle Flatpak-Apps einschließlich KST4Contest.
|
||
|
||
#### macOS
|
||
|
||
1. Neue DMG-Datei herunterladen.
|
||
2. DMG öffnen.
|
||
3. Die neue `KST4Contest.app` in den **Programme**-Ordner ziehen und die alte Version ersetzen.
|
||
|
||
|
||
---
|
||
|
||
## 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!)*
|