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, User ausfüllen.
2. SSH-Key wählen (vorher unter Schlüssel-Icon importieren).
3. Optional Passwort → Haken „in Keychain speichern“.
4. Speichern → liegt sofort in profiles.json.

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>).

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"