# Installation

## Requirements
- macOS 14+
- Xcode 15+ (for GUI runs) or Swift toolchain 5.9+ (for CLI builds)

## Option A: Xcode (recommended for GUI)
1. `open Package.swift` in `RemminaMac/`
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`

## Option B: Swift CLI
```bash
cd RemminaMac
swift build
.build/debug/RemminaMac
```

## Option C: Release binary (no Xcode)
```bash
./scripts/build-release.sh
unzip dist/RemminaMac-*-macos-arm64.zip -d /tmp/rmm
/tmp/rmm/RemminaMac
```

## 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
# Verify:
spctl -a -vv dist/RemminaMac.app
hdiutil verify dist/RemminaMac-*-macos-arm64.dmg
```

## RDP requirements
```bash
# For full RDP support:
brew install freerdp
which xfreerdp
# 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` 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