remmina-mac/docs/USAGE.md

Benutzung

Layout (wie Remmina)

• Links: Gruppen-Dropdown, Suche, Profil-Liste. Rechtsklick: Verbinden / Duplizieren / Bearbeiten / Löschen. Doppelklick verbindet.
• Rechts: Tabs aller offenen Sitzungen + Verbindungsdetails (kopierbarer Befehl) + Hinweis-Box.
• Unten: Statusbar mit Profil-/Sitzungs-Zähler.
• Toolbar: + Neu, Stift Bearbeiten, Kopie-Symbol Duplizieren, Schlüssel Keys, ▶ Verbinden, ⚡ Quick-Connect.

Profil anlegen

1. + → Name, Gruppe, Protokoll (SSH/SFTP/RDP/VNC), Host, Port, Benutzername, Passwort direkt darunter ausfüllen (Keychain-Haken setzen zum Speichern).
2. Der Editor warnt live bei typischen Fehlern: user@host im Host-Feld, ssh://-Präfix, Leerzeichen, leerer Benutzername, ungültiger Port. Beim Speichern wird getrimmt.
3. SSH-Key wählen (optional, Bereich darunter — vorher unter Schlüssel-Icon importieren).
4. Speichern → liegt sofort in profiles.json.
5. Schlägt eine Verbindung fehl: rotes Banner → Bericht kopieren und zur Fehlersuche mitschicken (enthält kein Passwort).

Verbinden

• Profil wählen → ▶ Verbinden oder Doppelklick.
• SSH/SFTP: In-App-Terminal (Dracula-Theme) direkt im Tab — erst TCP-Vorab-Check (falscher Port/Host → sofort klare Meldung statt kryptischem Exit-Code), dann Auto-Connect. Eingabezeile unten (Auge-Icon = Passwort-Modus), ^C/^D-Buttons, Leeren, Trennen/Verbinden, Tab schließen. Bei Fehlschlag: rotes Banner mit letzter Meldung + Diagnose-Button.
• Alternativ: In Terminal.app öffnen (öffnet eine .command-Datei, braucht keine Automation-Berechtigung) oder Befehl kopieren.
• RDP: startet xfreerdp (falls vorhanden) oder öffnet MS Remote Desktop.
• VNC: öffnet vnc://host:port.

SSH-Keys verwalten (Schlüssel-Icon)

• Import aus ~/.ssh: übernimmt alle privaten Keys (ohne *.pub, known_hosts, config).
• Wählen…: Picker für Key-Datei.
• Neuen Key generieren: ruft /usr/bin/ssh-keygen -t ed25519 -f ~/.ssh/remminamac_<timestamp> auf.
• Passphrase → Keychain (sshkey-<UUID>).

Passwort speichern & Auto-Login

• Im Profil-Editor: Passwort eingeben + „in Keychain speichern“. Gespeichertes Passwort wird angezeigt (✓) und kann gelöscht werden. In profiles.json steht nur die Referenz, nie das Passwort.
• Reihenfolge beim Verbinden: Profil-Passwort zuerst, sonst Key-Passphrase.
• Auto-Login ohne Tippen: braucht sshpass (brew install sshpass). Dann loggt ssh via Keychain-Secret ein (Passwort nur im Prozess-Env SSHPASS, nie in Befehlszeile/Logs). Status zeigt „Auto-Login via Keychain".
• Ohne sshpass: Passwort/Key-Passphrase wird interaktiv im Terminal abgefragt (Passwort-Modus: Auge-Icon).

Quick-Connect

• Mit Auswahl: verbindet direkt. Ohne Auswahl: öffnet Editor mit „Quick-Connect“-Vorlage.

Export / Import (manuell, bis GUI-Buttons kommen)

PROFILE_DIR=~/Library/Application\ Support/RemminaMac
cp "$PROFILE_DIR/profiles.json" ~/Desktop/remminamac-backup.json
# Import:
cp ~/Desktop/remminamac-backup.json "$PROFILE_DIR/profiles.json"