From 3957bdcf68ddf70bbbb9b595c5dc042c59a30dc4 Mon Sep 17 00:00:00 2001
From: x3 <x3@sysdaemon.xyz>
Date: Tue, 22 Sep 2026 10:26:47 +0200
Subject: [PATCH] Docs: Homebrew dependency table (sshpass, freerdp, builtins)

---
 docs/INSTALL.md | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/docs/INSTALL.md b/docs/INSTALL.md
index 31b8d46..6a5d65a 100644
--- a/docs/INSTALL.md
+++ b/docs/INSTALL.md
@@ -4,6 +4,25 @@
 - macOS 14+
 - Xcode 15+ (for GUI runs) or Swift toolchain 5.9+ (for CLI builds)
 
+## Dependencies (via Homebrew)
+One command covers everything optional:
+
+```bash
+brew install sshpass freerdp
+```
+
+| Tool | Purpose | Required? | Install |
+|------|---------|-----------|---------|
+| Xcode Command Line Tools | building (`swift build`, C helper) | build only | `xcode-select --install` |
+| `sshpass` | password auto-login from Keychain (no typing) | optional | `brew install sshpass` |
+| `xfreerdp` (FreeRDP) | native RDP sessions | optional | `brew install freerdp` |
+| `ssh`, `sftp`, `ssh-keyscan`, `ssh-keygen` | SSH core, host-key fingerprints | built into macOS | — |
+| SwiftTerm | terminal emulator | bundled via SPM | — |
+| Microsoft Remote Desktop | RDP fallback without FreeRDP | optional | App Store |
+
+Without `sshpass`: passwords are asked interactively in the terminal tab.
+Without FreeRDP: RDP profiles open Microsoft Remote Desktop instead.
+
 ## Option A: Xcode (recommended for GUI)
 1. `open Package.swift` in `RemminaMac/`
 2. Select target `RemminaMac`, destination `My Mac`
@@ -41,7 +60,7 @@ hdiutil verify dist/RemminaMac-*-macos-arm64.dmg
 
 ## RDP requirements
 ```bash
-# For full RDP support:
+# For full RDP support (see dependency table above):
 brew install freerdp
 which xfreerdp
 # Without FreeRDP: install Microsoft Remote Desktop from the App Store
@@ -52,6 +71,7 @@ which xfreerdp
 brew install sshpass
 # Enables password auto-login from Keychain (no typing).
 # Without sshpass: the password prompt appears inside the terminal tab.
+# Full list: dependencies table in [docs/INSTALL.md](docs/INSTALL.md#dependencies-via-homebrew).
 ```
 
 ## Troubleshooting