2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4
<!ENTITY date "January 2007">
5
<!ENTITY appversion "@PACKAGE_VERSION@">
6
<!ENTITY app "@PACKAGE_NAME@">
9
<article id="index" lang="en">
12
<title>Xfce 4 Desktop Manager</title>
15
<year>2008</year> <holder>Jérôme Guelfucci</holder>
19
<year>2004-2007</year> <holder>Brian Tarricone</holder>
23
<year>2004</year> <holder>Jasper Huijsmans</holder>
27
<year>2004</year> <holder>François Le Clainche</holder>
30
<!-- documentation translators: uncomment this and fill in your information.
32
<year>2002</year> <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
36
<!-- I don;t know about this
37
<legalnotice id="legalnotice">
39
This document is provided under the terms of the GNU GPL, version
40
2 or (at your option) any later version.
47
<firstname>Brian</firstname> <surname>Tarricone</surname>
49
<address><email>kelnos@xfce.org</email></address>
53
<firstname>Jasper</firstname> <surname>Huijsmans</surname>
55
<address><email>jasper@xfce.org</email></address>
60
<firstname>François</firstname> <surname>Le Clainche</surname>
62
<address><email>fleclainche@wanadoo.fr</email></address>
67
<firstname>Jérôme</firstname> <surname>Guelfucci</surname>
69
<address><email>jerome.guelfucci@gmail.com</email></address>
75
This manual describes &app; version &appversion;.
79
<sect1 id="xfdesktop-intro">
80
<title>Introduction</title>
83
The <application>&app;</application> application manages the desktop backdrop. It sets a
84
backdrop image and/or color and it can pop up an applications
85
menu and a list of all running applications when you click on the desktop
86
with the right or middle mouse button respectively. As of Xfce 4.4,
87
<application>&app;</application> also draws icons on the desktop.
91
The <application>&app;</application> package installs a settings dialog for use with
92
the <emphasis>Xfce 4 Settings Manager</emphasis>. From this dialog you
93
can change the backdrop image and color and change settings for the menu
98
<sect1 id="xfdesktop-backdrop">
99
<title>Backdrop</title>
102
<application>&app;</application> is responsible for drawing the desktop's backdrop (sometimes called
103
"wallpaper") image. There are various options for setting a backdrop
104
image. The final picture seen on the monitor is composed of a solid
105
color or gradient, with an image or photo (with optional transparency)
106
composited on top of the color or gradient. This allows for some
107
interesting effects using semi-transparent images on top of various
112
<sect1 id="xfdesktop-icons">
116
In addition to drawing the backdrop image, <application>&app;</application> can draw icons on the
120
<sect2 id="xfdesktop-window-icons">
121
<title>Minimized Window Icons</title>
124
One mode of operation displays minimized applications as icons on the
125
desktop, which can be rearranged, and will remember their positions
126
when the window is unhidden and then later minimized again. The icons
127
also provide a right-click menu similar to the window's control menu
128
accessed by clicking the button in the top-left corner of the window.
132
<sect2 id="xfdesktop-file-icons">
133
<title>File/Launcher Icons</title>
136
<application>&app;</application> can also display on the desktop the contents of the
137
<filename>$XDG_DESKTOP_DIR</filename> folder, which can be set in
138
the <filename>$XDG_CONFIG_HOME/user-dirs.dirs</filename> file (if you
139
do not have this file, it will use <filename>$HOME/Desktop</filename>).
140
Files can be arranged, copied, moved,
141
and linked to and from a file manager, and opened using
142
preferred applications. Application and URL launchers can
143
also be created on the desktop. The file icon view is modeled
144
to have a similar look and feel as the
145
<ulink url="http://thunar.xfce.org/" type="http">Thunar</ulink> file
151
<sect1 id="xfdesktop-menu">
152
<title>The Desktop Menu</title>
155
A right-click on the desktop backdrop opens a menu that allows you to
156
open a Thunar window in the Desktop directory, to create launchers,
157
URL links, folders and files from templates. It is also possible to
158
open the Desktop Settings and the Properties window of the Desktop
159
directory and to start many of the applications found on your system.
162
<figure id="root-menu-fig">
163
<title>Desktop Menu</title>
167
<imagedata fileref="images/root_menu.png" format="PNG"/>
170
<phrase>Shows <application>&app;</application> right-click mouse menu.</phrase>
177
The menu's configuration file, <filename>xfce-applications.menu</filename>,
178
can be found under the path
179
<filename>$sysconfdir/xdg/menus/xfce-applications.menu</filename>.
180
For binary packages, <filename>$sysconfdir</filename> is often
181
<filename>/etc</filename> and for source compiles, it defaults to
182
<filename>/usr/local/etc</filename>.
186
The previous menu editor is not available anymore.
187
However you can customize your menu by copying
188
<filename>xfce-applications.menu</filename> to
189
<filename>$XDG_CONFIG_HOME/menus</filename> and by modifying it
190
with a text editor such as <application>mousepad</application> or
191
<application>gedit</application>. Please remember that the file
192
should be UTF-8 encoded. For more information on menu editing, please
193
see <ulink url="http://wiki.xfce.org/howto/customize-menu" type="http">the
198
Further customisation can be achived by creating
199
<ulink url="http://standards.freedesktop.org/desktop-entry-spec/latest/" type="http">desktop
200
entries</ulink> in <filename>$XDG_DATA_HOME/applications</filename> to
201
hide, modify or add entries in the menu.
206
<sect1 id="xfdesktop-window-list">
207
<title>The Window List Menu</title>
210
A middle-click on the desktop backdrop shows a list of all opened
211
windows ordered by workspace. It also allows you to add or remove
215
<figure id="root-menu2-fig">
216
<title>Window List Menu</title>
220
<imagedata fileref="images/root_menu2.png" format="PNG"/>
223
<phrase>Shows <application>&app;</application> middle-click mouse menu.</phrase>
230
<sect1 id="xfdesktop-settings">
231
<title>Desktop Settings</title>
233
<!-- Needs to be changed once xfce4-settings is documented -->
235
You can start the Desktop settings dialog by clicking on the
236
"Desktop" button in the
237
<ulink url="xfce-mcs-manager.html#manager-dialog"
238
type="http">Xfce Settings Manager</ulink>.
241
<sect2 id="xfdesktop-settings-background">
242
<title>Background Tab</title>
245
The Background tab allows you to set various options related to
246
drawing the desktop backdrop picture.
249
<figure id="xfdesktop-background-fig">
250
<title>Desktop Settings, Background Tab</title>
254
<imagedata fileref="images/xfdesktop-background-tab.png"
259
Shows the Background tab of the Desktop Settings dialog
272
Select the <emphasis>"None"</emphasis> option if you want
273
<application>&app;</application> to ignore the backdrop image and only use the selected
278
Select the <emphasis>"Single image"</emphasis> option if
279
you want <application>&app;</application> to draw a backdrop image.
283
Select the <emphasis>"Image List"</emphasis> option if you
284
want <application>&app;</application> to randomly choose the backdrop image among a list.
296
<!-- Single image stuff -->
298
If you selected the <emphasis>"Single image"</emphasis> option,
299
you can choose an image from the treeview. Click on an image
300
to set it as the current backdrop. <application>&app;</application> will update the
301
background of your desktop automatically.
305
You can add images to the treeview by clicking on the "plus"
306
button, which will pop a file chooser dialog up. Images can be
307
removed using the "minus" button.
310
<!-- Image list stuff -->
312
If you selected the <emphasis>"Image list"</emphasis> option,
313
you can use the "New" button displaying a blank sheet to select
314
an existing list or create a new one, using a file chooser.
315
You can still use the "plus" and "minus" buttons to add
316
and remove images. <application>&app;</application> will then randomly choose a backdrop
317
among this list every time it starts.
320
<!-- Images layout options -->
322
Five Style options (<emphasis>"Centered"</emphasis>,
323
<emphasis>"Tiled"</emphasis>,
324
<emphasis>"Stretched"</emphasis>,
325
<emphasis>"Scaled"</emphasis> and
326
<emphasis>"Zoomed"</emphasis>)
327
are available to specify the fitting of the backdrop image
328
on the screen, depending on its size. You can also select
329
the <emphasis>"Auto"</emphasis> item if you want to let <application>&app;</application>
330
take care of this setting.
333
<!-- To be confirmed as I don't have multiscreen -->
335
<application>&app;</application> supports xinerama and multiscreen modes. In
336
multiscreen mode, the Background tab shows one tab per screen.
345
The color style is one of four options in dropping list:
346
a solid color, horizontal gradient, vertical gradient, or
351
The <emphasis>"Transparent"</emphasis> option, when you use
352
a colored background without backdrop image, allows you
353
to see the windows that are under the transparent desktop
354
window. This requires an activated compositor.
358
Two colored buttons allow you to choose the colors for your
359
desktop. When the solid color option is selected, only the
360
first color is available. When either of the gradient
361
options are selected, both the first and second colors
362
are available. Both of the color buttons open a color
367
<figure id="select_bg_color-fig">
368
<title>Select Background Color</title>
372
<imagedata fileref="images/select_bg_color.png"
376
<phrase>Shows the color selection dialog</phrase>
386
You can use the colored ring with a triangle inside to
387
select the color you want from the outer ring, then select the
388
darkness or lightness of that color using the inner triangle.
389
Corresponding values of brightness, deepness, and amount of red,
390
green and blue light in the color appear through the entries on
391
the right side of the window.
397
You can click the eyedropper, then click anywhere on your
398
screen to select the color.
404
You can enter an HTML-style hexadecimal color value, or
405
simply a color name, in the <emphasis>"Color Name"</emphasis>
412
The selected colors will fill the entire root window, and will
413
remain visible through a transparent backdrop image.
419
<term>Adjustments</term>
423
The two sliders allow you to adjust the brightness and the
424
saturation of the backdrop image and or color.
432
<sect2 id="xfdesktop-settings-menus">
433
<title>Menus Tab</title>
435
<figure id="xfdesktop-menus-tab-fig">
436
<title>Desktop Settings, Menus Tab</title>
441
<imagedata fileref="images/xfdesktop-menus-tab.png"
446
Shows the Menus tab of the Desktop Settings dialog
455
<term>Desktop Menu</term>
460
<emphasis>"Show applications menu on desktop right click"</emphasis>,
461
the <link linkend="xfdesktop-menu">applications menu</link>
462
will be shown when right clicking on the desktop.
466
The <emphasis>"Show application icons in menu"</emphasis>
467
allows you to show or hide icons in the menu.
473
<term>Window List Menu</term>
478
<emphasis>"Show window list menu on desktop middle click"</emphasis>
480
<link linkend="xfdesktop-window-list">window list menu</link>
481
will be shown when middle clicking on the desktop.
485
The <emphasis>"Show application icons in menu"</emphasis>
486
option allows you to show or hide icons in the menu. This
487
option is only available when
488
<emphasis>"Show window list menu on desktop middle click"</emphasis>
492
<!-- Add link to xfwm4 documentation to change workspaces names -->
495
<emphasis>"Show workspace names in list"</emphasis>
496
option allows you to show or hide workspace names in the list.
497
If checked, windows are shown under the name of their workspace.
498
Else, they are all shown in the same portion of the menu.
499
This option is only available when
500
<emphasis>"Show window list menu on desktop middle click"</emphasis>
506
<emphasis>"Show submenus for the windows in each workspace"</emphasis>
507
option allows you to have the windows displayed in a submenu
508
titled with the workspace name. This option is only available
510
<emphasis>"Show workspace names in list"</emphasis> is checked.
515
<emphasis>"Show sticky windows only in active workspace"</emphasis>
516
option allows you to have sticky windows displayed only in
517
the active workspace, instead of displaying their item in
526
<sect2 id="xfdesktop-settings-icons">
527
<title>Icons Tab</title>
529
<figure id="xfdesktop-icons-tab-fig">
530
<title>Desktop Settings, Icons Tab</title>
535
<imagedata fileref="images/xfdesktop-icons-tab.png"
540
Shows the Icons tab of the Desktop Settings dialog
549
<term>Appearance</term>
553
The <emphasis>"Icon type"</emphasis> dropping list allows
554
you to set the behavior of the desktop icons. There are
555
three options: "None", to disable desktop icons entirely;
556
"Minimized" application icons, to show icons for
557
minimized or hidden applications on the desktop;
558
and "File/launcher" icons, to show the contents of your
559
<filename>$XDG_DESKTOP_DIR</filename> directory on the
564
If desktop icons are enabled, you can control the size of the icon
565
itself (in pixels) with the <emphasis>"Icon size"</emphasis>
566
option, and the font size used to display the icon text
568
<emphasis>"Use custom font size"</emphasis> option. If you
569
do not check this last option, the system defaults will be
576
<term>Default Icons</term>
580
The checkboxes allow you to show or hide special icons on
581
the desktop, when <application>&app;</application> is set to draw icons. Double
582
clicking those icons will open a Thunar window displaying
583
the contents of a particular path.
587
<emphasis>Home</emphasis> stands for your home folder, that
588
is to say, <filename>$HOME</filename>.
589
<emphasis>Filesystem</emphasis> stands for the root of your
590
file system, also known as <filename>/</filename>.
591
<emphasis>Trash</emphasis> stands for your trash folder,
592
and <emphasis>Removable devices</emphasis> represents
593
floppy drives, USB drives and keys, external hard drives, optical
602
<sect1 id="xfdesktop-hidden-options">
603
<title>Hidden Options</title>
606
There are a number of hidden options that cannot be set by the Xfce
607
Settings Manager. These require use of a text editor.
612
<term>Icon View Text Appearance</term>
615
The colors of the icon text and the icon text background, as well
616
as the opacity of the icon text background, can be customized
617
by putting directives simiar to the following in your
618
<filename>~/.gtkrc-2.0</filename> file:
622
<![CDATA[style "xfdesktop-icon-view" {
623
XfdesktopIconView::label-alpha = 75
625
base[NORMAL] = "#00ff00"
626
base[SELECTED] = "#5050ff"
627
base[ACTIVE] = "#0000ff"
629
fg[NORMAL] = "#ff0000"
630
fg[SELECTED] = "#ff0000"
631
fg[ACTIVE] = "#ff0000"
633
widget_class "*XfdesktopIconView*" style "xfdesktop-icon-view"]]>
637
The first entry sets the opacity of the rounded text background.
638
The three "base" entries set the text background color, and the
639
three "fg" entries set the text color.
643
The "NORMAL" entries set the color for the regular, unselected
644
state. The "SELECTED" entries set the color for when the icon
645
is selected, and the desktop has keyboard focus. The "ACTIVE"
646
entries set the color for when the icon is selected, but the
647
desktop does not have keyboard focus.
654
<sect1 id="xfdesktop-misc">
655
<title>Miscellaneous</title>
658
You can open the menu or window list from the commandline as well.
659
This can be useful for keyboard shortcuts. To open the menu run the
660
command <application>&app;</application> <application>--menu</application>, and for the windowlist
661
use <application>&app;</application> <application>--windowlist</application>. To cause the
662
current running instance to quit, run <application>&app;</application>
663
<application>--quit</application>.
667
<sect1 id="xfdesktop-copyright">
668
<title>About <application>&app;</application></title>
671
<application>&app;</application> was written by
672
Brian Tarricone (<email>kelnos@xfce.org</email>),
673
Jasper Huijsmans (<email>jasper@xfce.org</email>), and
674
Benedikt Meurer (<email>benny@xfce.org</email>).
675
For more information, please visit the
676
<ulink url="http://www.xfce.org" type="http">Xfce website</ulink>.
680
To report a bug or make a suggestion regarding this application or
681
this manual, use the bug tracking system at
682
<ulink url="http://bugzilla.xfce.org/"
683
type="http">http://bugzilla.xfce.org/</ulink>.
687
If you have questions about the use or installation of this package,
689
<ulink url="http://foo-projects.org/mailman/listinfo/xfce"
690
type="http">xfce</ulink> mailing list. Development
691
discussion takes place on the
692
<ulink url="http://foo-projects.org/mailman/listinfo/xfce4-dev"
693
type="http">xfce4-dev</ulink> mailing list.
697
This program is distributed under the terms of the
698
GNU General Public License as published by the Free Software Foundation;
699
either version 2 of the License, or (at your option) any later version.
703
You should have received a copy of the GNU General Public License
704
along with this program; if not, write to the Free Software
705
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301,