Copyright © 2003 François Le Clainche
Copyright © 2003 Jasper Huijsmans
Table of Contents
The XFce 4 Window Manager is part of the XFce Desktop Environment. The actual command to run is xfwm4. To run it in the background use xfwm4 --daemon. The window manager is responsible for the placement of windows on the screen, provides the window decorations and allows you for instance to move, resize or close them.
If you are familiar with previous versions of XFce you will find many changes. First of all, xfwm4 adheres strongly to the standards defined on freedesktop.org. Consequently, special features such as making windows borderless, or providing an icon for the application must now be implemented in the application; you can no longer use the window manager to force different behaviour. Most visible change is probably the themeability. The window decorations (borders, title bar and window buttons) can be configured by using window manager themes.
xfwm4 offers Xinerama support, useful when you have more than one monitor connected to your computer, but you have to make sure libxfcegui4 is compiled with --enable-xinerama.
xfwm4 can be run stand-alone, but if you use it this way, you will need the XFce 4 Settings Manager if you want GUI settings management. Tasks other than managing windows, like setting a background image or launching programs, need to be performed by other programs.
The window manager provides borders, a title bar and window buttons to application windows. The look is defined by the window manager theme.
In the default theme xfwm4 shows six buttons and a title on regular application windows. The six buttons perform these basic functions:
You can open the window menu with a left-click on the menu button on the title bar, or with a right-click on the window title area itself.
You need to give the focus to a window if you want it to receive keyboard and mouse input. Window decorations colors will change, following the focus. To obtain more details about focus options, please refer to the section called “Keyboard and focus” above.
A keyboard shortcut allows to switch the focus from a window to others : Hold Alt and then you can press Tab repeatedly untill you get to the window you want to focus. If you use it, you will see a small popup with the window title and also xfwm4 will highlight the outline of the window that will receive the focus.
If you want the panel, and apps that do not appear in the taskbar, to be included when you switch the focus using the Alt+Tab shortcut, edit your $HOME/.xfce4/xfwm4rc (or create an new one) and add this line : cycle_minimum=false
NOTE: the use of a keyboard shortcut in an application needs the application window to have the focus :)
If you maximize a window, it will expand on your display and use all avaible space (as it is defined by workspace settings). Moreover, you can maximize a window only vertically ou horizontally.
To maximize a window, perform one of those actions:
To maximize a window vertically :
To maximize a window horizontally :
When a window has been maximized in a way or another, it can be restored to its previous size doing one of these actions :
Although certain special windows can not be resized, you are able to resize most of them to fit your needs.
You can hide a window performing one of these actions :
Alternatively, you can hide all windows of current workspace, excepted the one you are using, in only one action : click the menu button of the title bar and choose "Hide all others".
To "unhide" a window, you will have to select its name or its icon in one of those XFce 4 components :
If you "shade" a window, it will be reduced to the size of its title bar. The same repeated action makes a window to shade/unshade :
If you "stick" a window, it will be visible at the same place on all your workspaces. The same repeated action make a window to stick/unstick :
There are several ways to move windows :
You can send a window to another workspace by performing one of these actions :
To close a window :
In the default configuration the following keybindings are defined:
To open the Window Manager preferences dialog, click the button labelled "Window Manager" in the XFce 4 Settings manager. The dialog shows three tabs : Decoration style, Keyboard and focus, Advanced. All modifications will have an immediate effect on the behaviour of the selected module.
The list on the left side of the dialog shows all avaible window decorations. The xfwm 4 module offers the choice between 10 different themes, but there are more than 50 supplementary themes avaible in xfwm4-themes extra package. You can preview all of them on the official XFce Website
The "Font select" button shows the family font currently in use for the window title appearance. Click this button if you want to change it, and a "Font selection" dialog will appear. It works like the font selection dialog of the user interface settings manager plugin.
Whatever the buttons layout is, you can choose the alignment of the title inside the title bar, selecting one of those simple options : align it to the left, center or right.
The button layout configuration uses an intuitive interface with radio buttons. Just imagine that all selected items project themselves on the baseline of the frame. Moreover, all modifications will have an immediate effet on the title bar buttons position.
The list on the left side of the dialog shows all avaible shortcuts themes, using the name of directories that contain a keythemerc file.
By default, there's only one theme : $(prefix)/share/xfwm4/themes/default.keys/keythemerc
You can customize keyboard shortcuts by editing this default keythemerc file (seven shorcuts entries are left empty for your convenience), or you can create a new theme, either like this one : $(prefix)/share/xfwm4/themes/custom.keys/keythemerc, or like this one (in your $HOME directory) : $HOME/.themes/xfwm4/custom.keys/keythemerc.
NOTE : $prefix is the install-prefix you used during xfwm 4 setup, usually /usr or /usr/local.
If you do not know the names of your keyboard modifier keys, you can launch the "xev" application from a terminal and test them.
A focused window receives the keyboard and mouse input. You have the choice between two focus models :
Selecting this option will automatically give the focus to newly created windows, without the need to click or move the mouse pointer.
If this option is selected, the frame of a newly focused window will automatically appear over all other frames, after an amount of time that you can adjust with the "delay" slider.
Choose this option if you want a window to pass over the others when you click anywhere on its frame. If this option is not selected, you will have to click somewhere on its decorations (title bar, borders or corners) to raise it.
You can choose the windows borders to be attracted by the borders of other windows, or by the screen edges, when they are moved. The distance from which this effect will be applied can be specified with the "Distance" slider.
Select the first option if you want to switch to the next workspace when the mouse pointer reaches the screen edges. Select the second one if you want the same behaviour while dragging a window. You can specify the screen edges resistance using the corresponding slider.
Two options allow you to choose if the content of a window will appear or not, when you move or resize it (not displaying the content will save some system resources).
Select what must be the behaviour of the window manager when you double-click on the title bar of a window : shade window, hide window, maximize window or none.
To open the Workspace Margins dialog, click the button labelled "Workspace Margins" in the settings manager dialog.
Margins are areas on the edges of the screen that maximized windows won't cover. You can adjust the size, in pixels, of all margins (left, right, top and bottom). Use this feature, for example, if you do not want maximized windows to overlap panel or iconbox frames.
xfwm4 was written Olivier Fourdan (<fourdan@xfce.org>). To find more information, please visit the XFce web site.
To report a bug or make a suggestion regarding this application or this manual, send an email to the xfce4-dev mailing list — this is the preferred method — or use the bug tracking system at the XFce SourceForge project site. If you have questions about the use or installation of this package, please ask on the xfce mailing list.
This program is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.