Kuonen.Remote für macOS
=======================

Installieren
------------
Desktop-App:   "Kuonen.Remote.app" in den Ordner "Programme" ziehen und starten.
Befehlszeile:  "kremote" nach ~/.local/bin kopieren und diesen Ordner in den Pfad aufnehmen:
                   mkdir -p ~/.local/bin && cp kremote ~/.local/bin/ && chmod +x ~/.local/bin/kremote
                   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc


Meldung "kann nicht geöffnet werden, da der Entwickler nicht überprüft werden kann"
-----------------------------------------------------------------------------------
macOS versieht heruntergeladene Dateien mit einer Quarantäne-Markierung. Weil Kuonen.Remote nicht über
Apple beglaubigt (notarisiert) ist, verweigert Gatekeeper beim ersten Start das Öffnen. Das ist kein
Hinweis auf Schadsoftware.

So wird die Meldung entfernt (eine Möglichkeit genügt):

1. Im Terminal die Markierung entfernen (am zuverlässigsten):
       xattr -dr com.apple.quarantine /Applications/Kuonen.Remote.app
       xattr -d com.apple.quarantine ~/.local/bin/kremote
   (Liegt die App woanders, den Pfad anpassen: "Kuonen.Remote.app" ins Terminal-Fenster ziehen
   fügt ihn ein.)

2. Über die Systemeinstellungen:
   Die App einmal starten (die Meldung mit "Fertig" schliessen), dann
   Systemeinstellungen -> Datenschutz & Sicherheit -> ganz unten bei "Kuonen.Remote" auf
   "Dennoch öffnen" klicken und bestätigen.

3. Bis macOS 14: Rechtsklick (bzw. ctrl-Klick) auf die App -> "Öffnen" -> im Dialog "Öffnen".
   Ab macOS 15 bietet dieser Dialog das nicht mehr an; dann Weg 1 oder 2 nehmen.

Danach startet die App ohne Rückfrage. Zusätzlich entfernt in der App das Menü "Werkzeuge" ->
"Gatekeeper-Warnung beim Start abschalten" die Markierung von allen Dateien der App.

Anleitung im Netz: https://remote.kuonen.org/installation.html


Kuonen.Remote for macOS (English)
=================================

Install: drag "Kuonen.Remote.app" into "Applications". Command line: copy "kremote" to ~/.local/bin.

Message "cannot be opened because the developer cannot be verified": macOS quarantines downloaded files,
and Kuonen.Remote is not notarized by Apple, so Gatekeeper refuses the first start. Do one of the following:

1. Terminal (most reliable):
       xattr -dr com.apple.quarantine /Applications/Kuonen.Remote.app
       xattr -d com.apple.quarantine ~/.local/bin/kremote
2. Start the app once, close the message, then System Settings -> Privacy & Security -> "Open Anyway".
3. Up to macOS 14: right-click the app -> "Open" -> "Open". macOS 15 and later no longer offer this.
Afterwards, "Tools" -> "Turn off the Gatekeeper start warning" in the app removes the mark from all its files.
