Remote Control Black Screen Issue on Ubuntu 22 LTS Devices

Publish Date: 02-Apr-2025 Last Modified Date: 27-Aug-2025 SOTI MobiControl
2106 0

Summary

Remote control sessions on Ubuntu 22 LTS devices result in a black screen when using XlibFullScreenCapturer.

Related SOTI ONE Platform Products

SOTI MobiControl

Related Device OS

Linux

Issue Description

When attempting to remotely control Ubuntu devices, the session may display a black screen. This issue occurs even though connections are successful.

Environment

  • Operating System: Ubuntu 22 LTS
  • Remote control is attempted through SOTI MobiControl 15.6.6 and 2024.0.1 .

Symptoms

  • Remote control session connects successfully but the screen appears black without any visible content.

    Remote control with black screen 

  • Errors related to screen capturing are logged (for example, "Could not capture screen image").

    2025/03/28 14:37:20 (INFO) (7210f18545c0) Start remote control via server
    2025/03/28 14:37:20 (INFO) (7210f1400640) PC Thread: Enter
    2025/03/28 14:37:20 (INFO) (7210f1400640) Initializing remote control session
    2025/03/28 14:37:20 (INFO) (7210f1400640) RC handshake entry: 0
    2025/03/28 14:37:20 (INFO) (7210f18545c0) A shared remote control session is created
    2025/03/28 14:37:20 (INFO) (7210f1400640) PC protocol command: 1
    2025/03/28 14:37:20 (INFO) (7210f1400640) InitDevice
    2025/03/28 14:37:22 (ERROR) (7210f1400640) LinuxScreenCapturerFactory::GetScreenCapturer():able to get display, will use XlibFullScreenCapturer
    2025/03/28 14:37:24 (INFO) (7210f1400640) Remote control session started by MCUser
    2025/03/28 14:37:24 (INFO) (7210f1400640) Entry point for remote control (Flags = 0x00000000, Access mask = ffffffff, User = User)
    2025/03/28 14:37:24 (INFO) (7210f0a00640) PS:Enter
    2025/03/28 14:37:24 (INFO) (7210f0a00640) Sender: Enter
    2025/03/28 14:37:25 (ERROR) (7210f0a00640) XlibFullScreenCapturer: Non Fatal error occurred with X, attempting to recover
    2025/03/28 14:37:25 (ERROR) (7210f0a00640) XlibFullScreenCapturer: Error grabbing image from screen, refreshing cookie
    2025/03/28 14:37:25 (ERROR) (7210f0a00640) XlibFullScreenCapturer: Could not capture screen image
    2025/03/28 14:37:25 (INFO) (7210f0a00640) FirstCapture: Created bitmap 1920, 966, flags 00000000
    2025/03/28 14:37:25 (INFO) (7210f0a00640) BMP info: 1920, 966, bpp: 32, size: 7418880
    2025/03/28 14:37:25 (ERROR) (7210f0a00640) XlibFullScreenCapturer: Non Fatal error occurred with X, attempting to recover
    2025/03/28 14:37:25 (ERROR) (7210f0a00640) XlibFullScreenCapturer: Error grabbing image from screen, refreshing cookie
    
    

Prevention

To reduce the likelihood of encountering black screen issues during remote control sessions, ensure that a suitable display manager is installed and configured before initiating remote sessions.

Issue Resolution

To resolve this issue, install a display manager to handle the remote control session in place of Xlib libraries. LightDM is recommended for this purpose. Refer to the following LightDM documentation for more details (https://wiki.debian.org/LightDM).

1. Install LightDM using package manager of your choice.

2. Set LightDM as the default display manager by running:

sudo dpkg-reconfigure lightdm

3. Restart the device to apply the changes.

Once configured, the remote control session should display the image correctly.

Remote control when working as expected. 

Was this helpful?