x3/remmina-mac
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 12 Wiki Activity

Full interactive terminal via SwiftTerm, About sheet, English docs

Browse Source
This commit is contained in:
x3
2026-09-22 10:19:25 +02:00
parent d0855ab45d
commit c657ec2825
15 changed files with 584 additions and 650 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/INSTALL.md
+30 -21
View File
@@ -1,51 +1,60 @@
# Installation
## Voraussetzungen
## Requirements
- macOS 14+
- Xcode 15+ (für GUI-Run) oder nur Swift-Toolchain 5.9+ (für CLI-Build)
- Xcode 15+ (for GUI runs) or Swift toolchain 5.9+ (for CLI builds)
## Variante A: Xcode (empfohlen für GUI)
## Option A: Xcode (recommended for 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:
2. Select target `RemminaMac`, destination `My Mac`
3. `Cmd+R` → app launches
4. First launch creates:
- `~/Library/Application Support/RemminaMac/profiles.json`
- `~/Library/Application Support/RemminaMac/sshkeys.json`
## Variante B: Swift CLI
## Option B: Swift CLI
```bash
cd RemminaMac
swift build
.build/debug/RemminaMac
```
## Variante C: Release-Binary (ohne Xcode)
## Option C: Release binary (no Xcode)
```bash
./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).
## Option D: Installer DMG (recommended for end users)
1. Download `RemminaMac-<version>-macos-arm64.dmg` from a Gitea release
(or build locally: `./scripts/build-app.sh <version> && ./scripts/build-dmg.sh <version>`)
2. Double-click the DMG → Finder window with `RemminaMac.app` + `Applications` link
3. Drag `RemminaMac.app` onto `Applications` → `/Applications/RemminaMac.app`
4. Eject, launch from Applications. First launch: right-click → Open
(ad-hoc signature, no Apple notarization).
```bash
# Prüfen:
# Verify:
spctl -a -vv dist/RemminaMac.app
hdiutil verify dist/RemminaMac-0.1.0-macos-arm64.dmg
hdiutil verify dist/RemminaMac-*-macos-arm64.dmg
```
## RDP-Voraussetzungen
## RDP requirements
```bash
# Für volle RDP-Unterstützung:
# For full RDP support:
brew install freerdp
which xfreerdp
# Ohne FreeRDP: Microsoft Remote Desktop aus dem App Store installieren
# Without FreeRDP: install Microsoft Remote Desktop from the App Store
```
## SSH auto-login (optional)
```bash
brew install sshpass
# Enables password auto-login from Keychain (no typing).
# Without sshpass: the password prompt appears inside the terminal tab.
```
## 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
- `swift build` fails → check `swift --version` (>= 5.9), Xcode Command Line Tools: `xcode-select --install`
- Keychain prompt → allow once, service `RemminaMac`
- `xfreerdp` not found → fallback uses `rdc://`, needs MS Remote Desktop