Mutter-47.3

Installation of Mutter

Install Mutter by running the following commands:

mkdir build &&
cd    build &&

meson setup --prefix=/usr       \
            --buildtype=release \
            -D tests=disabled   \
            -D profiler=false   \
            ..                  &&
ninja

The test suite requires an external program called xvfb-run. If you wish to run the tests, you should download and install it before running meson. You can obtain it from xvfb-run, and install it with executable permissions in /usr/bin. xvfb-run needs Xvfb at runtime, and Xvfb can be installed from either Xorg-Server-21.1.15 or Xwayland-24.1.4. You should also replace -D tests=disabled in the meson command, with -D tests=enabled -D clutter_tests=false. The test suite requires the mutter schema to be installed on the system, so it is better to run the tests after installing the package.

You can also test basic functions of Mutter following the section called “Starting Mutter,” after installing it.

Now, as the root user:

ninja install

If you wish to run the tests, remove the reference to Zenity which is not a part of BLFS from one test:

sed 's/zenity --[a-z]*/gtk4-demo/' -i ../src/tests/x11-test.sh

Now run the test suite:

ninja test

The tests require an active X or wayland session. Some tests are flaky (especially under a high system load) so if a test fails you can try to re-run it alone with the meson test <test name> command. A few tests may fail depending on some system configuration. Don't make any mouse or keyboard input while the test suite is running or some tests may fail.