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-11.0 platform.

Package Information

Mutter Dependencies


gnome-settings-daemon-40.0.1, graphene-1.10.6, libxkbcommon-1.3.0, pipewire-0.3.34, and Zenity-3.32.0


Recommended (Required to build the Wayland compositor)

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 --buildtype=debugoptimized .. &&

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

Command Explanations

--buildtype=debugoptimized: Override the default buildtype (debug), which would produce unoptimized binaries. The test suite of this package needs debug to be enabled.

-Dprofiler=false: Use this option if Sysprof is not installed, and you don't want meson to download Sysprof source code.


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