remmina-mac/docs/INSTALL.md

Installation

Voraussetzungen

• macOS 14+
• Xcode 15+ (für GUI-Run) oder nur Swift-Toolchain 5.9+ (für CLI-Build)

Variante A: Xcode (empfohlen für GUI)

1. open Package.swift in RemminaMac/
2. Target RemminaMac wählen, Destination My Mac
3. Cmd+R → App startet
4. Erster Start legt an:
   • ~/Library/Application Support/RemminaMac/profiles.json
   • ~/Library/Application Support/RemminaMac/sshkeys.json

Variante B: Swift CLI

cd RemminaMac
swift build
.build/debug/RemminaMac

Variante C: Release-Binary (ohne Xcode)

./scripts/build-release.sh
unzip dist/RemminaMac-*-macos-arm64.zip -d /tmp/rmm
/tmp/rmm/RemminaMac

Variante D: Installer-DMG (Empfohlen für Endnutzer)

1. RemminaMac-0.1.0-macos-arm64.dmg aus dem Gitea-Release laden (oder lokal: ./scripts/build-app.sh 0.1.0 && ./scripts/build-dmg.sh 0.1.0)
2. DMG doppelklicken → Finder-Fenster mit RemminaMac.app + Programme-Link
3. RemminaMac.app auf Programme ziehen → liegt in /Applications/RemminaMac.app
4. Auswerfen, aus Programme starten. Beim ersten Start: Rechtsklick → Öffnen (ad-hoc-Signatur, kein Apple-Notarization).

# Prüfen:
spctl -a -vv dist/RemminaMac.app
hdiutil verify dist/RemminaMac-0.1.0-macos-arm64.dmg

RDP-Voraussetzungen

# Für volle RDP-Unterstützung:
brew install freerdp
which xfreerdp
# Ohne FreeRDP: Microsoft Remote Desktop aus dem App Store installieren

Troubleshooting

• swift build schlägt fehl → swift --version prüfen (>= 5.9), Xcode Command Line Tools: xcode-select --install
• Keychain-Prompt → einmal erlauben, Service RemminaMac
• xfreerdp nicht gefunden → Fallback nutzt rdc://, braucht MS Remote Desktop