xfwm is the window manager for the Xfce environment.
- 1 Installation
- 2 Configuration
- 3 Tips & Tricks
- 4 Troubleshooting
- 5 See also
Install the package.
To run xfwm as stand-alone, edit Xinitrc and add the following line:
Most xfwm settings can be accessed through
xfwm4-settings, for window behavior and shortcuts,
xfwm4-tweaks-settings, for advanced settings and compositing, and
xfwm4-workspace-settings, for the number of workspaces and their names.
- This compositor may cause video tearing in applications, see #Video tearing.
- From Xfwm 4.12 onward, the compositor is enabled by default.
To enable or disable the Xfwm compositor and adjust its settings, go to Window Manager Tweaks:
Alternatively, it can be enabled with
--compositor or using xfconf. For example:
exec xfwm4 --compositor=on
$ xfconf-query -c xfwm4 -p /general/use_compositing -s true
Double clicking the titlebar, or clicking roll window up in the window menu, causes the window contents to disappear leaving only the titlebar. To disable this functionality with
$ xfconf-query -c xfwm4 -p /general/mousewheel_rollup -s false
Xfwm can "tile" a window automatically when it is moved to an edge of the screen. It does so by resizing it to fit the top half of the screen. To enable or disable this behaviour with
$ xfconf-query -c xfwm4 -p /general/tile_on_move -s false $ xfconf-query -c xfwm4 -p /general/tile_on_move -s true
Alternatively, (un)check Window Manager Tweaks > Accessibility > Automatically tile windows when moving toward the screen edge.
Extra settings provided by the xfce settings manager
The themes installed will be shown in the
Tips & Tricks
Hide the titlebar when window is maximized
Accessibility and check
Hide title of windows when maximized.
No icons shown in browser for downloaded items
Number of workspaces changes unexpectedly
Keep in mind Xfwm assigns shortcuts to adding and removing workspaces. By default these are
If the number of workspaces resets at login, change the amount after Xfwm is started. This is ensured by the
sleep command. 
(sleep 3 && xfconf-query -v -c xfwm4 -p /general/workspace_count -s number) & exec xfwm4
[Desktop Entry] Exec=sh -c "sleep 3 && xfconf-query -v -c xfwm4 -p /general/workspace_count -s number"
See also: Logout alters workspaces
If you experience video tearing whilst using Xfwm, open xfwm4-tweaks-settings, navigate to the compositor tab and tick the Synchronize drawing to the vertical blank option. If you use Intel graphics and you have already enabled "TearFree" option in Xorg config as described in Intel graphics#Tear-free video, then disable Synchronize drawing to the vertical blank option.
If this does not fix the tearing, consider disabling Xfwm's compositor and using an alternative composite manager.
Horizontal line above dock windows
Xfwm may incorrectly render shadows above some dock windows (e.g.or ). This would result in a horizontal line across the screen. A workaround is to disable Show shadows under dock windows under Settings > Window Manager Tweaks > Compositor.