<chapter xmlns="http://docbook.org/ns/docbook"
         xmlns:xlink="http://www.w3.org/1999/xlink"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         version="5.0"
         xml:id="sec-wayland">
 <title>Wayland</title>

 <para>
  While X11 (see <xref linkend="sec-x11"/>) is still the primary display
  technology on NixOS, Wayland support is steadily improving.
  Where X11 separates the X Server and the window manager, on Wayland those
  are combined: a Wayland Compositor is like an X11 window manager, but also
  embeds the Wayland 'Server' functionality. This means it is sufficient to
  install a Wayland Compositor such as <package>sway</package> without
  separately enabling a Wayland server:
<programlisting>
<xref linkend="opt-programs.sway.enable"/> = true;
</programlisting>
  This installs the <package>sway</package> compositor along with some
  essential utilities. Now you can start <package>sway</package> from the TTY
  console.
 </para>

 <para>
  If you are using a wlroots-based compositor, like sway, and want to be able to
  share your screen, you might want to activate this option:
<programlisting>
<xref linkend="opt-xdg.portal.wlr.enable"/> = true;
</programlisting>
  and configure Pipewire using <xref linkend="opt-services.pipewire.enable"/>
  and related options.
 </para>
</chapter>
