graph LR
WinBoat_Electron_Host_Main_Process_["WinBoat Electron Host (Main Process)"]
WinBoat_Electron_UI_Renderer_Process_["WinBoat Electron UI (Renderer Process)"]
WinBoat_Guest_Server_Go_["WinBoat Guest Server (Go)"]
Windows_Virtual_Machine_Guest_OS_["Windows Virtual Machine (Guest OS)"]
FreeRDP_Client["FreeRDP Client"]
Host_System_Utilities_Virtualization_Layer["Host System Utilities / Virtualization Layer"]
Unclassified["Unclassified"]
WinBoat_Electron_UI_Renderer_Process_ -- "communicates with" --> WinBoat_Electron_Host_Main_Process_
WinBoat_Electron_Host_Main_Process_ -- "communicates with" --> WinBoat_Electron_UI_Renderer_Process_
WinBoat_Electron_UI_Renderer_Process_ -- "controls" --> Windows_Virtual_Machine_Guest_OS_
WinBoat_Electron_Host_Main_Process_ -- "orchestrates" --> Host_System_Utilities_Virtualization_Layer
WinBoat_Electron_Host_Main_Process_ -- "controls" --> WinBoat_Guest_Server_Go_
WinBoat_Guest_Server_Go_ -- "reports to" --> WinBoat_Electron_Host_Main_Process_
FreeRDP_Client -- "connects to" --> Windows_Virtual_Machine_Guest_OS_
WinBoat_Guest_Server_Go_ -- "runs within" --> Windows_Virtual_Machine_Guest_OS_
The WinBoat application is an Electron-based desktop application designed to manage and interact with a Windows Virtual Machine (VM) running on a Linux host. The main Electron process (WinBoat Electron Host) handles application lifecycle, system-level interactions, and orchestrates virtualization components. A separate Electron renderer process (WinBoat Electron UI) provides the user interface, displaying the VM's output and handling user input. A WinBoat Guest Server (Go) runs within the Windows VM for communication and command execution. The FreeRDP Client streams the VM's graphical output to the UI, and Host System Utilities / Virtualization Layer provides the underlying VM management infrastructure. Data flows via IPC between Electron Host and UI, and via network protocols (QMP, RDP, custom API) between Electron Host/UI and the VM/Guest Server.
The central control plane of the WinBoat application. Manages the Electron lifecycle, orchestrates virtualization and containerization, handles Inter-Process Communication (IPC), and communicates with host system utilities. It acts as the primary coordinator for starting, stopping, and managing the virtual machine and its associated services.
Related Classes/Methods:
The user-facing interface, built with Vue.js. Renders the UI, processes user input, displays the virtualized environment's status, and integrates the remote display stream. It directly interacts with the QEMU Monitor Protocol (QMP) for VM control and communicates with the main process for system-level operations.
Related Classes/Methods:
A lightweight server running within the Windows Virtual Machine. It executes commands received from the Electron Host, manages guest resources, and reports status and data back to the host. This server enables fine-grained control and monitoring of the guest operating system.
Related Classes/Methods:
The isolated virtualized environment running a Windows operating system. It hosts the WinBoat Guest Server and user applications, and provides the remote display output that is streamed back to the Electron UI. This component is an external entity controlled by the application.
Related Classes/Methods: None
Establishes an RDP connection to the Windows VM, capturing and streaming its graphical output to the Electron UI for display. This component is crucial for providing the interactive visual experience of the virtual machine to the user.
Related Classes/Methods:
The underlying Linux host components responsible for virtualization (KVM), containerization (Docker), and network configuration (iptables/nftables). These utilities are orchestrated by the Electron Host to provide the necessary environment for the Windows Virtual Machine.
Related Classes/Methods:
Component for all unclassified files and utility functions (Utility functions/External Libraries/Dependencies)
Related Classes/Methods: None