Introduction to Mutter

Mutter is the window manager for GNOME. It is not invoked directly, but from GNOME Session (on a machine with a hardware accelerated video driver).

This package is known to build and work properly using an LFS-10.1 platform.

Package Information

Mutter Dependencies


gnome-desktop-40.0, gnome-settings-daemon-40.0, graphene-1.10.4, libcanberra-0.30, libwacom-1.9, libxkbcommon-1.2.1, pipewire-0.3.24, UPower-0.99.11, and Zenity-3.32.0


Recommended (Required to build the Wayland compositor)

Recommended (Runtime)

User Notes:

Installation of Mutter

First, fix a race condition that sometimes occurs due to meson dependency ordering:

sed -i '/libmutter_dep = declare_dependency(/a sources: mutter_built_sources,' src/

Install Mutter by running the following commands:

mkdir build &&
cd    build &&

meson --prefix=/usr .. &&

To test the results, issue: dbus-run-session ninja test. The tests require an active X session to run correctly. It is not necessary to run a separate D-bus session if not in a GNOME session, but it provides a clean environment in any case. One test, native-headless, is known to fail.

Now, as the root user:

ninja install


Installed Programs: mutter
Installed Libraries:
Installed Directories: /usr/{lib,include,libexec/installed-tests,share/{installed-tests}}/mutter-8

Short Descriptions


is a Clutter based compositing GTK+ Window Manager

contains the Mutter API functions

Last updated on 2021-04-08 01:16:54 -0500