About this project

OPAL is a remote desktop solution designed for high performance across Linux, Apple Silicon macOS, and Windows platforms. It operates as both a client and a host, requiring Tailscale to be installed on both ends to establish authenticated, end-to-end encrypted direct sessions over the tailnet. Key features include: - **Cross-Platform Support**: Native builds for Linux (Fedora, Arch, Debian/Ubuntu), macOS (Apple Silicon), and Windows (10+). - **Tailscale Integration**: Uses Tailscale's mesh network for secure, low-latency connections without port forwarding or public IP requirements. - **Virtual Monitor Support**: - On Linux (KDE Plasma Wayland), it creates virtual outputs at runtime using KWin/Wayland protocols. - On macOS, it utilizes CGVirtualDisplay APIs. - On Windows, it employs an Indirect Display Driver (IDD) built with the Windows Driver Kit (WDK). Note that Windows hosting requires test-signed drivers or a production-signed driver for public distribution. - **Native Input Handling**: Supports system audio recording and accessibility permissions for precise input mapping. - **CLI-First Design**: Managed via command-line tools (`opal`, `opal select`, `opal doctor`) with debug modes for troubleshooting. Installation involves building from source using standard tools (make, gcc/clang) and platform-specific dependencies like SDL3, FFmpeg, and PipeWire. The software emphasizes direct peer-to-peer connectivity, leveraging Tailscale's identity and networking stack for secure remote access.