How brepublic/hypervstatustray works
HyperVStatusTray is a Windows system-tray monitor and controller for up to two Hyper-V VMs or WSL distributions. The user configures targets, then the tray polls and combines broker observations with user-session WSL observations, tracks status, and displays it in the tray. Hyper-V queries and power operations run through a secured Windows-service broker; WSL actions remain in the user session. The README documents the major menu, startup-policy, language, and SSH capabilities. Some subsystem links are based on README statements or the source index because their implementation was not excerpted.
Main entry points: TrayApplicationContext.cs Tray UI and menu · PipeBrokerServer.cs Pipe broker server · BrokerEngine.cs Broker command engine · ConfigService.cs Configuration service
Components 28
Tray application
- Tray UI and menu
src/UI/TrayApplicationContext.cs - VM state tracker
src/State/VmStateTracker.cs - Status icon factory
src/UI/IconFactory.cs - Startup policy dialog
src/UI/VmStartupPolicyDialog.cs - Broker client
src/Services/BrokerClient.cs - WSL client
src/Services/WslClient.cs - Session startup
src/Services/StartupManager.cs - Tray entry point
src/Program.cs
Hyper-V broker
- Windows service host
broker/WindowsServiceHost.cs - Pipe broker server
broker/PipeBrokerServer.cs - Broker command engine
broker/BrokerEngine.cs - Hyper-V operations
broker/Services/HyperVClient.cs - Broker entry point
broker/Program.cs
Shared services and models
- Configuration service
shared/Services/ConfigService.cs - Target configuration
shared/Models/AppConfig.cs - Pipe message protocol
shared/Protocol/BrokerProtocol.cs - Broker messages
shared/Protocol/BrokerMessages.cs - Application paths
shared/Services/AppPaths.cs - Broker security options
shared/Services/BrokerSecurityOptions.cs - Logging
shared/Services/Logger.cs - Localization
shared/Localization/AppText.cs - VM startup policy
shared/Models/VmStartupPolicy.cs - SSH shell configuration
shared/Models/SshShellConfig.cs
External systems
- Hyper-V management
- WSL distributions
- VM console
- SSH executable
Other components
- Windows user
Connections 33
- Windows user → Tray UI and menu: uses
README.md - Tray entry point → Tray UI and menu: starts
src/Program.cs - Tray UI and menu → VM state tracker: updates
src/UI/TrayApplicationContext.cs - Tray UI and menu → Status icon factory: renders with
src/UI/TrayApplicationContext.cs - Tray UI and menu → Broker client: requests status and actions
src/UI/TrayApplicationContext.cs - Tray UI and menu → WSL client: requests WSL operations
src/UI/TrayApplicationContext.cs - Tray UI and menu → Startup policy dialog: opens
src/UI/TrayApplicationContext.cs - Tray UI and menu → Session startup: uses
src/UI/TrayApplicationContext.cs - Tray UI and menu → Configuration service: loads configuration
src/UI/TrayApplicationContext.cs - Tray UI and menu → VM console: launches console
README.md - Tray UI and menu → SSH executable: launches configured shell
README.md - Tray UI and menu → SSH shell configuration: reads SSH settings
src/UI/TrayApplicationContext.cs - WSL client → WSL distributions: queries and controls
README.md - Broker client → Pipe message protocol: exchanges messages
src/Services/BrokerClient.cs - Pipe message protocol → Broker messages: serializes
shared/Protocol/BrokerProtocol.cs - Windows service host → Pipe broker server: hosts
broker/WindowsServiceHost.cs - Broker entry point → Windows service host: starts service
broker/Program.cs - Broker entry point → Pipe broker server: starts server
broker/Program.cs - Broker client → Pipe broker server: sends pipe requests
README.md - Pipe broker server → Pipe message protocol: reads and writes messages
broker/PipeBrokerServer.cs - Pipe broker server → Broker security options: authorizes clients
broker/PipeBrokerServer.cs - Pipe broker server → Broker command engine: dispatches requests
broker/PipeBrokerServer.cs - Broker command engine → Hyper-V operations: queries and acts
broker/BrokerEngine.cs - Hyper-V operations → Hyper-V management: uses WMI
README.md - Broker command engine → Configuration service: loads and reloads
broker/BrokerEngine.cs - Configuration service → Target configuration: deserializes and validates
shared/Services/ConfigService.cs - Configuration service → Application paths: gets configuration paths
shared/Services/ConfigService.cs - Broker command engine → VM startup policy: reads and sets policy
broker/BrokerEngine.cs - Tray entry point → Configuration service: loads configuration
src/Program.cs - Broker command engine → Logging: logs operations
broker/BrokerEngine.cs - Windows service host → Logging: logs service activity
broker/WindowsServiceHost.cs - Tray UI and menu → Logging: logs tray activity
src/UI/TrayApplicationContext.cs - Target configuration → Localization: validates localized values
shared/Models/AppConfig.cs