Installation

Kuonen.Remote besteht aus zwei nativen Programmen: der Desktop-App und der Befehlszeile kremote. Beide brauchen keine .NET-Laufzeit und keine weiteren Pakete. Die Archive stehen auf der Seite Download, je für Windows, macOS und Linux, für x64 und ARM64.

Voraussetzungen

• Windows 11 (x64 oder ARM64).
• macOS 13 Ventura oder neuer (Apple Silicon oder Intel).
• Linux mit Wayland oder X11 (x64 oder ARM64). Für gespeicherte Kennwörter einen Secret Service, etwa den GNOME-Schlüsselbund oder KWallet.

Jedes Archiv enthält eine LIESMICH.txt für sein System: wie man startet und wie man die Warnung beim ersten Start loswird.

Vor dem Auspacken die Prüfsumme vergleichen – sie steht neben jeder Datei:

shasum -a 256 -c Kuonen.Remote-<Fassung>-osx-arm64.zip.sha256

Unter Windows zeigt Get-FileHash .\Kuonen.Remote-<Fassung>-win-x64.zip -Algorithm SHA256 den Wert zum Vergleichen.

Windows

1. Kuonen.Remote-<Fassung>-win-x64.zip auspacken, etwa nach %LOCALAPPDATA%\Programs\Kuonen.Remote.
2. Kuonen.Remote.App.exe starten; für den schnellen Zugriff eine Verknüpfung ins Startmenü legen.
3. Für die Befehlszeile kremote-<Fassung>-win-x64.zip in einen eigenen Ordner auspacken und diesen Ordner in den Pfad aufnehmen (Einstellungen › System › Info › Erweiterte Systemeinstellungen › Umgebungsvariablen).

Windows-Warnung „Der Computer wurde durch Windows geschützt“

Windows versieht heruntergeladene Dateien mit einer Markierung (*Mark of the Web*). Beim ersten Start meldet SmartScreen deshalb ein unbekanntes Programm mit „Unbekannter Herausgeber“. Die Programme sind signiert, aber mit einem selbst ausgestellten Zertifikat – das kennt Windows auf fremden Geräten nicht, und SmartScreen traut neuen Programmen ohnehin erst nach einer gewissen Verbreitung. Das ist kein Fehler und kein Hinweis auf Schadsoftware; die Prüfsumme neben dem Download belegt, dass die Datei unverändert ist.

So startest du die App trotzdem:

• Am saubersten – vor dem Auspacken: Rechtsklick auf das heruntergeladene ZIP → Eigenschaften → unten Zulassen ankreuzen → OK. Danach auspacken; die Warnung kommt gar nicht erst.
• Schon ausgepackt: Im Programmordner liegt Zulassen.ps1 bei. Rechtsklick → Mit PowerShell ausführen entfernt die Markierung von allen Dateien im Ordner. (Ohne Skript: Rechtsklick auf Kuonen.Remote.App.exe → Eigenschaften → Zulassen.)
• Aus der App heraus: im SmartScreen-Fenster einmal Weitere Informationen → Trotzdem ausführen, dann in der App Werkzeuge › Windows-Warnung beim Start abschalten. Danach startet sie ohne Warnung.

macOS

1. Kuonen.Remote-<Fassung>-osx-arm64.zip (Apple Silicon) bzw. -osx-x64.zip (Intel) auspacken; darin liegen Kuonen.Remote.app und LIESMICH.txt.
2. Kuonen.Remote.app in den Ordner Programme ziehen und starten.
3. Für die Befehlszeile:

mkdir -p ~/.local/bin
unzip kremote-<Fassung>-osx-arm64.zip -d ~/.local/bin
chmod +x ~/.local/bin/kremote
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

macOS-Meldung „Entwickler kann nicht überprüft werden“

macOS versieht heruntergeladene Dateien mit einer Quarantäne-Markierung; weil Kuonen.Remote nicht über Apple beglaubigt (notarisiert) ist, verweigert Gatekeeper den ersten Start. Eine der folgenden Möglichkeiten genügt:

• Terminal (am zuverlässigsten):

xattr -dr com.apple.quarantine /Applications/Kuonen.Remote.app
xattr -d com.apple.quarantine ~/.local/bin/kremote

• Systemeinstellungen: die App einmal starten, die Meldung schliessen, dann Systemeinstellungen › Datenschutz & Sicherheit › Dennoch öffnen.
• Bis macOS 14: Rechtsklick auf die App › Öffnen › Öffnen. Ab macOS 15 bietet der Dialog das nicht mehr an.

Läuft die App einmal, entfernt Werkzeuge › Gatekeeper-Warnung beim Start abschalten die Markierung von allen ihren Dateien.

Linux

mkdir -p ~/.local/share/kuonen-remote ~/.local/bin
tar -xzf Kuonen.Remote-<Fassung>-linux-x64.tar.gz -C ~/.local/share/kuonen-remote
tar -xzf kremote-<Fassung>-linux-x64.tar.gz -C ~/.local/bin
~/.local/share/kuonen-remote/Kuonen.Remote.App

~/.local/bin steht bei den meisten Verteilungen schon im Pfad; sonst export PATH="$HOME/.local/bin:$PATH" in ~/.bashrc eintragen.

Die App wählt die Anzeige selbst: Wayland, sonst X11. Mit KUONEN_UI_BACKEND=x11 oder KUONEN_UI_BACKEND=wayland lässt sie sich festlegen.

Eine Warnung beim Start gibt es unter Linux nicht, und es gibt nichts zu entsperren. Startet ein einzeln kopiertes Programm nicht („Permission denied“), fehlt nur das Ausführrecht: chmod +x Kuonen.Remote.App kremote.

Prüfen

kremote --version
kremote ssh -h

Aktualisieren und entfernen

Zum Aktualisieren das neue Archiv über das alte auspacken. Sitzungen, Kennwörter und bekannte Hosts liegen nicht im Programmordner, sondern im Konfigurationsordner bzw. in ~/.ssh (siehe Daten und Ablage); sie bleiben erhalten.

Zum Entfernen den Programmordner löschen und – wer alles loswerden will – den Konfigurationsordner Kuonen.Remote.

Aus dem Quelltext

Wer Zugang zum Quelltext hat, baut die Archive selbst; .NET 10 SDK genügt. Gebaut wird je auf dem eigenen System:

bash Remote/dist/veroeffentlichen.sh

Die Archive liegen danach unter Remote/artefakte/<plattform>/.