# Xfwm

Related articles

- Desktop environment
- Window manager
- Xfce
- Xorg

xfwm is the window manager for the Xfce environment.

## Installation

Install xfwm4.

### Starting Xfwm

To run xfwm as stand-alone, edit Xinitrc and add the following line:

    exec xfwm4

## Configuration

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.

### Composite manager

Note:

- 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:

    $ xfwm4-tweaks-settings

Alternatively, it can be enabled with `--compositor`. For example:

    ~/.xinitrc

    exec xfwm4 --compositor=on

### Window roll-up

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`, run:

    $ xfconf-query -c xfwm4 -p /general/mousewheel_rollup -s false

### Window tiling

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`, run:

    $ 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

Install xfce4-settings from the official repositories

Note: Installing xfce4-settings may change the default applications for certain tasks. See xdg-open to set the default applications to your liking.

### Additional Themes

Install xfwm4-themes from the official repositories

The themes installed will be shown in the `xfwm4-settings` window.

## Tips & Tricks

### Hide the titlebar when window is maximized

Go to `Accessibility` and check `Hide title of windows when maximized`.

Note: It is recommend to install xfce4-windowck-pluginAUR if you want to put the titlebar of current maximized window on you panel.

## Troubleshooting

### No icons shown in browser for downloaded items

This is fixed by installing xfce4-settings from the official repositories.

### Number of workspaces changes unexpectedly

Keep in mind Xfwm assigns shortcuts to adding and removing workspaces. By default these are `Alt+Delete` and `Alt+Insert`, respectively.

If the number of workspaces resets at login, change the amount after Xfwm is started. This is ensured by the `sleep` command. [1]

    ~/.xinitrc

    (sleep 3 && xfconf-query -v -c xfwm4 -p /general/workspace_count -s number) &
    exec xfwm4

or, from xfce4-session:

    ~/.config/autostart/workspace.desktop

    [Desktop Entry]
    Exec=sh -c "sleep 3 && xfconf-query -v -c xfwm4 -p /general/workspace_count -s number"

See also: Logout alters workspaces

### Video tearing

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 composite manager and using an alternative composite manager.

## See also

- Xfwm - Introduction

Category:

- Stacking WMs