Advanced Usage

Beyond standard remote desktop viewing, Chicken Fork provides modern macOS integration features designed for power users and system administrators.

Dynamic Desktop Resizing

Chicken Fork supports dynamic remote resolution resizing across both VNC and RDP sessions:

Clipboard Sharing & UTF-8 Extended Clipboard

Legacy VNC clients were notoriously restricted to Latin-1 ASCII text. Chicken Fork modernizes clipboard exchange with full UTF-8 Extended Clipboard support:

Fullscreen Spaces & Space Management

Chicken Fork integrates with native macOS Spaces Full Screen mode:

Touch Bar Integration MacBook Pro

On MacBook Pro models equipped with a Touch Bar, Chicken Fork surfaces handy interactive controls:

Apple Remote Desktop (ARD) Authentication

When connecting to modern macOS machines running Screen Sharing or Remote Management, Apple defaults to a proprietary Diffie-Hellman Key Exchange (DHX) and AES encryption scheme requiring a Mac system account.

Chicken Fork integrates native support for Apple Remote Desktop authentication (powered by CryptoSwift). Enter your macOS system username and password into Chicken Fork's connection dialog to authenticate directly — no need to downgrade to legacy VNC password authentication in macOS Sharing settings!

Unified Network Discovery (Bonjour & Windows RDP)

Clicking the Scan button in the Connection Dialog sidebar discovers both Macs/Linux machines advertising via Bonjour (_rfb._tcp and _vnc._tcp) and Windows machines running Remote Desktop (port 3389) on your local private IPv4 LAN subnets. No network discovery runs automatically on launch.

For Windows hosts, Chicken Fork performs a polite, rate-limited active sweep on TCP port 3389 (X.224 Connection Request/Confirm, zero authentication) and resolves Windows hostnames concurrently via mDNS, reverse DNS, NetBIOS (UDP 137), LLMNR (UDP 5355), MSRPC Endpoint Mapper (TCP 135), and the RDP TLS certificate Common Name.

Security Note: No Active VNC Scanning

Chicken Fork explicitly refuses to actively scan or discover VNC servers (ports 5900–5909) during LAN sweeps. Standard VNC is unencrypted and insecure by default and should not be exposed or encouraged via active network discovery. Only encrypted RDP endpoints (3389) are actively probed; Macs continue to appear passively via Bonjour.

Listening (Reverse) Connections

When a remote server is located behind a strict NAT router or firewall where inbound ports cannot be opened, you can use Chicken Fork in Listening Mode:

  1. Choose File → Listen for Server... from the menu bar.
  2. Chicken Fork listens on local port 5500 for incoming connections.
  3. Instruct the remote VNC server to initiate a reverse connection to your IP address on port 5500. Chicken Fork will accept the connection and launch the session window.

Command-Line Reference

Chicken Fork can be invoked directly from the macOS Terminal, scripts, or automations:

# Executable path
cd "/Applications/Chicken Fork.app/Contents/MacOS"
./"Chicken Fork" [options] [server-address]
Argument Description
--RDP Forces connection protocol to Microsoft Remote Desktop (defaults to port 3389).
--VNC Forces connection protocol to VNC / RFB (defaults to port 5900).
--Username <user> Specifies the login username for RDP or Apple ARD VNC sessions.
--Display <num> Specifies the VNC display number (e.g. --Display 1 connects to port 5901).
--Profile <name> Applies a specific named connection profile (e.g. --Profile Windows).
--Shared Requests a shared VNC session, allowing other clients to remain connected.
--ViewOnly Launches session in view-only non-interactive mode.
--Fullscreen Opens the session directly into fullscreen mode.
--UseAllScreens Opens an RDP session in fullscreen across all connected displays.
--UseRetina Enables native Retina pixel resolution and HiDPI scaling for an RDP session.
--Listen Starts Chicken Fork directly in VNC reverse listening mode on port 5500.
rdp://... Direct URL connection: rdp://admin@192.168.1.50:3389
vnc://... Direct URL connection: vnc://user@192.168.1.10:5900