🖥️ Screen app – Error: XWayland is not supported – workaround for Raspberry – DWService

✅ Wayland support is now available and ready to use.
⚠️ However, there are currently some limitations.
📖 You can read more about these here: Wayland

If you decide to use X11 instead of Wayland, you can follow the instructions below.

There are two ways to set up the workaround:

Command

Open a Terminal window and type the following command:

sudo raspi-config nonint do_wayland <W1>

Press Enter.

Enter your password.

Press Enter.

⚠️ Note: you will not see the cursor move while typing. Regardless, type the password.

You can then verify that the setting is correct by using the following command:

echo $XDG_SESSION_TYPE

Press Enter.

If the result is X11, the setting is correct.

➡️ Restart the Raspberry.

✅ With this setting, our Screen application will also work properly.

💡 In case you would like to revert to Wayland using a command, use the following command:

sudo raspi-config nonint do_wayland <W2>

You can read about the command here: Raspberry Pi Documentation – Configuration

Graphical interface

Open a Terminal window and type the following command:

sudo raspi-config

Press Enter.

Enter your password.

⚠️ Note: you will not see the cursor move while typing. Regardless, type the password.

Press Enter.

The following window appears:

Select Advanced Options.

💡 Hint: use the arrow keys to navigate and press Enter to select.

The following menu appears:

Select Wayland.

Here you can change the system from Wayland to X11.

Use this option to switch between the X11 and Wayland backends. The Wayland backend was introduced in Bookworm, X11 was used in older versions of Raspberry Pi OS.

➡️ Switch to X11.

If the setting to X11 is done, restart the Raspberry.

✅ With this setting, our Screen application will also work properly.