Wayland: Difference between revisions
imported>Lumarius Added an explanatory note to those not familiar with Ozone. |
imported>Spitzeqc Added basics for enabling Wayland |
||
| Line 1: | Line 1: | ||
{{Expansion| | {{Expansion|Verify accuracy of article}} | ||
== Checking for Wayland == | |||
To check if you are using Wayland, run the following command {{Commands|$ echo $XDG_SESSION_TYPE}} If {{ic|wayland}} is returned, you are running Wayland | |||
== Setup == | |||
Two things are required for running Wayland: a compatible Display Manager, and a compatible Compositor. | |||
{{Expansion|Verify completeness of DM and Compositor lists}} | |||
== Display Managers == | |||
Display Managers are responsible for handling user login. | |||
The following Display Managers support using both X and Wayland protocols | |||
==== Graphical ==== | |||
* [https://github.com/NixOS/nixpkgs/blob/592047fc9e4f7b74a4dc85d1b9f5243dfe4899e3/nixos/modules/services/x11/display-managers/gdm.nix gdm] is the [[GNOME]] Display Manager. | |||
* [https://github.com/NixOS/nixpkgs/blob/592047fc9e4f7b74a4dc85d1b9f5243dfe4899e3/nixos/modules/services/x11/display-managers/sddm.nix sddm] is the default Display Manager for [[KDE]]. Wayland support is currently experimental. | |||
==== Text-based ==== | |||
* [https://github.com/NixOS/nixpkgs/blob/592047fc9e4f7b74a4dc85d1b9f5243dfe4899e3/pkgs/applications/display-managers/ly/default.nix ly] | |||
* [https://github.com/NixOS/nixpkgs/blob/592047fc9e4f7b74a4dc85d1b9f5243dfe4899e3/pkgs/applications/display-managers/emptty/default.nix emptty] | |||
* [https://github.com/NixOS/nixpkgs/blob/592047fc9e4f7b74a4dc85d1b9f5243dfe4899e3/pkgs/applications/display-managers/lemurs/default.nix lemurs] | |||
== Compositors == | == Compositors == | ||
For the purposes of this basic overview, a compositor can be thought of as equivalent to an X Desktop Environment. {{Note|It is important to remember that this is not actually the case as there are [https://en.wikipedia.org/wiki/Wayland_(protocol)#Differences_between_Wayland_and_X multiple differences] between how X and Wayland work internally}} | |||
=== Wayland Native === | |||
* [[Sway]] is a i3-like compositor. | * [[Sway]] is a i3-like compositor. | ||
* [[Hyprland]] the dynamic tiling Wayland compositor that doesn't sacrifice on its looks. | * [[Hyprland]] the dynamic tiling Wayland compositor that doesn't sacrifice on its looks. | ||
=== X and Wayland support === | |||
* [https://github.com/NixOS/nixpkgs/blob/nixos-23.11/pkgs/desktops/gnome/core/mutter/default.nix Mutter] is the default [[GNOME]] Desktop Environment/Compositor. | |||
* [https://github.com/NixOS/nixpkgs/blob/nixos-23.11/pkgs/desktops/plasma-5/default.nix Plasma] is the default [[KDE]] Desktop Environment/Compositor. | |||
== Applications == | == Applications == | ||
Not all apps support running natively on Wayland. To work around this, XWayland should be enabled. {{Note|Enabling XWayland varies slightly from Compositor to Compositor, and may already be enabled. Consult your Compositor's documentation and/or nix file for how to enable}} | |||
=== Electron and Chromium === | ==== Electron and Chromium ==== | ||
<!-- I kept getting META error when trying {{ic|NIXOS_OZONE_WL=1}}, and replacing the equals with = didn't work either — does anyone know how to markup this correctly? --> | <!-- I kept getting META error when trying {{ic|NIXOS_OZONE_WL=1}}, and replacing the equals with = didn't work either — does anyone know how to markup this correctly? --> | ||
Latest revision as of 03:11, 19 March 2024
 |
This article or section needs expansion.
Reason: Verify accuracy of article (Discuss in Talk:Wayland#)
Please consult the pedia article metapage for guidelines on contributing. |
Checking for Wayland
To check if you are using Wayland, run the following command
$ echo $XDG_SESSION_TYPE
If wayland is returned, you are running Wayland
Setup
Two things are required for running Wayland: a compatible Display Manager, and a compatible Compositor.
|
This article or section needs expansion.
Reason: Verify completeness of DM and Compositor lists (Discuss in Talk:Wayland#)
Please consult the pedia article metapage for guidelines on contributing. |
Display Managers
Display Managers are responsible for handling user login.
The following Display Managers support using both X and Wayland protocols
Graphical
- gdm is the GNOME Display Manager.
- sddm is the default Display Manager for KDE. Wayland support is currently experimental.
Text-based
Compositors
For the purposes of this basic overview, a compositor can be thought of as equivalent to an X Desktop Environment.
Wayland Native
- Sway is a i3-like compositor.
- Hyprland the dynamic tiling Wayland compositor that doesn't sacrifice on its looks.
X and Wayland support
- Mutter is the default GNOME Desktop Environment/Compositor.
- Plasma is the default KDE Desktop Environment/Compositor.
Applications
Not all apps support running natively on Wayland. To work around this, XWayland should be enabled.
Electron and Chromium
As of NixOS 22.05 ("Quokka"), you can enable Ozone Wayland support in Chromium and Electron based applications by setting the environment variable NIXOS_OZONE_WL=1. For example, in a configuration.nix:
environment.sessionVariables.NIXOS_OZONE_WL = "1";
This allows these applications to run without Xwayland.