Linux Virtual Delivery Agent

Client battery status display

The Linux VDA can redirect and display the battery status of client devices in virtual desktops. This feature is enabled by default and available for the following versions of Citrix Workspace app:

  • Citrix Workspace app for iOS
  • Citrix Workspace app for Linux
  • Citrix Workspace app for Mac (version 2204.1 is not supported)
  • Citrix Workspace app for Windows (version 2204.1 is not supported)

Overview

When users open a virtual desktop, they can see a battery icon in the Linux system tray. The battery icon indicates the battery status of their client devices. To check for the percentage of remaining battery life, click the battery icon. For example, see the following screen capture:

Battery status icon

Different battery icons indicate different battery statuses. For an overview, see the following table:

Battery icon Charging status Level of remaining battery life Percentage of remaining battery life
Battery that is charging and has a high level of remaining life Charging, indicated with a “+” symbol High, indicated with a green color

=80%

Battery that is charging and has a medium level of remaining life Charging, indicated with a “+” symbol Medium, indicated with an amber color

=20% and <80%

Battery that is charging and has a low level of remaining life Charging, indicated with a “+” symbol Low, indicated with a red color < 20%
Battery that is not charging and has a high level of remaining life Not charging, indicated with a “-“ symbol High, indicated with a green color

=80%

Battery that is not charging and has a medium level of remaining life Not charging, indicated with a “-“ symbol Medium, indicated with an amber color

=20% and <80%

Battery that is not charging and has a low level of remaining life Not charging, indicated with a “-“ symbol Low, indicated with a red color < 20%
Unknown battery status Unknown Unknown Unknown

Configuration

The client battery status display is enabled by default.

To disable the feature, run the following command:

/opt/Citrix/VDA/bin/ctxreg update -k "HKLM\System\CurrentControlSet\Control\Citrix\VirtualChannels\MrVc"  -v "Enabled" -d "0x00000000"
<!--NeedCopy-->

To enable the feature, run the following command:

/opt/Citrix/VDA/bin/ctxreg update -k "HKLM\System\CurrentControlSet\Control\Citrix\VirtualChannels\MrVc"  -v "Enabled" -d "0x00000001"
<!--NeedCopy-->

Note:

The preceding commands impact the soft keyboard feature, which shares the Mobile Receiver Virtual Channel (MRVC) with the client battery status display.

Based on your distribution, complete the extra steps to enable the feature. For more information, see the Enable the system tray section.

Client battery status display