Building

• Set up Gnome Shell following the GNOME build instructions.

• Build GNOME modules and xwayland-enabled Xserver

jhbuild sysdeps --install meta-gnome-core-shell mutter
jhbuild build meta-gnome-core-shell mutter

Running

Starting GNOME from gdm

Since GNOME 3.12, the easiest way to try out GNOME on Wayland is to simply select it from the list of sessions in gdm when you log in. How simple is that!

Starting GNOME manually from a VT

• Change to a VT
• Run:

jhbuild run gnome-session --session=gnome-wayland

Starting GNOME Nested

Does not work yet

Starting GNOME from GDM

Starting with GNOME 3.12, 'GNOME on Wayland' will appear in the session menu on the login screen, and just selecting that at login will get you a full GNOME session running on Wayland.

Starting mutter as a separate session

• Change to a VT
• Run:

jhbuild run  mutter --wayland --display-server

• To test GTK+ apps, you can set GDK_BACKEND=wayland and they will use the wayland backend

GDK_BACKEND=wayland gtk3-demo

Starting mutter nested

• Run:

mutter --wayland --display-server

• To test GTK+ apps, you can set GDK_BACKEND=wayland and they will use the wayland backend

GDK_BACKEND=wayland gtk3-demo