Wayland

関連記事

• カーネルモード設定
• Xorg
• スクリーンショットの取得#Wayland

Wayland はディスプレイサーバープロトコルです。X Window System の後継となることを目指しています。Wikipedia に Wayland と Xorg の比較 が掲載されています。

Wayland プロトコルを使用するディスプレイサーバは、コンポジット型ウィンドウマネージャ としても機能するため、コンポジタ と呼ばれます。以下にWayland コンポジタのリストを示します。

ネイティブな X11 アプリケーションをシームレスに動かすための後方互換性として、Xwayland を使うことができます。これは Wayland に X サーバを提供します。

要件

ほとんどの Wayland コンポジタは、カーネルモード設定を利用しているシステムでのみ動作します。Wayland それ自体はグラフィカルな環境を提供しません。ゆえに、Wayland に加えてコンポジタ (以下のセクションを参照)、あるいは、コンポジタを含むデスクトップ環境 (例: GNOME、Plasma) が必要となります。

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

コンポジタ

タイル型 と スタック型 の違いは、ウィンドウマネージャ#種類 を参照してください。

タイル型

• Cagebreak — cage をベースに、ratpoison にインスパイアされています。

https://github.com/project-repo/cagebreak || cagebreak^AUR

• dwl — wlroots ベースの dwm ライクな Wayland コンポジタ。

https://codeberg.org/dwl/dwl || dwl^AUR

• Hyprland — 見た目を犠牲にしないダイナミックタイル型 Wayland コンポジタ。

https://hyprland.org || hyprland

• japokwm — wlroots ベースの、レイアウト作成を中心とした動的な Wayland タイリングコンポジタ。

https://github.com/werererer/japokwm || japokwm-git^AUR

• miracle-wm — Canonical の Mir をベースとした Wayland のタイル型コンポジタ。

https://github.com/mattkae/miracle-wm || パッケージが存在しないか AUR で検索

• niri — スクロール可能なタイル型 Wayland コンポジタ。

https://github.com/YaLTeR/niri/ || niri

• Polonium — KDE 6 上でタイル型ウィンドウを使用できる、Bismuth の後継。

https://github.com/zeroxoneafour/polonium || kwin-polonium^AUR

• Qtile — Python で記述および設定されたフル機能のハッキング可能なタイリングウィンドウマネージャーと Wayland コンポジタ。

https://github.com/qtile/qtile || qtile

• river — dwm と bspwm にインスパイアされた動的なタイル型 Wayland コンポジタ。

https://codeberg.org/river/river || river

• Sway — wlroots ベースの i3 互換 Wayland コンポジタ。

https://github.com/swaywm/sway || sway

• SwayFx — 魅力的な視覚効果機能を追加した Sway。

https://github.com/WillPower3309/swayfx || swayfx^AUR

• Velox — swc ベースのシンプルなウィンドウマネージャです。dwm と xmonad の影響を受けています。

https://github.com/michaelforney/velox || velox-git^AUR

• Vivarium — wlroots を使用するダイナミックタイル型 Wayland コンポジタ。xmonad にインスパイアされたデスクトップセマンティクスを持ちます。

https://github.com/inclement/vivarium || vivarium-git^AUR

スタック型

• Enlightenment — Enlightenment

Enlightenment#手動 を参照してください。詳細: [2] [3] || https://www.enlightenment.org/

• hikari — FreeBSD で活発に開発されている cwm にインスパイアされた wlroots ベースのコンポジタ。Linux もサポートしています。

https://hikari.acmelabs.space/ || hikari^AUR

• KDE KWin — KDE#Plasma の起動 を参照。

https://userbase.kde.org/KWin || kwin

• Liri Shell — Liri の一部、しかし、QtQuick と QtCompositor を使って Wayland 用のコンポジタとして作られています。

https://github.com/lirios/shell || liri-shell-git^AUR

• labwc — Openbox にインスパイアされた wlroots ベースのコンポジタ。

https://github.com/labwc/labwc || labwc-git^AUR

• Mutter — GNOME#GNOME の起動 を参照。

https://gitlab.gnome.org/GNOME/mutter || mutter

• wayfire — Compiz にインスパイアされ、wlroots に基づく 3D コンポジタ。

https://wayfire.org/ || wayfire^AUR

• Weston — 正しさ、信頼性、予測可能性、性能のために設計された Wayland コンポジタ。

https://gitlab.freedesktop.org/wayland/weston || weston

• wio — Plan 9 のリオデスクトップのルックアンドフィールを複製することを目的とする wlroots ベースのコンポジタ。

