Wayland

名前	種類	説明
GDM	Wayland/X11 上で動作	GNOME ディスプレイマネージャ。
greetd^AUR	ログインデーモン	最小でありながら柔軟なログインデーモン。
LightDM	Wayland/X11 上で動作 [4]	様々なデスクトップに対応したディスプレイマネージャ。
Ly^AUR	コンソール上で動作	TUI ディスプレイマネージャ。
SDDM	X11 上で動作 [5]	QML ベースのディスプレイマネージャ。
tbsm^AUR	コンソール上で動作	bash のみに依存するシンプルな CLI セッションランチャー。

GUI ライブラリ

公式ウェブサイトも参照してください。

GTK

gtk3 と gtk4 パッケージは Wayland バックエンドが有効になっています。

Wayland と X 両方のバックエンドが有効になっているとき、GTK+ ではデフォルトで Wayland バックエンドを使いますが、GDK_BACKEND=x11 環境変数を設定することで Xwayland を使うように上書きできます。

Qt

Qt 5 または 6 は Wayland をサポートしています。qt5-wayland または qt6-wayland パッケージをインストールしてください。

Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[6] にあるように、-platform wayland を使用するか、環境変数 QT_QPA_PLATFORM=wayland をセットして下さい。一方、Wayland セッション上で X11 を使用させるには、QT_QPA_PLATFORM=xcb とセットします。これは、zoom^AUR など、システムの Qt の実装を使用しない一部のプロプライエタリアプリケーションで必要になる場合があります。また、QT_QPA_PLATFORM="wayland;xcb" を使用すると、QtがWaylandが利用できない場合、代わりにxcb (X11)プラグインを使用させることができます。[7]

sway などの一部のコンポジターでは、ネイティブに実行されている Qt アプリケーションの機能が不足している場合があります。たとえば、 KeepassXC はトレイに最小化できません。これは、アプリケーションを実行する前に qt5ct をインストールし、 QT_QPA_PLATFORMTHEME=qt5ct を設定することで解決できます。

Clutter

Clutter ツールキットには Wayland バックエンドがあり、Clutter を Wayland のクライアントとして動作させることが可能です。このバックエンドは clutter パッケージで有効になっています。

Clutter アプリを Wayland 上で動作させるには、環境変数 CLUTTER_BACKEND=wayland を設定する必要があります。

SDL2

SDL2 アプリケーションを Wayland 上で動作させるには、環境変数 SDL_VIDEODRIVER=wayland を設定します。

ノート: Wayland 未対応の古い SDL が内部に含まれたゲームでは、SDL_VIDEODRIVER=wayland を指定すると動作が壊れる場合があります。アプリケーションを XWayland で強制的に実行するには、SDL_VIDEODRIVER=x11 を設定します。

GLFW

GLFW で Wayland バックエンドを使用するには、(glfw-x11 の代わりに) glfw-wayland パッケージをインストールしてください。

GLEW

glew-wayland^AUR パッケージは現在のところ、多くの GLEW ベースのアプリケーションでまだ動作しませんので、唯一の選択肢は Xwayland で glew を使うことです。FS#62713 を参照してください。

EFL

EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland のプロジェクトページを見て下さい。

winit

Winit は Rust で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、明示的に設定することもできます。WINIT_UNIX_BACKEND 環境変数の値を x11 や wayland としてください。

Electron

electron ベースのアプリケーションを Wayland でネイティブに使用するには、${XDG_CONFIG_HOME}/electron-flags.conf を作成または編集して、次のオプションを追加します。

~/.config/electron-flags.conf

--enable-features=UseOzonePlatform
--ozone-platform=wayland

古いバージョンの electron には独自の electron-flags.conf ファイルが必要であることに注意してください。electron12 パッケージがインストールされている場合は、次のようにします。

$ ln -s electron-flags.conf ~/.config/electron12-flags.conf

${XDG_CONFIG_HOME} 内にコピーしてください、または、異なる electron バージョンで異なるランタイムオプションを使用したい場合は、別の ${XDG_CONFIG_HOME}/electron12-flags.conf ファイルを使用する必要があります。

ヒント: Electron-flags をグローバルに上書きする代わりに、デスクトップエントリを変更するとよいでしょう。

Java

Java プラットフォームのオープンソース実装である OpenJDK は、まだ Wayland のネイティブサポートを備えていません。 OpenJDK に Wayland を実装することを目的としたプロジェクトである Wakefield が実用できるようになるまで、XWayland を使用して下さい。

