Wayland
Wayland はディスプレイサーバープロトコルです。X Window System の後継となることを目指しています。Wikipedia に Wayland と Xorg の比較 が掲載されています。
Wayland プロトコルを使用するディスプレイサーバは、コンポジット型ウィンドウマネージャ としても機能するため、コンポジタ と呼ばれます。以下にWayland コンポジタのリストを示します。
ネイティブな X11 アプリケーションをシームレスに動かすための後方互換性として、Xwayland を使うことができます。これは Wayland に X サーバを提供します。
要件
ほとんどの Wayland コンポジタは、カーネルモード設定を利用しているシステムでのみ動作します。Wayland それ自体はグラフィカルな環境を提供しません。ゆえに、Wayland に加えてコンポジタ (以下のセクションを参照)、あるいは、コンポジタを含むデスクトップ環境 (例: GNOME、KDE) が必要となります。
GPU ドライバと Wayland コンポジタは、同一のバッファ API に対応している場合に互換性があります。主要な API は2つ存在します: GBM と EGLStreams です。
バッファ API | GPU ドライバーのサポート | Wayland コンポジタのサポート |
---|---|---|
GBM | NVIDIA < 495* 以外の全てのドライバー | 全て |
EGLStreams | NVIDIA | GNOME |
- * Nvidia ≥ 495 は EGLStreams と GBM の両方をサポートします。[1]
NVIDIA が GBM のサポートを導入して以来、NVIDIA ≥ 495 で多くのコンポジタ (Mutter と KWin を含む) がデフォルトで GBM を使用し始めました。GBM は一般的にベターでより幅広いサポートがあると考えられています。EGLStreams がサポートされていた理由は、NVIDIA GPU をプロプライエタリドライバで Wayland 下で使用する代替の方法を NVIDIA が提供しなかったからだけです。さらに、GBM が NVIDIA に導入された後、KWin は EGLStreams のサポートを打ち切りました。
人気なデスクトップ環境/コンポジタと、NVIDIA によってまだサポートされている GPU を使用している場合、おそらくすでに GBM バックエンドを使用しています。確認するには、次を実行してください: journalctl -b 0 --grep "renderer for"
。GBM をバックエンドとして強制的に使用させるには、次の環境変数を設定してください:
GBM_BACKEND=nvidia-drm __GLX_VENDOR_LIBRARY_NAME=nvidia
コンポジタ
タイル型 と スタック型 の違いは、ウィンドウマネージャ#種類 を参照してください。
タイル型
- dwl — wlroots ベースの dwm ライクな Wayland コンポジタ。
- Hyprland — 見た目を犠牲にしないダイナミックタイル型 Wayland コンポジタ。
- japokwm — wlroots ベースの、レイアウト作成を中心とした動的な Wayland タイリングコンポジタ。
- newm — ラップトップとタッチパッドを念頭に置いて作成された Wayland コンポジタ (現在、メンテナンスされていません)。
- niri — スクロール可能なタイル型 Wayland コンポジタ。
- Polonium — Bismuth のフォークであり、後継。KDE のためのタイル型ウィンドウマネージャ。
- Qtile — Python で記述および設定されたフル機能のハッキング可能なタイリングウィンドウマネージャーと Wayland コンポジタ。
- SwayFx — 魅力的な視覚効果機能を追加した Sway。
- Vivarium — wlroots を使用するダイナミックタイル型 Wayland コンポジタ。xmonad にインスパイアされたデスクトップセマンティクスを持ちます。
スタック型
- Enlightenment#手動 を参照してください。詳細: [2] [3] || https://www.enlightenment.org/
- hikari — FreeBSD で活発に開発されている cwm にインスパイアされた wlroots ベースのコンポジタ。Linux もサポートしています。
- KDE KWin — KDE#Plasma の起動 を参照。
- Liri Shell — Liri の一部、しかし、QtQuick と QtCompositor を使って Wayland 用のコンポジタとして作られています。
- labwc — Openbox にインスパイアされた wlroots ベースのコンポジタ。
- Mutter — GNOME#GNOME の起動 を参照。
- wayfire — Compiz にインスパイアされ、wlroots に基づく 3D コンポジタ。
- https://wayfire.org/ || wayfireAUR
- Weston — 正しさ、信頼性、予測可能性、性能のために設計された Wayland コンポジタ。
- wio — Plan 9 のリオデスクトップのルックアンドフィールを複製することを目的とする wlroots ベースのコンポジタ。
その他
- Cage — キオスクのような単一のフルスクリーンアプリケーションを表示します。
- nwg-shell — Sway と Hyprland Wayland コンポジタのための GTK ベースシェル。
- kiwmi — 完全にプログラミング可能な Wayland コンポジタ。
- phoc — モバイル端末のための wlroots ベースの小さなコンポジタ。
上記のいくつかは ディスプレイマネージャ をサポートする場合があります。
それらがどのように開始されるかを /usr/share/wayland-sessions/compositor.desktop
を見て確認してください。
ディスプレイマネージャ
Wayland コンポジタの実行をサポートしているディスプレイマネージャは以下の表の通りです。
名前 | それ自体は Wayland で動作するか? | 説明 |
---|---|---|
empttyAUR | No | TTY で動作するシンプルな CLI ディスプレイマネージャ。 |
GDM | Yes | GNOME ディスプレイマネージャ。 |
greetd | Wayland の greeter を使用した場合 | 最小でありながら柔軟なログインデーモン。 |
lemursAUR | No | Rust で書かれた TUI ディスプレイマネージャ。 |
LightDM | No | 様々なデスクトップに対応したディスプレイマネージャ。 |
Ly | No | C で書かれた TUI ディスプレイマネージャ。 |
SDDM | Yes | QML ベースのディスプレイマネージャ。 |
tbsm | No | bash のみに依存するシンプルな CLI セッションランチャー。 |
Xwayland
Xwayland は、Wayland の下で実行される X サーバーで、Wayland サポートをまだ提供していないネイティブな X11 アプリケーションに互換性を提供します。これを使用するには、xorg-xwayland パッケージをインストールします。
Xwayland はコンポジタを介して開始されるため、あなたの使用しているコンポジタのドキュメントを読み、Xwayland との互換性についてや、Xwayland の起動方法に関する指示を確認しておく必要があります。
NVIDIA ドライバ
なお、DRM KMS を有効にする必要があります。また、お使いのディスプレイマネージャ(例: GDM)の公式ドキュメントに記載されている情報も見てください。
Kwin Wayland デバッグコンソール
kwin を使用している場合、以下を実行すると、どのウィンドウが Xwayland とネイティブ Wayland を使用しているか、表面、入力イベント、クリップボードの内容などを確認することができます。
$ qdbus org.kde.KWin /KWin org.kde.KWin.showDebugConsole
Xwayland アプリケーションであることを視認する
アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、extramausAUR を使用します。 アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが Xwayland 経由で実行されています。
または、xorg-xeyes を使用して、アプリケーションウィンドウ上でマウスポインタを移動するときに、目が動いているかどうかで確認することもできます。
他の方法として、(xorg-xwininfo の) xwininfo をターミナルウィンドウで実行するというものがあります。Xwayland ウィンドウ上にマウスポインタをホバーすると、マウスポインタが + マークに変わります。ウィンドウをクリックすると、xwininfo は情報を表示して終了しますが、ネイティブな Wayland ウィンドウでは何も起こりません。Ctrl+C
を押すことで xwininfo を終了できます。
GUI ライブラリ
公式ウェブサイト で詳細を確認してください。
GTK
gtk3 と gtk4 パッケージは Wayland バックエンドが有効になっています。GTK ではデフォルトで Wayland バックエンドを使いますが、環境変数を設定することで Xwayland を使うように上書きできます: GDK_BACKEND=x11
。
テーマの問題は GTK#Wayland バックエンド を見てください。
Qt
Qt 5 または 6 で Wayland のサポートを有効化するには、Qt 5 と 6 に対してそれぞれ qt5-wayland または qt6-wayland パッケージをインストールしてください。
Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[4] にあるように、-platform wayland
を使用するか、環境変数 QT_QPA_PLATFORM=wayland
をセットして下さい。一方、Wayland セッション上で X11 を使用させるには、QT_QPA_PLATFORM=xcb
と設定してください。
これは、zoomAUR など、システムの Qt の実装を使用しない一部のプロプライエタリアプリケーションで必要になる場合があります。
また、QT_QPA_PLATFORM="wayland;xcb"
を使用すると、Qt が Wayland を利用できない場合に、代わりに xcb (X11)プラグインを使用させることができます。[5]
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
を設定してください。
SDL_VIDEODRIVER="wayland,x11"
とすることにより、Wayland が利用できない場合に代わりに X11 ビデオドライバを使用するように SDL2 を設定できます [6]。ウィンドウ装飾を有効化するために libdecor をインストールすると良いかもしれません (例えば、GNOME で)。
GLFW
GLFW で Wayland バックエンドを使用するには、(glfw-x11 ではなく) glfw-wayland パッケージをインストールしてください。
GLEW
glew-waylandAUR パッケージは現在のところ、多くの GLEW ベースのアプリケーションでまだ動作しませんので、唯一の選択肢は Xwayland で glew を使うことです。FS#62713 を参照してください。
EFL
EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland の プロジェクトページ を見て下さい。
winit
Winit は Rust で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、環境変数を設定することで Xwayland を使うように上書きすることができます: WINIT_UNIX_BACKEND=x11
。
Electron
Wayland サポートを有効化する方法は次の2つです: アプリケーションごとのコマンドラインフラグを使って有効化するか、設定ファイルを使ってグローバルに有効化するかです。
アプリケーションがどの electron バージョンを使用しているか確認する方法については [7] を見てください。
環境変数
Electron 28 及びそれ以降を使用するアプリケーションは、環境変数 ELECTRON_OZONE_PLATFORM_HINT
を auto
または wayland
に設定することで、Wayland モードを使用することができます。
コマンドラインフラグは、この環境変数より優先されます。
コマンドラインフラグ
Wayland で electron ベースのアプリケーションをネイティブに使用するには、次のフラグをアプリケーションの exec コマンドラインに追加する必要があります (Electron 20 の場合): --ozone-platform-hint=auto
。
トップバーが消失する問題は、追加で次のフラグを使用することで解決できます: --enable-features=WaylandWindowDecorations
。このフラグは通常、GNOME (electron17 より対応) で必要となります。
Wayland での electon 画面キャプチャの問題を解決するには --enable-webrtc-pipewire-capturer
を使用してください。このキャプチャは xdg-desktop-portal をベースにしています。
コマンドラインフラグの設定は、例えば .desktop ファイルを変更し、Exec=
行の最後にフラグを追加することで可能です。
設定ファイル
ファイル ${XDG_CONFIG_HOME}/electron25-flags.conf
(${XDG_CONFIG_HOME}
が設定されていない場合、~/.config/electron25-flags.conf
がデフォルトです) を作成/編集し、先に説明したフラグを追加してください (1行につき1オプション、空の行は無し):
~/.config/electron25-flags.conf
--enable-features=WaylandWindowDecorations --ozone-platform-hint=auto
古い Electron バージョン
electron25-flags.conf
は Electron バージョン 25 に対してだけ適用されます。それより古い Electron のバージョンは electron<バージョン>-flags.conf
ファイルで設定できます。
古いバージョンでは、対応する Chromium バージョンによって異なるフラグが必要になる場合があります。例えば、以下のフラグは Electron 13 で機能します:
~/.config/electron13-flags.conf
--enable-features=UseOzonePlatform --ozone-platform=wayland
Java
Java プラットフォームのオープンソース実装である OpenJDK は、まだ Wayland のネイティブサポートを備えていません。 OpenJDK に Wayland を実装することを目的としたプロジェクトである Wakefield が実用できるようになるまでは、Xwayland を代わりに使用できます。
Debian:Wayland#Java Programs (supported since OpenJDK 16?) を参照してください:
- OpenJDK 16から、JRE は (Wayland をサポートしている) GTK3 を動的にロードできるようになりました。この議論によると、これがサポートされているかもしれません。
_JAVA_AWT_WM_NONREPARENTING
環境変数を "1" に設定することで、アプリケーションが空白の画面で起動する不具合を修正することができます。
ヒントとテクニック
自動化
- ydotool (ydotool) - 汎用のコマンドラインツール (wayland 以外でも利用可能)。
ydotool.service
ユーザーユニットを起動/有効化してください。ydotoold(8)、ydotoold(1) を参照。 - wtype (wtype) - Wayland 用 xdotool type。wtype(1) を参照。
- keyboard - Windows と Linux で動作する Python ライブラリ。実験的な OS X サポートあり。mouse ライブラリも参照。
- wlrctl (wlrctlAUR) - 雑多な wlroots 拡張のためのコマンドラインユーティリティ (foreign-toplevel-management、virtual-keyboard、virtual-pointer をサポート)。
キーボードやマウスキーのリマップ
入力リマップユーティリティ を見てください。
X11 アプリケーションで Wayland ウィンドウをスクリーンキャストする
スクリーンキャプチャ#X11 アプリケーションで Wayland ウィンドウをスクリーンキャストする を見てください。
トラブルシューティング
色補正
バックライト#色補正を参照。
動作が遅い、表示がおかしい、クラッシュする
Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に CLUTTER_PAINT=disable-clipped-redraws:disable-culling
が設定されている可能性があります。/etc/environment
や rc ファイルから該当箇所を削除してみてください。
リモートディスプレイ
- (sway で使用されている) wlroots は、バージョン 0.10 より、wayvnc を使って VNC バックエンドを提供しています。RDP バックエンドは削除されました [8]。
- mutter はコンパイル時にリモートデスクトップが有効化されています。詳細は [9] と gnome-remote-desktop を見てください。
- krfb は kwin に VNC サーバを提供します。
krfb-virtualmonitor
を使えば、他のデバイスを外部モニタとしてセットアップすることが可能です。 - 2013年に FreeRDP が Weston にマージされました。コンパイルフラグで有効化されています。weston パッケージは、バージョン 6.0.0 より、FreeRDP が有効化されています。
- waypipeAUR (や waypipe-gitAUR) は Wayland アプリケーションの透過プロキシです。SSH 上で動作するラッパーコマンドあり。
- 以下は、Plasma デスクトップでリモートの KDE kcalc を起動する例です:
$ waypipe ssh example.local env QT_QPA_PLATFORM=wayland-egl QT_QPA_PLATFORMTHEME=KDE dbus-launch kcalc
ゲームやリモートデスクトップ、仮想マシンウィンドウでの入力捕捉
Xorg と異なり、Wayland では入力デバイスを独占 (グラブ) することができません (例: キーボード、マウス)。キーボードショートカットやポインタデバイスをアプリケーションウィンドウに渡すのは Wayland コンポジタの役目となっています。
入力グラブが変わったことで以下のように既存のアプリケーションで問題が発生します:
- ホットキーや修飾キーがコンポジタによって認識されてしまい、リモートデスクトップや仮想マシンのウィンドウに送信されなくなります。
- マウスポインタがアプリケーションウィンドウに制限されなくなるため、仮想マシンやリモートデスクトップのウィンドウ内のマウスポインタの位置がホスト環境のマウスポインタとずれるようになります。
Wayland と Xwayland にプロトコル拡張を追加することで解決を図っていますが、Wayland コンポジタが拡張をサポートしている必要があり、ネイティブの Wayland クライアントの場合、ウィジェットツールキット (例: GTK, Qt) やアプリケーション自身が拡張に対応していなければなりません。Xorg アプリケーションの場合、Xwayland のサポートで十分であるため、アプリケーションやウィジェット・ツールキットに変更を加える必要はありません。
これらの拡張はすでに wayland-protocols に含まれており、xorg-xwayland によってサポートされています。
関連する拡張:
- Xwayland keyboard grabbing protocol
- Compositor shortcuts inhibit protocol
- Relative pointer protocol
- Pointer constraints protocol
サポートしている Wayland コンポジタ:
- Mutter, GNOME のコンポジタ (リリース 3.28 以降)。
- wlroots (Relative pointer protocols と Pointer constraints protocol に対応)
- Kwin
サポートしているウィジェットツールキット:
- GTK (リリース 3.22.18 以降)。
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
を 環境変数 として追加します。
拡大/サーフェススケーリング
スクリーンの拡大は、まだ解決していません。wp-surface-scale プロトコルを提供するプルリクエストが2022年半ばにマージされました。
参照
- Wayland オンラインドキュメント
- 公式リポジトリ
- Fedora:How to debug Wayland problems
- Are we Wayland yet?
- Awesome Wayland projects
- カーソルテーマ
- Arch Linux forum discussion
- i3 Migration Guide - Common X11 apps used on i3 with Wayland alternatives
- Wayland Explorer - A better way to read Wayland documentation
- How can I tell if an application is using XWayland