Differences between revisions 3 and 9 (spanning 6 versions)
Revision 3 as of 2017-04-20 18:45:50
Size: 2051
Editor: TheAnarcat
Comment: add toc
Revision 9 as of 2017-04-20 19:25:57
Size: 4043
Editor: TheAnarcat
Comment: add the mutter trick
Deletions are marked like this. Additions are marked like this.
Line 17: Line 17:
To test Wayland, you will need to have a compatible "composition manager" installed. A composition manager in Wayland is what used to be a compositor in X, merged with the "display server". DebianPackage:Weston is the reference implementation of the concept, but each desktop environment implements their own composition manager. To test Wayland, you will need to have a compatible ''compositor'' installed. A Wayland compositor combines the roles of the X window manager, compositing manager and display server. DebianPackage:Weston is the reference implementation of the concept, but each desktop environment implements their own composition manager.
Line 19: Line 19:
A good way to test Wayland is to install the GNOME desktop environment and select the "GNOME on wayland" session when logging in. You can test weston directly from a regular X session with the following commands:

{{{
sudo apt install weston
weston
}}}

This will start a Wayland window in your regular X session where you can test things.

You can also test the DebianPackage:mutter window manager directly:

{{{
sudo apt install mutter
mutter --nested --wayland
}}}

Then further Wayland clients will show up in that window. Try, for example, starting DebianPackage:gnome-terminal.

Another way to test Wayland is to install the GNOME desktop environment and select the "GNOME on wayland" session when logging in.

== Supported environments ==

Desktop environments:

 * GNOME 3.20+ (if specifically selected; X is used by default in Debian)
 * KDE (Plasma 5.4)
 * Enlightenment
 * Hawaii

Toolkits:

 * Qt 5
 * GTK+ 3.20+
 * Clutter
 * SDL 2.0.2+
 * EFL
 * GLFW 3.2

Window managers:

 * [[http://swaywm.org/|SwayWM]] (RFP: DebianBug:821397, [[https://github.com/SirCmpwn/sway|Github project]])
 * [[https://github.com/Drakulix/fireplace|Fireplace]] (no Debian package yet)

== Unsupported ==

Desktop environments:

 * Cinnamon: [[https://github.com/linuxmint/Cinnamon/issues/5201|discussed]]
 * MATE: [[http://wiki.mate-desktop.org/wayland|planned]], [[https://www.phoronix.com/scan.php?page=news_item&px=MTYwNjQ|source]] (2014)
 * XFCE: [[https://www.reddit.com/r/xfce/comments/4aeqda/xfce_wayland_support/|planned]]

Window managers:

 * i3: [[https://faq.i3wm.org/question/687/i3-support-for-wayland.1.html|FAQ]], [[https://www.reddit.com/r/i3wm/comments/2ucznn/any_i3_support_plans_for_wayland_in_the_neaby/|discussion]], see also [[http://www.i3way.org/|i3way]], a possible approach at porting i3 to Wayland
 * other window managers unlikely to be supported
Line 41: Line 95:
See also the [[https://wayland.freedesktop.org/faq.html|Wayland FAQ]] for more information.
Line 42: Line 97:
== Further reading ==

 * [[https://wiki.archlinux.org/index.php/Wayland|Arch Linux wiki]] - as usual, excellent resource
 * [[https://wayland.freedesktop.org/|Wayland homepage]]
 * [[https://wayland.freedesktop.org/faq.html|Wayland FAQ]]

Translation(s): none


Wayland is a computer protocol that specifies the communication between a display server and its clients, as well as a reference implementation of the protocol in the C programming language.

Wayland's main goal is replacing the X Window System with a modern, simpler windowing system in Linux and other Unix-like operating systems. The project's source code is published under the terms of the MIT License, a permissive free software licence.

As part of its efforts, the Wayland project also develops a reference implementation of a Wayland compositor called Weston.

Testing

To test Wayland, you will need to have a compatible compositor installed. A Wayland compositor combines the roles of the X window manager, compositing manager and display server. Weston is the reference implementation of the concept, but each desktop environment implements their own composition manager.

You can test weston directly from a regular X session with the following commands:

sudo apt install weston
weston

This will start a Wayland window in your regular X session where you can test things.

You can also test the mutter window manager directly:

sudo apt install mutter
mutter --nested --wayland

Then further Wayland clients will show up in that window. Try, for example, starting gnome-terminal.

Another way to test Wayland is to install the GNOME desktop environment and select the "GNOME on wayland" session when logging in.

Supported environments

Desktop environments:

  • GNOME 3.20+ (if specifically selected; X is used by default in Debian)
  • KDE (Plasma 5.4)
  • Enlightenment
  • Hawaii

Toolkits:

  • Qt 5
  • GTK+ 3.20+
  • Clutter
  • SDL 2.0.2+
  • EFL
  • GLFW 3.2

Window managers:

Unsupported

Desktop environments:

Window managers:

  • i3: FAQ, discussion, see also i3way, a possible approach at porting i3 to Wayland

  • other window managers unlikely to be supported

Troubleshooting

Xresources won't load

This is a known issue. Back in 2015, it was decided that the resources were too slow to load and that was dropped from the main GNOME session, see Redhat's bugzilla for more information.

Workaround: run this by hand or setup something to start it up automatically on session login.

xrdb -load .Xsession

FAQ

Why is Wayland necessary?

Wayland allows better isolation between processes: one window cannot access resources from, or inject keystrokes into, another window.

Wayland also has the potential to be faster, by reducing the amount of code between the processes and the hardware, by delegating lots of things to the processes themselves.

See also the Wayland FAQ for more information.

Further reading


CategoryDesktopEnvironment