Xfce Wiki

Sub domains
 

xfdesktop - Xfce Desktop Manager


Xfdesktop is a desktop manager for the Xfce Desktop Environment. It handles the following tasks:

  • background image / color
  • root menu, window list
  • minimized app icons
  • file icons on the desktop (using Thunar libs)

It can bring up an applications menu and a list of all running applications when you click on the desktop with the right or middle mouse button, respectively. Settings are available via the Settings Manager.


General


Minimum Requirements

  • Meson
  • gettext
  • GTK+ 3.24.41
  • libxfce4util 4.20.0
  • libxfce4ui 4.21.0
  • libxfce4windowing 4.20.6
  • xfconf 4.20.0
  • libyaml 0.2.5 (required for desktop file icons)
  • garcon 4.20.0 (optional; required for apps menu)
  • thunarx 4.20.0 (optional; required for file icons)
  • tumbler 1.6 (optional; enables thumbnail previews for file icons)
  • cairo 1.12
  • GStreamer 1.24.2 (required for video backdrops; also needs gst-plugin-gtk)
  • libnotify 0.8.3 (mount notifications)
  • libX11 1.8.7 (X11 support)
  • gtk-layer-shell 0.8.2 (Wayland support)

Back to Top


Debugging Support

Debug behaviour is controlled with Meson's built-in `debug` and `optimization` options, normally set through `buildtype`:

Argument
`-Dbuildtype=debug` Enables all xfdesktop debug code: `DEBUG=1`, `DEBUG_TRACE=1`, `G_ENABLE_DEBUG`, and `-fstack-protector-strong`. Use this for development and locating bugs.
`-Dbuildtype=debugoptimized` The project default. Debug symbols with `-O2`, without the extra xfdesktop debug checks.
`-Dbuildtype=release` `-O3` without debug symbols. The project adds `NDEBUG`, `G_DISABLE_CAST_CHECKS`, and `G_DISABLE_ASSERT`.

Furthermore, the `–enable-debug` and `–disable-debug` runtime arguments can be used to toggle debug messages.

Back to Top


Latest Release

  • xfdesktop 4.21.1 released (2026/10/11 00:39)

Read the CHANGELOG

Back to Top


Source code repository

Reporting Bugs

  • Reporting Bugs – List of currently open bugs and instructions on how to submit new bug reports

Back to Top

Return to Xfce Main Documentation Page