https://gitlab.com/Rubo/wio || wio-wl^AUR

その他

• Cage — キオスクのような単一のフルスクリーンアプリケーションを表示します。

https://www.hjdskes.nl/projects/cage/ || cage

• nwg-shell — Sway と Hyprland Wayland コンポジタのための GTK ベースシェル。

https://github.com/nwg-piotr/nwg-shell || nwg-shell

• kiwmi — 完全にプログラミング可能な Wayland コンポジタ。

https://github.com/buffet/kiwmi || kiwmi-git^AUR

• phoc — モバイル端末のための wlroots ベースの小さなコンポジタ。

https://gitlab.gnome.org/World/Phosh/phoc || phoc

上記のいくつかは ディスプレイマネージャ をサポートする場合があります。 それらがどのように開始されるかを /usr/share/wayland-sessions/compositor.desktop を見て確認してください。

ディスプレイマネージャ

Wayland コンポジタの実行をサポートしているディスプレイマネージャは以下の表の通りです。

名前	それ自体は Wayland で動作するか?	説明
emptty	No	TTY で動作するシンプルな CLI ディスプレイマネージャ。
GDM	Yes	GNOME ディスプレイマネージャ。
greetd	Wayland の greeter を使用した場合	最小でありながら柔軟なログインデーモン。
lemurs	No	Rust で書かれた TUI ディスプレイマネージャ。
LightDM	No	様々なデスクトップに対応したディスプレイマネージャ。
Ly	No	C で書かれた TUI ディスプレイマネージャ。
SDDM	Yes	QML ベースのディスプレイマネージャ。
tbsm	No	bash のみに依存するシンプルな CLI セッションランチャー。
uwsmAUR	No	Systemd のメカニズムを使用するスタンドアローンなコンポジタのための、セッションと XDG autostart のマネージャ。

Xwayland

Xwayland は、Wayland の下で実行される X サーバーで、Wayland サポートをまだ提供していないネイティブな X11 アプリケーションに互換性を提供します。これを使用するには、xorg-xwayland パッケージをインストールします。

Xwayland はコンポジタを介して開始されるため、あなたの使用しているコンポジタのドキュメントを読み、Xwayland との互換性についてや、Xwayland の起動方法に関する指示を確認しておく必要があります。

ノート:

• セキュリティ: Xwayland は X サーバーであるため、 Wayland のセキュリティ機能はありません。
• パフォーマンス: Xwayland は X11 とほぼ同等のパフォーマンスを発揮します。しかし、一部のケースで (特に NVIDIA カード上で) パフォーマンスの低下を感じるかもしれません。
• 互換性: Xwayland は X11 と完全な後方互換性があるわけではありません。一部のアプリケーションは Xwayland 下では正しく動作しない場合があります。

NVIDIA ドライバ

ノート: バージョン 470 より前の Nvidia ドライバ(例: nvidia-390xx-dkms^AUR) はハードウェア支援のある Xwayland をサポートしておらず、非 Wayland ネイティブなアプリケーションは Wayland セッションでのパフォーマンスが低下します。

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

Kwin Wayland デバッグコンソール

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

$ qdbus6 org.kde.KWin /KWin org.kde.KWin.showDebugConsole

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

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

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

他の方法として、(xorg-xwininfo の) xwininfo をターミナルウィンドウで実行するというものがあります。Xwayland ウィンドウ上にマウスポインタをホバーすると、マウスポインタが + マークに変わります。ウィンドウをクリックすると、xwininfo は情報を表示して終了しますが、ネイティブな Wayland ウィンドウでは何も起こりません。Ctrl+C を押すことで xwininfo を終了できます。

あるいは、xlsclients (xorg-xlsclients パッケージ) を使用することもできます。Xwayland で動作中のアプリケーションを全てリストアップするには、xlsclients -l を実行してください。

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 パッケージをインストールしてください。これで、Qt アプリケーションは Wayland セッション上では Wayland で動作するようになります。

必須ではないはずですが、明示的に Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[4] にあるように、-platform wayland を使用するか、環境変数 QT_QPA_PLATFORM=wayland をセットして下さい。

一方、Wayland セッション上で X11 を使用させるには、QT_QPA_PLATFORM=xcb と設定してください。これは、zoom^AUR など、システムの 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 に対するサポートがあります。XDG_SESSION_TYPE が wayland に設定されていて、かつアプリケーションの開発者が特定のバックエンドを使用するようにしていなければ、Wayland バックエンドが使用されます。

