~~NOTOC~~
{{ :xfce:xfce.xfdesktop.png?no link|}}
====== xfdesktop - Usage ======

  * **[[#Background|Background]]**
  * **[[#Icons|Icons]]**
  * **[[#Menus|Menus]]**

----

''xfdesktop'' is responsible for drawing the desktop's background, or "wallpaper", as well as icons on the desktop.
<figure "Desktop with icons">{{:xfce:xfdesktop:xfdesktop_wicons_nopanel4.png?600nolink|}}</figure>

----

===== Background =====
There are various options for setting a background image - the final background is composed of a solid color or gradient, with an image (with optional transparency) composited on top. Images can be manipulated in various ways to fill the screen, such as being stretched, zoomed, scaled, centered or tiled.

<figure "Tiled background image">{{:xfce:xfdesktop:xfdesktop_tiled2.png?600nolink|}}</figure>

Rather than an image, a color or gradient of two colors can also be used as the desktop background. Gradients can be either horizontal or vertical. 

<figure "Vertical gradient background">{{:xfce:xfdesktop:xfdesktop_vertgradient2.png?600nolink|}}</figure>

As the final background can be composed of a color and an image on top, you can mix the two to produce some interesting effects using semi-transparent images on top of various colors. When an image is centered or scaled and doesn't fill the exact dimensions, the background color is shown on either side of the image.

<figure "Horizontal gradient background with semi-transparent image on top">{{:xfce:xfdesktop:semitrans.png?600nolink|}}</figure>

<note tip>If the image style is set to **None** and a transparent color is chosen, then the desktop background defaults to plain white.</note>

[[|Back to Top]]
----

===== Icons =====
Icons drawn on the desktop can either be file/launcher icons or minimised application windows. These can be customized to be different sizes, with a custom font and tooltip size, with the option to turn off tooltips altogether. The **File/launcher** option displays files, folders, and launchers as icons on your desktop that can be freely arranged, named, copied and moved, modelled to have a similar look and feel as a regular file manager. Launchers can be edited via right-clicking and selecting **Edit Launcher**.

Note: Optionally you can use a [[:xfce:tumbler:available_plugins#customized_thumbnailer_for_folders|customized thumbnailer for folder]], to use foreign images for folder desktop icons.

<figure "Large file/launcher icons">{{:xfce:xfdesktop:large_icons.png?600nolink|}}</figure>
<figure "Edit launcher from context menu">{{:xfce:xfdesktop:edit_launcher.png?nolink|}}</figure>

The **Minimised application icons** option displays minimised windows as icons on your desktop which also can be freely arranged, and offer window controls similar to the drop-down menu when clicking on the application's icon on the left of the title bar upon right-click.

All icons can be found in the ''~/Desktop'' directory, and can be accessed via a file manager. Launchers are ''.desktop'' files that can be edited using a text editor, or created and placed in the ''~/Desktop'' directory to create application icons the desktop.

<figure ".desktop files in Thunar">{{:xfce:xfdesktop:thunar_desktop.png?nolink|}}</figure>


[[|Back to Top]]
----

===== Menus =====
''xfdesktop'' offers right and middle-clicking menu options; right-clicking on the desktop opens up a menu with shortcuts to different actions. Examples of these include opening up a file manager or terminal window in the ''~/Desktop'' directory, creating launchers, URL links, folders and files from templates and offering clipboard actions. You can also open the Desktop settings and access the desktop properties from this menu, as well as providing a shortcut to arrange the desktop icons.

<figure "Accessing applications from the desktop menu">{{:xfce:xfdesktop:app_menu3.png?nolink|}}</figure>

The window list menu can be displayed by middle-clicking on the desktop if the option is enabled in the [[https://docs.xfce.org/xfce/xfdesktop/preferences#window_list_menu|settings]]. Depending on the preferences, middle-clicking on the desktop will show a list of all opened windows ordered by workspace (optionally grouped into drop-down lists), with options to also allow you to quickly add or remove a workspace from the menu itself.

<figure "Window list menu">{{:xfce:xfdesktop:window_list.png?nolink|}}</figure>
<figure "Grouped workspace entries">{{:xfce:xfdesktop:grouped_list2.png?nolink|}}</figure>


[[|Back To Top]]
----
[[ :xfce:xfdesktop:start:|Return to Main xfdesktop page]]