• Overall Plans
• Long Term Goals
• Component specific status
  • Core components
  • Applications
  • Thunar Plugins
  • Panel Plugins
• Testing
• Links

For Xfce 4.20, the plan to add preliminary support to Wayland to core components without losing X11 support. This doesn't mean that by the next major release an Xfce session on Wayland will offer all existing features, but we hope it is minimally usable. We also intended to continue refining our applications to work acceptably on Wayland (those that already work or can be made to work with low effort).

Check the table in the component specific section for details and labelled issues by group:

• Core
• Apps
• Panel Plugins
• Thunar Plugins

It is not clear yet which Xfce release will target a complete Xfce Wayland transition (or if such a transition will happen at all). Below is a list of larger tasks which would need to be done in some way for such a transition to occur.

Some of them are mostly agreed on by the Xfce devs.

• Do not depend on XWayland
  • No xsettings
• Use wlroots over libmutter
  • keep the possibility to run xfdesktop and xfce4-panel as separate components
  • Prevent dependency on libgnome-desktop
  • xfce4-panel and xfdesktop have been ported to Wayland using wlroots. There is also an unofficial port of xfwm4 in progress.
• Keep X11 compatibility for the foreseeable future
  • As long as Nvidia does not properly support Wayland (by providing open drivers), it's good to keep X11 backward compatibility (nouveau driver usually is slower)
  • Wayland compositors which were written from scratch like Weston or sway will never run as a x11 window manager. But others which started as x11 window managers such as kwin or mutter still keep their x11 window management code
  • We do not have the resources to maintain our own Wayland compositor
  • FreeBSD provides https://hikari.acmelabs.space, not sure what is the situation for OpenBSD (possibly libinput missing?)

This table reflects the current status of what's released as 4.19 or git master.

• Port to Wayland done: https://gitlab.xfce.org/xfce/xfce4-panel/-/merge_requests/103
  • Wlroots-based, targeted compositors: Labwc, Wayfire
• On Wayland the panel cannot use GtkSocket/GtkPlug any more to run plugins as external (separate processes). Initially, to advance in the porting of other features, it is enough to run them as internal (same process as the panel, so the crash of a plugin causes the panel to crash). If we want to get this back “natively” afterwards, it seems that we'll have to make the panel a Wayland compositor to some extent (Embedding Compositor, see also Allow embedding foreign wl_surfaces). For the moment the socket/plug structure has been reproduced on Wayland using the layer-shell protocol and D-Bus, which, although not native, has the merit of simplicity and of reusing what exists (more details here).

• Port to Wayland done: https://gitlab.xfce.org/xfce/xfdesktop/-/merge_requests/43
• Workspaces support needs an X11/Wayland abstraction, and could use the wlr-workspace-unstable-v1 protocol on Wayland.
• Listing all toplevel windows (windowlist menu, window icons on desktop) needs an X11/Wayland abstraction, and could use the wlr-foreign-toplevel-management-unstable-v1 protocol on Wayland.

• Unofficial port to Wayland in progress: https://github.com/adlocode/xfwm4/tree/wayland

• A counterpart to xsettings on Wayland has been added in xfce4-settings!104, with the minimum of modifications to make xfsettingd executable on Wayland.
• A port to Wayland of the display settings has been made in xfce4-settings!112, this time with a complete separation of the X11/Wayland code paths throughout xfce4-settings.
• Of the things whose implementation is specific to X11, only the display settings are suitable for porting to Wayland. There is currently no protocol for the rest (keyboard, mouse, workspaces, etc., are all internal to the compositor).

• Port to Wayland done: https://gitlab.xfce.org/xfce/xfce4-power-manager/-/merge_requests/54
• The essential features of user inactivity monitoring and display power management have been restored via protocols ext-idle-notify and wlr-output-power-management.
• There's no real counterpart to brightness management (the wlr-gamma-control protocol offers similar functionality in appearance, but in fact has nothing to do with power saving), but the existing Polkit implementation works independently of the windowing environment.
• Everything to do with keyboard handling (brightness keys, suspend key, etc.) is not restored, since only the compositor is currently able to manage this.

GTK doesn't appear to do anything special if you set a window to be override-redirect or always-on-top. Window positioning isn't (always) controllable by the app on Wayland. (Is this still relevant???)

Wayland does not specify a native interface for the compositor for taking screenshots yet. Though there is a DBUS API offered by gnome(mutter?) for a desktop portal and as well wlroots has a screenshot protocol

So for xfce4-screenshooter there are the following options:

• Add DBus Support for org.freedesktop.portal.Screenshot (like that afaik screenshots should work with mutter)
• Add support for the wlroots screenshot protocol (link?)
• wait until wayland specifies a native interface (see here), and use it when available (Would make alot of sense for many applications, e.g. any video conferencing tool for screencast, so they dont need to implement multiple API's)

Note that backends for xdg-desktop-portals are as well in development for kde and wlroots:

• xdg-desktop-portal-kde
• xdg-desktop-portal-wlr

Currently (Feb 2020) both API's will give screenshots of the whole screen to any client. So far the user has not to approve a screenshot / give permission to specific applications (like e.g. on android). So the security is comparable to the X-Server.

See as well: 1, 2

See details in the xfce4-panel section about how to run external plugins on Wayland. At first, “works” below simply means “doesn't crash”, even after some elementary manipulations (eventually). It does not mean that everything works like on X11.

The tests below were performed on 2022-10-12 by building from git-master for each plugin.

Info about testing specific components.

Regarding the version to test: master, or latest dev release would be best, though latest stable release as well will do. Currently there is not much difference for most components. If you don't test master, best add info on which version you tested.

If you run a NVidia GPU, you will need to use the “Nouveau” driver for testing, Since the proprietary NVidia driver does not provide Wayland support. (Though some things might work in some cases)

• Install Weston with your distribution package manager (if a Wlroots-based compositor is required, as for xfce4-panel, see this MR for more information)
• Maybe set a minimal configuration, for example

  ~/.config/weston.ini

  [keyboard]
  keymap_layout=fr
  numlock-on=true

• Run weston in a terminal emulator, or better: in a tty with a different user, or by logging out of the X11 session first (the compositor may not have quite the same behavior, and this avoids interactions with the current environment)
• If run in a terminal emulator, make sure at least the component to test isn't already running in your X11 session (e.g Thunar as daemon)
• Open a terminal in the Weston session and start the component which is to be tested

• Porting mate apps to wayland
• A deep dive into the wayland protocol
• Check if current display is a wayland display

Back to Top