XWayland

XWayland は、Wayland の下で実行される X サーバーです。レガシー X11 アプリケーションに下位互換性を提供します。

これを使用するには、xorg-xwayland パッケージをインストールします。

XWaylandはコンポジターを介して開始されるため、選択したコンポジターを使用して、XWayland の互換性と XWayland の開始方法の説明を確認して下さい。

ノート: セキュリティについて: XWayland は X サーバーであるため、 Wayland のセキュリティ機能はありません。

NVIDIA ドライバ

ノート: バージョン 470 より前の Nvidia ドライバ(例: nvidia-390xx-dkms^AUR) はハードウェアアクセラレーションされた XWayland をサポートしておらず、Wayland 以外のアプリケーションで Wayland セッションのパフォーマンスが低下します。

なお、DRM KMS を有効にする必要があります。また、お使いのディスプレイマネージャ(例: GDM)の公式ドキュメントに記載されている情報も見てください。

ヒントとテクニック

Kwin Wayland デバッグコンソール

kwin を使用している場合、以下を実行すると、どのウィンドウが Xwayland とネイティブ Wayland を使用しているか、表面、入力イベント、クリップボードの内容などを確認することができます。

$ qdbus org.kde.KWin /KWin org.kde.KWin.showDebugConsole

Xwayland アプリケーションであることを視認する

アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、extramaus^AUR を使用します。アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが Xwayland 経由で実行されています。

または、xorg-xeyes を使用して、アプリケーションウィンドウ上でマウスポインタを移動するときに、目が動いているかどうかで確認することもできます。

キーボードのリマップ

Wayland のセキュリティ・モデルでは、コンポジター以外のプログラムがキーボード入力を取得することを禁止しています。いくつかのコンポジターはキーのリマップをサポートしていますが (例えば mutter から gnome-tweaks まで)、多くのコンポジターにはありません。evremap^AUR, evdevremapkeys-git^AUR, kbct-git^AUR プログラムはコンポジターの前にキーボードを取得して、変更したキーボード入力を渡すことでこれを回避しています。

トラブルシューティング

色補正

バックライト#色補正を参照。

動作が遅い、表示がおかしい、クラッシュする

Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に CLUTTER_PAINT=disable-clipped-redraws:disable-culling が設定されている可能性があります。/etc/environment などの rc ファイルから該当箇所を削除してみてください。

Electron ベースのアプリケーションでは、ディスプレイ::0を開けません

GDK_BACKEND = wayland を設定していないことを確認してください。グローバルに設定すると、 Electron アプリが機能しなくなります。

リモートディスプレイ

いくつか選択肢が考えられます:

Sway など wlroots ベースのコンポジタでは wayvnc^AUR VNC サーバーが利用できます。
Weston には RDP バックエンドが含まれています。weston-rdp(7) を参照してください。
mutter ベースの場合は gnome-remote-desktop が使えます。公式サイトを参照してください。
waypipe^AUR や waypipe-git^AUR は Wayland アプリケーションの透過プロキシです。SSH を組み合わせることで外部から操作できます。詳細は公式サイトを参照してください。

ゲームやリモートデスクトップ、仮想マシンウィンドウでの入力

Xorg と異なり、Wayland では入力デバイスを独占 (グラブ) することができません。キーボードショートカットやポインタデバイスをアプリケーションウィンドウに渡すのは Wayland コンポジタの役目となっています。

入力グラブが変わったことで以下のように既存のアプリケーションで問題が発生します:

ホットキーや修飾キーがコンポジタによって認識されてしまい、リモートデスクトップや仮想マシンのウィンドウに送信されなくなります。
マウスポインタがアプリケーションウィンドウに制限されなくなるため、仮想マシンやリモートデスクトップのウィンドウ内のマウスポインタの位置がホスト環境のマウスポインタとずれるようになります。

Wayland と XWayland にプロトコル拡張を追加することで解決を図っていますが、Wayland コンポジタが拡張をサポートしている必要があり、ネイティブの Wayland クライアントの場合、ウィジェットツールキット (例: GTK, Qt) やアプリケーション自身が拡張に対応していなければなりません。X上で動作するアプリケーションの場合、対応は不要です。

GTK テーマが動かない

https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland を参照してください。

NVIDIA モジュールを読み込まないようにする

sway などの Wayland コンポジターを起動する前に __EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/50_mesa.json を環境変数として追加します。

参照