'''Wayland''' is a new windowing protocol for Linux. Utilization of Wayland requires changes to and re-installation of parts of your system's software. For more information on Wayland see its [http://wayland.freedesktop.org/ homepage].

'''Wayland''' is a new windowing protocol for Linux. Utilization of Wayland requires changes to and re-installation of parts of your system's software. For more information on Wayland see its [http://wayland.freedesktop.org/ homepage].

If you plan to run X-applications that don't support Wayland, you have to install {{AUR|xorg-server-xwayland-git}} and either patched graphic drivers according to your system, e.g. {{AUR|xf86-video-intel-xwayland-git}}, or the generic wlglamor fallback found at {{AUR|xf86-video-wlglamor-git}}. After that, create or modify following configuration file:

+

{{hc|~/.config/weston.ini|

+

<nowiki>[core]

+

modules=xwayland.so,desktop-shell.so</nowiki>

+

}}

+

Now you can also run X applications in some kind of "compatibility mode".

== GUI libraries ==

== GUI libraries ==

Line 75:

Line 149:

=== Qt5 ===

=== Qt5 ===

−

You need to install {{Pkg|qt5-base}} and the wayland plugin {{AUR|qt5-qtwayland-git}}.

+

You need to install {{Pkg|qt5-base}} and the wayland plugin {{AUR|qtwayland-git}}.

To run a Qt5 app with the Wayland plugin, set {{ic|QT_QPA_PLATFORM&#61;wayland-egl}}.

To run a Qt5 app with the Wayland plugin, set {{ic|QT_QPA_PLATFORM&#61;wayland-egl}}.

Line 102:

Line 176:

KDE 4.11 beta supports starting [http://blog.martin-graesslin.com/blog/2013/06/starting-a-full-kde-plasma-session-in-wayland/ KWin under Wayland system compositor]. There is currently no support for using KWin as a session compositor.

KDE 4.11 beta supports starting [http://blog.martin-graesslin.com/blog/2013/06/starting-a-full-kde-plasma-session-in-wayland/ KWin under Wayland system compositor]. There is currently no support for using KWin as a session compositor.

−

=== GNOME ===

+

=== GNOME ===

+

Since version 3.10, Gnome has experimental Wayland support but you have to install {{AUR|xwayland-git}} and a equivalent patched graphics driver, e.g. {{AUR|xf86-video-intel-xwayland-git}} to get ''Mutter'' to work. For details look into the [https://live.gnome.org/Wayland GNOME wiki].

+

{{bc|<nowiki>gnome-session --session=gnome-wayland</nowiki>}}

+

+

=== i3 ===

−

GNOME is currently ported to Wayland and will be available in a future version. For details look into the [https://live.gnome.org/Wayland GNOME wiki].

+

Some developers from i3 have [http://www.i3way.org/ sprouted a completely new project] for implementing a shell plugin for Weston to implement the same features and style of i3.

=== Pure Wayland ===

=== Pure Wayland ===

Line 110:

Line 188:

{{Warning|Some really quick notes on installing a pure (no X11) Wayland system on Arch Linux. This is from source and installed into {{ic|/usr/local}}. May break your system. You have been warned.}}

{{Warning|Some really quick notes on installing a pure (no X11) Wayland system on Arch Linux. This is from source and installed into {{ic|/usr/local}}. May break your system. You have been warned.}}

−

First install a base Arch Linux install with base and base-devel. Do not install xorg or any of its libraries

+

First install a base Arch Linux install with base and base-devel. Do not install xorg or any of its libraries.

Qt5

To run a Qt5 app with the Wayland plugin, set QT_QPA_PLATFORM=wayland-egl.

Clutter

The Clutter toolkit has a Wayland backend that allows it to run as a Wayland client. The backend is enabled in the official package in extra.

To run a Clutter app on Wayland, set CLUTTER_BACKEND=wayland.

SDL

Benjamin Franzke is working on a port of SDL to Wayland, it's available in his sdl-wayland repo on freedesktop.org. Further development upon Benjamins work was done by Andre Heider in his wayland branch of libsdl. Scott Moreau picked up where others left and fixed the library to work with 1.0 protocol. You can find his work in wayland branch of SDL repository.

To run a SDL application on Wayland, set SDL_VIDEODRIVER=wayland.

EFL

EFL has complete Wayland support.
To run a EFL application on Wayland, see Wayland project page.