詳細は GLFW のソースコードを参照してください。

GLEW

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

EFL

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

winit

Winit は Rust で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、環境変数を設定することで Xwayland を使うように上書きすることができます:

• バージョン 0.29.2 より前の場合、WINIT_UNIX_BACKEND=x11 を設定してください。
• バージョン 0.29.2 以降の場合、WAYLAND_DISPLAY を unset してください。そうすることで、強制的に DISPLAY 変数を使用して X にフォールバックされます。[7]

Electron

Wayland サポートを有効化する方法は次の2つです: アプリケーションごとのコマンドラインフラグを使って有効化するか、設定ファイルを使ってグローバルに有効化するかです。

アプリケーションがどの electron バージョンを使用しているか確認する方法については [8] を見てください。

ノート: Plasma では、一部の Electron アプリケーションで間違ったアイコン (デフォルトの Wayland アイコン) がウィンドウに表示され、一方タスクバーには正しいアイコンが表示されることがあります。この問題は、デスクトップファイルの名前を強制する特殊なアプリケーション/ウィンドウルールを作成することで解決できます。

環境変数

Electron 28 及びそれ以降を使用するアプリケーションは、環境変数 ELECTRON_OZONE_PLATFORM_HINT を auto または wayland に設定することで、Wayland モードを使用することができます。

コマンドラインフラグは、この環境変数より優先されます。

コマンドラインフラグ

Electron がベースとしている Chromium とは異なり、Electron アプリケーションはデフォルトで PipeWire による WebRTC 画面共有を有効化しません。なので、Wayland 上で画面共有の問題を防ぐために --enable-features=WebRTCPipeWireCapturer を使用することが推奨されます。画面共有は xdg-desktop-portal をベースとしています。

環境変数を使うことが望ましくない、または不可能である場合に、electron ベースのアプリケーションを Wayland でネイティブに使用するには、Electron 20 以降では --ozone-platform-hint=auto フラグを使用することで可能です。

トップバーが消失してしまう場合、--enable-features=WaylandWindowDecorations フラグを使用することで解決します。これは、典型的には GNOME で必須です (electron17 からsパオートされています)。

これらのフラグを永続的に設定する方法は2つあります。1つ目は、アプリケーションの .desktop ファイルを変更して Exec= 行の末尾にフラグを追加する方法。もう一つは、以下で説明している設定ファイルを使用する方法で、こちらはよりきれいに設定できます。

ノート: 一部のアプリケーションは、Electron に対してフラグを渡さないため、そのアプリケーションの開発者が解決策を実装する必要があります。

設定ファイル

Electron 系のパッケージは ~/.config/electronXX-flags.conf を読み込みます。ここで、XX は Electron のバージョンです。該当するバージョンのファイルが存在しない場合、~/.config/electron-flags.conf を代わりに読み込みます。

前述のフラグを一行ずつ書き込んでください:

~/.config/electron-flags.conf

--enable-features=WaylandWindowDecorations
--ozone-platform-hint=auto

ノート: このような設定ファイルは、公式リポジトリ内の Electron のパッケージと、それらの設定ファイルを使用するパッケージでのみ機能します。slack-desktop^AUR などのような Electron の独自のビルドをバンドルしているパッケージでは機能しません。slack-electron^AUR のように代替のパッケージが存在する場合があります。

古い 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)、ydotool(1) を参照。
• wtype (wtype) - Wayland 用 xdotool type。wtype(1) を参照。
• keyboard - Windows と Linux で動作する Python ライブラリ。実験的な OS X サポートあり。mouse ライブラリも参照。
• wlrctl (wlrctl^AUR) - 雑多な 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 バックエンドは削除されました [9]。
• mutter はコンパイル時にリモートデスクトップが有効化されています。詳細は [10] と gnome-remote-desktop を見てください。
• krfb は kwin に VNC サーバを提供します。krfb-virtualmonitor を使えば、他のデバイスを外部モニタとしてセットアップすることが可能です。
• 2013年に FreeRDP が Weston にマージされました。コンパイルフラグで有効化されています。weston パッケージは、バージョン 6.0.0 より、FreeRDP が有効化されています。
• waypipe^AUR (や waypipe-git^AUR) は 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
  • KDE#Wayland で X11 のショートカットが衝突する
  • Keyboard shortcuts inhibit

サポートしているウィジェットツールキット:

• 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

翻訳ステータス: このページは en:Wayland の翻訳バージョンです。最後の翻訳日は 2024-08-24 です。もし英語版に 変更 があれば、翻訳の同期を手伝うことができます。