%general-entities; ]> $Date$ Mutter-&mutter-version; Mutter 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). &lfs112_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &mutter-md5sum; Download size: &mutter-size; Estimated disk space required: &mutter-buildsize; Estimated build time: &mutter-time; Estimated build time: &mutter-time-systemd; Mutter Dependencies Required , , , , , and Recommended , , , and Recommended (Required to build the Wayland compositor) , , , and . Additionally, needs to be built with Wayland support. Recommended (Runtime) Optional (required for tests) and (for X11 sessions) User Notes: Installation of Mutter Install Mutter by running the following commands: mkdir build && cd build && meson --prefix=/usr --buildtype=release -Dtests=false .. && ninja The test suite requires debug functions to be enabled in the build, and 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 or . You should also replace --buildtype=release -Dtests=false in the meson command, with --buildtype=debugoptimized -Dtests=true. 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 , after installing it. Now, as the root user: ninja install The tests can now be run: issue ninja test. The tests require an active X or wayland session. The native-unit is known to fail. A lot of tests will fail if the opengl rendering is not done in hardware. Command Explanations -Dtests=false: Prevents building the tests, and removes a hard requirement on xvfb-run. : Use this option if Sysprof is not installed, and you don't want meson to download Sysprof source code. Starting Mutter Mutter is normally used as a component of gnome-shell, but it can be used as a standalone Wayland compositor too. To run Mutter as a Wayland compositor, in a virtual console, issue: mutter --wayland -- vte-2.91 Replace vte-2.91 with the command line for the first application you want in the Wayland session. Note that once this application exits, the Wayland session will be terminated. Mutter can also function as a nested compositor in another Wayland session. In a terminal emulator, issue: MUTTER_DEBUG_DUMMY_MODE_SPECS=1920x1080 mutter --wayland --nested -- vte-2.91 Replace 1920x1080 with the size you want for the nested Wayland session. Contents Installed Programs Installed Libraries Installed Directories mutter libmutter-10.so /usr/{lib,include,libexec/installed-tests,share/{,installed-tests}}/mutter-10 Short Descriptions mutter is a Clutter based compositing GTK+ Window Manager mutter libmutter-9.so contains the Mutter API functions libmutter-9.so