「Wayland」の版間の差分

2024年3月22日 (金) 10:04時点における最新版

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

newm — ラップトップとタッチパッドを念頭に置いて作成された Wayland コンポジタ (現在、メンテナンスされていません)。

https://github.com/jbuchermn/newm/ || newm-git^AUR

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

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

Polonium — Bismuth のフォークであり、後継。KDE のためのタイル型ウィンドウマネージャ。

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

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

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

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

https://github.com/ifreund/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^AUR

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^AUR	No	TTY で動作するシンプルな CLI ディスプレイマネージャ。
GDM	Yes	GNOME ディスプレイマネージャ。
greetd	Wayland の greeter を使用した場合	最小でありながら柔軟なログインデーモン。
lemurs^AUR	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 の起動方法に関する指示を確認しておく必要があります。

ノート:

セキュリティ: 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 を使用しているか、表面、入力イベント、クリップボードの内容などを確認することができます。

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

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

アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、extramaus^AUR を使用します。アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが 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 パッケージをインストールしてください。これで、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 に対してフラグを渡さないため、そのアプリケーションの開発者が解決策を実装する必要があります。

設定ファイル

ファイル ${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 のパッケージと、それらの設定ファイルを使用するパッケージでのみ機能します。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)、ydotoold(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 によってサポートされています。

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年半ばにマージされました。

参照

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

@@ 1行目: / 1行目: @@
 [[Category:グラフィカルユーザーインターフェイス]]
-[[es:Wayland]]
 [[en:Wayland]]
-[[fr:Wayland]]
+[[es:Wayland]]
+[[pt:Wayland]]
 [[ru:Wayland]]
 [[zh-hans:Wayland]]
 {{Related articles start}}
-{{Related|Kernel Mode Setting}}
+{{Related|カーネルモード設定}}
 {{Related|Xorg}}
-{{Related|Mir}}
+{{Related|スクリーンショットの取得#Wayland}}
-{{Related|カーソルテーマ}}
 {{Related articles end}}
-'''Wayland''' は Linux の新しいウィンドウプロトコルです。[[GNOME]] や [[KDE]] などの主要な Linux デスクトップは Wayland に対応しており、"Weston" という名前のコンポジタのリファレンス実装も存在します。Wayland で昔の X11 アプリケーションを動作させるための互換レイヤーとして [https://wayland.freedesktop.org/xserver.html XWayland] があります。
+[https://wayland.freedesktop.org/ Wayland] はディスプレイサーバープロトコルです。[[Xorg|X Window System]] の後継となることを目指しています。[[Wikipedia:Wayland_(display_server_protocol)#Differences_between_Wayland_and_X|Wikipedia に Wayland と Xorg の比較]] が掲載されています。
-== 要件 ==
-今のところ Wayland は [[KMS]] を利用しているシステムでしか動作できません。
+Wayland プロトコルを使用するディスプレイサーバは、[[Wikipedia:ja:コンポジット型ウィンドウマネージャ|コンポジット型ウィンドウマネージャ]] としても機能するため、'''コンポジタ''' と呼ばれます。以下に[[#コンポジタ|Wayland コンポジタのリスト]]を示します。
-また、Wayland はただのライブラリなので、それだけでは使い物になりません。X サーバーを置き換えるには、([[#Weston|Weston]] や [[Sway]] などの) コンポジタあるいは ([[GNOME]] や [[KDE]] など) デスクトップ環境が必要です。
+ネイティブな X11 アプリケーションをシームレスに動かすための後方互換性として、[[#Xwayland|Xwayland]] を使うことができます。これは Wayland に X サーバを提供します。
+== 要件 ==
+ほとんどの Wayland コンポジタは、[[カーネルモード設定]]を利用しているシステムでのみ動作します。Wayland それ自体はグラフィカルな環境を提供しません。ゆえに、Wayland に加えてコンポジタ (以下のセクションを参照)、あるいは、コンポジタを含むデスクトップ環境 (例: [[GNOME]]、[[Plasma]]) が必要となります。
-=== バッファ API のサポート ===
-GPU ドライバーと Wayland コンポジタは同一のバッファ API に対応している場合に互換性があります。主要な API は2つ存在します: [[Wikipedia:Generic Buffer Management|GBM]] と [https://www.phoronix.com/scan.php?page=news_item&px=XDC2016-Device-Memory-API EGLStreams] です。
+GPU ドライバと Wayland コンポジタは、同一のバッファ API に対応している場合に互換性があります。主要な API は2つ存在します: [[Wikipedia:Generic Buffer Management|GBM]] と [https://www.phoronix.com/scan.php?page=news_item&px=XDC2016-Device-Memory-API EGLStreams] です。
 {| class="wikitable"
@@ 26行目: / 27行目: @@
 ! バッファ API !! GPU ドライバーのサポート !! Wayland コンポジタのサポート
 |-
-| GBM || [[NVIDIA]] 以外の全てのドライバー || 全てのコンポジタ
+| GBM || [[NVIDIA]] < 495* 以外の全てのドライバー || 全て
 |-
-| EGLStreams || [[NVIDIA]] || [[GNOME]], [[KDE]] ([https://www.phoronix.com/scan.php?page=news_item&px=EGLStreams-Merged-KWin-5.16 Plasma 5.16+])
+| EGLStreams || [[NVIDIA]] || [[GNOME]]
 |-
 |}
+: * Nvidia ≥ 495 は EGLStreams と GBM の両方をサポートします。[https://www.phoronix.com/scan.php?page=news_item&px=NVIDIA-495.44-Linux-Driver]
-== Weston ==
-Weston は Wayland コンポジタのリファレンス実装です。
+NVIDIA が GBM のサポートを導入して以来、NVIDIA ≥ 495 で多くのコンポジタ (Mutter と KWin を含む) がデフォルトで GBM を使用し始めました。GBM は一般的にベターでより幅広いサポートがあると考えられています。EGLStreams がサポートされていた理由は、NVIDIA GPU をプロプライエタリドライバで Wayland 下で使用する代替の方法を NVIDIA が提供しなかったからだけです。さらに、GBM が NVIDIA に導入された後、KWin は [https://invent.kde.org/plasma/kwin/-/merge_requests/1638 EGLStreams のサポートを打ち切りました]。
-=== インストール ===
-{{pkg|weston}} パッケージをインストールしてください。
+人気なデスクトップ環境/コンポジタと、NVIDIA によってまだサポートされている GPU を使用している場合、おそらくすでに GBM バックエンドを使用しています。確認するには、次を実行してください: {{ic|journalctl -b 0 --grep "renderer for"}}。GBM をバックエンドとして強制的に使用させるには、次の[[環境変数]]を設定してください:
-=== 使用方法 ===
-Weston をインストールしたのなら Wayland をテストする環境が整っているはずです。
+ GBM_BACKEND=nvidia-drm
-起動中の X セッションの中で Weston を実行することができます:
+ __GLX_VENDOR_LIBRARY_NAME=nvidia
- $ weston
+== コンポジタ ==
-もしくは、Weston をネイティブで起動するには、端末を切り替えて次を実行して見て下さい:
- $ weston-launch
+'''タイル型''' と '''スタック型''' の違いは、[[ウィンドウマネージャ#種類]] を参照してください。
-Weston の TTY からデモを実行できます。ターミナルエミュレータを起動するには:
- $ weston-terminal
+=== タイル型 ===
-画面に花を散らすには:
- $ weston-flower
+* {{App|[[Cagebreak]]|cage をベースに、[[ratpoison]] にインスパイアされています。|https://github.com/project-repo/cagebreak|{{AUR|cagebreak}}}}
-画像を表示するには:
+* {{App|dwl|wlroots ベースの [[dwm]] ライクな Wayland コンポジタ。|https://codeberg.org/dwl/dwl|{{AUR|dwl}}}}
- $ weston-image image1.jpg image2.jpg...
+* {{App|[[Hyprland]]|見た目を犠牲にしないダイナミックタイル型 Wayland コンポジタ。|https://hyprland.org|{{Pkg|hyprland}}}}
+* {{App|japokwm|wlroots ベースの、レイアウト作成を中心とした動的な Wayland タイリングコンポジタ。|https://github.com/werererer/japokwm|{{AUR|japokwm-git}}}}
+* {{App|newm|ラップトップとタッチパッドを念頭に置いて作成された Wayland コンポジタ ''(現在、メンテナンスされていません)''。|https://github.com/jbuchermn/newm/|{{AUR|newm-git}}}}
+* {{App|niri|スクロール可能なタイル型 Wayland コンポジタ。|https://github.com/YaLTeR/niri/|{{AUR|niri}}}}
+* {{App|Polonium|Bismuth のフォークであり、後継。[[KDE]] のためのタイル型ウィンドウマネージャ。|https://github.com/zeroxoneafour/polonium|{{AUR|kwin-polonium}}}}
+* {{App|[[Qtile]]|Python で記述および設定されたフル機能のハッキング可能なタイリングウィンドウマネージャーと Wayland コンポジタ。|https://github.com/qtile/qtile|{{Pkg|qtile}}}}
+* {{App|[[river]]|dwm と [[bspwm]] にインスパイアされた動的なタイル型 Wayland コンポジタ。|https://github.com/ifreund/river|{{Pkg|river}}}}
+* {{App|[[Sway]]|wlroots ベースの [[i3]] 互換 Wayland コンポジタ。|https://github.com/swaywm/sway|{{Pkg|sway}}}}
+* {{App|SwayFx|魅力的な視覚効果機能を追加した [[Sway]]。|https://github.com/WillPower3309/swayfx|{{AUR|swayfx}}}}
+* {{App|Velox|swc ベースのシンプルなウィンドウマネージャです。[[dwm]] と [[xmonad]] の影響を受けています。|https://github.com/michaelforney/velox|{{AUR|velox-git}}}}
+* {{App|Vivarium|wlroots を使用するダイナミックタイル型 Wayland コンポジタ。[[xmonad]] にインスパイアされたデスクトップセマンティクスを持ちます。|https://github.com/inclement/vivarium|{{AUR|vivarium-git}}}}
-=== 設定 ===
+=== スタック型 ===
+* {{App|[[Enlightenment]]|[[Enlightenment]]|[[Enlightenment#手動]] を参照してください。詳細: [https://git.enlightenment.org/enlightenment/enlightenment/src/branch/master/README.md] [https://www.enlightenment.org/about-wayland]|https://www.enlightenment.org/|{{Pkg|enlightenment}}}}
-キーボードレイアウト・モジュール・UI の設定ファイルの例です。詳しくは {{man|5|weston.ini}} を見て下さい。Weston の出力設定は {{ic|xorg.conf}} のモニターと多少異なります:
+* {{App|hikari|FreeBSD で活発に開発されている [[cwm]] にインスパイアされた wlroots ベースのコンポジタ。Linux もサポートしています。|https://hikari.acmelabs.space/|{{AUR|hikari}}}}
+* {{App|KDE [[w:KWin|KWin]]|[[KDE#Plasma の起動]] を参照。|https://userbase.kde.org/KWin|{{Pkg|kwin}}}}
+* {{App|Liri Shell|[[Liri]] の一部、しかし、QtQuick と QtCompositor を使って Wayland 用のコンポジタとして作られています。|https://github.com/lirios/shell|{{AUR|liri-shell-git}}}}
+* {{App|labwc|Openbox にインスパイアされた wlroots ベースのコンポジタ。|https://github.com/labwc/labwc|{{AUR|labwc-git}}}}
+* {{App|[[w:Mutter (software)|Mutter]]|[[GNOME#GNOME の起動]] を参照。|https://gitlab.gnome.org/GNOME/mutter|{{Pkg|mutter}}}}
+* {{App|wayfire|[[Compiz]] にインスパイアされ、wlroots に基づく 3D コンポジタ。|https://wayfire.org/|{{AUR|wayfire}}}}
+* {{App|[[Weston]]|正しさ、信頼性、予測可能性、性能のために設計された Wayland コンポジタ。|https://gitlab.freedesktop.org/wayland/weston|{{Pkg|weston}}}}
+* {{App|wio|Plan 9 のリオデスクトップのルックアンドフィールを複製することを目的とする wlroots ベースのコンポジタ。|https://gitlab.com/Rubo/wio|{{AUR|wio-wl}}}}
+=== その他 ===
- $ ls /sys/class/drm
- card0
- card0-VGA-1
- card1
- card1-DVI-I-1
- card1-HDMI-A-1
- card1-VGA-2
+* {{App|Cage|キオスクのような単一のフルスクリーンアプリケーションを表示します。|https://www.hjdskes.nl/projects/cage/|{{Pkg|cage}}}}
-{{ic|card0}} は使われていない内蔵ビデオアダプタです。追加アダプタ {{ic|card1}} は HDMI と DVI モニターに接続されており、出力名が {{ic|HDMI-A-1}} と {{ic|DVI-I-1}} です。
+* {{App|nwg-shell|Sway と Hyprland Wayland コンポジタのための GTK ベースシェル。|https://github.com/nwg-piotr/nwg-shell|{{AUR|nwg-shell}}}}
+* {{App|kiwmi|完全にプログラミング可能な Wayland コンポジタ。|https://github.com/buffet/kiwmi|{{AUR|kiwmi-git}}}}
+* {{App|phoc|モバイル端末のための wlroots ベースの小さなコンポジタ。|https://gitlab.gnome.org/World/Phosh/phoc|{{Pkg|phoc}}}}
+上記のいくつかは [[ディスプレイマネージャ]] をサポートする場合があります。
-{{hc|~/.config/weston.ini|<nowiki>
+それらがどのように開始されるかを {{ic|/usr/share/wayland-sessions/''compositor''.desktop}} を見て確認してください。
-[core]
-# xwayland support
-xwayland=true
+== ディスプレイマネージャ ==
-[libinput]
-enable_tap=true
+Wayland コンポジタの実行をサポートしている[[ディスプレイマネージャ]]は以下の表の通りです。
-[shell]
-background-image=/usr/share/backgrounds/gnome/Aqua.jpg
-background-color=0xff002244
-panel-color=0x90ff0000
-locking=true
-animation=zoom
-close-animation=fade
-focus-animation=dim-layer
-#binding-modifier=ctrl
-#num-workspaces=6
-### for cursor themes install xcursor-themes pkg from Extra. ###
-#cursor-theme=whiteglass
-#cursor-size=24
+{| class="wikitable sortable"
-### tablet options ###
+! 名前
-#lockscreen-icon=/usr/share/icons/gnome/256x256/actions/lock.png
+! それ自体は Wayland で動作するか?
-#lockscreen=/usr/share/backgrounds/gnome/Garden.jpg
+! 説明
-#homescreen=/usr/share/backgrounds/gnome/Blinds.jpg
+|-
-#animation=fade
+| {{AUR|emptty}}
+| {{No}}
+| TTY で動作するシンプルな CLI ディスプレイマネージャ。
+|-
+| [[GDM]]
+| {{Yes}}
+| [[GNOME]] ディスプレイマネージャ。
+|-
+| [[greetd]]
+| {{G|Wayland の greeter を使用した場合}}
+| 最小でありながら柔軟なログインデーモン。
+|-
+| {{AUR|lemurs}}
+| {{No}}
+| Rust で書かれた TUI ディスプレイマネージャ。
+|-
+| [[LightDM]]
+| {{No|https://github.com/canonical/lightdm/issues/267}}
+| 様々なデスクトップに対応したディスプレイマネージャ。
+|-
+| [[Ly]]
+| {{No}}
+| C で書かれた TUI ディスプレイマネージャ。
+|-
+| [[SDDM]]
+| {{Yes}}
+| QML ベースのディスプレイマネージャ。
+|-
+| [[tbsm]]
+| {{No}}
+| bash のみに依存するシンプルな CLI セッションランチャー。
+|}
+== Xwayland ==
-###  for Laptop displays  ###
-#[output]
-#name=LVDS1
-#mode=1680x1050
-#transform=90
+[https://wayland.freedesktop.org/xserver.html Xwayland] は、Wayland の下で実行される X サーバーで、Wayland サポートをまだ提供していないネイティブな [[X11]] アプリケーションに互換性を提供します。これを使用するには、{{Pkg|xorg-xwayland}} パッケージを[[インストール]]します。
-#[output]
-#name=VGA1
-# The following sets the mode with a modeline, you can get modelines for your preffered resolutions using the cvt utility
-#mode=173.00 1920 2048 2248 2576 1080 1083 1088 1120 -hsync +vsync
-#transform=flipped
+Xwayland はコンポジタを介して開始されるため、あなたの使用しているコンポジタのドキュメントを読み、Xwayland との互換性についてや、Xwayland の起動方法に関する指示を確認しておく必要があります。
-#[output]
-#name=X1
-#mode=1024x768
-#transform=flipped-270
+{{Note|
-[input-method]
+* セキュリティ: Xwayland は X サーバーであるため、 Wayland のセキュリティ機能はありません。
-#path=/usr/lib/weston/weston-keyboard
+* パフォーマンス: Xwayland は X11 と[https://openbenchmarking.org/result/2202053-NE-NVIDIARTX35 ほぼ同等のパフォーマンス]を発揮します。しかし、一部のケースで (特に NVIDIA カード上で) パフォーマンスの低下を感じるかもしれません。
+* 互換性: Xwayland は X11 と完全な後方互換性があるわけではありません。一部のアプリケーションは Xwayland 下では正しく動作しない場合があります。}}
+=== NVIDIA ドライバ ===
-[keyboard]
-keymap_rules=evdev
-#keymap_layout=gb,de
-#keymap_options=caps:ctrl_modifier,shift:both_capslock_cancel
-### keymap_options from /usr/share/X11/xkb/rules/base.lst ###
-numlock-on=true
+{{Note|バージョン 470 より前の Nvidia ドライバ(例: {{aur|nvidia-390xx-dkms}}) はハードウェア支援のある Xwayland をサポートしておらず、非 Wayland ネイティブなアプリケーションは Wayland セッションでのパフォーマンスが低下します。}}
-[terminal]
-#font=DroidSansMono
-#font-size=14
+なお、[[NVIDIA#DRM カーネルモード設定|DRM KMS]] を有効にする必要があります。また、お使いのディスプレイマネージャ(例: [[GDM#Wayland と独自の NVIDIA ドライバ|GDM]])の[https://download.nvidia.com/XFree86/Linux-x86_64/515.48.07/README/xwayland.html 公式ドキュメント]に記載されている情報も見てください。
-[launcher]
-icon=/usr/share/icons/gnome/24x24/apps/utilities-terminal.png
-path=/usr/bin/weston-terminal
+=== Kwin Wayland デバッグコンソール ===
-[launcher]
-icon=/usr/share/icons/gnome/24x24/apps/utilities-terminal.png
-path=/usr/bin/gnome-terminal
+{{pkg|kwin}} を使用している場合、以下を実行すると、どのウィンドウが Xwayland とネイティブ Wayland を使用しているか、表面、入力イベント、クリップボードの内容などを確認することができます。
-[launcher]
-icon=/usr/share/icons/hicolor/24x24/apps/firefox.png
-path=/usr/bin/firefox
+ $ qdbus org.kde.KWin /KWin org.kde.KWin.showDebugConsole
-[launcher]
-icon=/usr/share/weston/icon_flower.png
-path=/usr/bin/weston-flower
+=== Xwayland アプリケーションであることを視認する ===
-[screensaver]
-# Uncomment path to disable screensaver
-path=/usr/libexec/weston-screensaver
-duration=600
-</nowiki>}}
+アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、{{AUR|extramaus}} を使用します。
-最小の {{ic|weston.ini}}:
+アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが Xwayland 経由で実行されています。
-{{hc|~/.config/weston.ini|<nowiki>
-[core]
-xwayland=true
+または、{{pkg|xorg-xeyes}} を使用して、アプリケーションウィンドウ上でマウスポインタを移動するときに、目が動いているかどうかで確認することもできます。
-[keyboard]
-keymap_layout=gb
+他の方法として、({{Pkg|xorg-xwininfo}} の) ''xwininfo'' をターミナルウィンドウで実行するというものがあります。Xwayland ウィンドウ上にマウスポインタをホバーすると、マウスポインタが + マークに変わります。ウィンドウをクリックすると、xwininfo は情報を表示して終了しますが、ネイティブな Wayland ウィンドウでは何も起こりません。{{ic|Ctrl+C}} を押すことで xwininfo を終了できます。
-[output]
-name=LVDS1
-mode=1680x1050
-transform=90
+== GUI ライブラリ ==
-[launcher]
-icon=/usr/share/icons/gnome/24x24/apps/utilities-terminal.png
-path=/usr/bin/weston-terminal
+[https://wayland.freedesktop.org/toolkits.html 公式ウェブサイト] で詳細を確認してください。
-[launcher]
-icon=/usr/share/icons/hicolor/24x24/apps/firefox.png
-path=/usr/bin/firefox
-</nowiki>}}
-==== XWayland ====
+=== GTK ===
+{{Pkg|gtk3}} と {{Pkg|gtk4}} パッケージは Wayland バックエンドが有効になっています。GTK ではデフォルトで Wayland バックエンドを使いますが、[[環境変数]]を設定することで Xwayland を使うように上書きできます: {{ic|1=GDK_BACKEND=x11}}。
-{{Pkg|xorg-server-xwayland}} パッケージをインストールしてください。
+テーマの問題は [[GTK#Wayland バックエンド]] を見てください。
-Weston の中で X アプリケーションを動かすには、Xwayland を使ってリクエストを処理させます。以下の設定ファイルを作成してください:
-{{hc|~/.config/weston.ini|
-<nowiki>[core]
-xwayland=true</nowiki>
-}}
+=== Qt ===
-{{Note|X を設定していない場合、キーマップの設定が必要です: [[Xorg でのキーボード設定]]。}}
+[[Qt]] 5 または 6 で Wayland のサポートを有効化するには、Qt 5 と 6 に対してそれぞれ {{Pkg|qt5-wayland}} または {{Pkg|qt6-wayland}} パッケージをインストールしてください。これで、Qt アプリケーションは Wayland セッション上では Wayland で動作するようになります。
-==== スクリーンキャスト録画 ====
-Weston にはスクリーンキャスト機能が備わっており、{{ic|Super+r}} キーを押すことで録画を開始・停止することができます。スクリーンキャストは Weston のカレントディレクトリ内の {{ic|capture.wcap}} ファイルに保存されます。
+必須ではないはずですが、明示的に Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[https://wiki.qt.io/QtWayland#How_do_I_use_QtWayland.3F] にあるように、{{ic|1=-platform wayland}} を使用するか、[[環境変数]] {{ic|1=QT_QPA_PLATFORM=wayland}} をセットして下さい。
-WCAP ファイルは Weston 専用のロスレス動画フォーマットで、フレーム間の差異だけを記録しています。記録されたスクリーンキャストを再生するには、WCAP ファイルをメディアプレイヤーが再生できるフォーマットに変換する必要があります。まず、録画した動画を YUV ピクセル形式に変換してください:
+一方、Wayland セッション上で [[X11]] を使用させるには、{{ic|1=QT_QPA_PLATFORM=xcb}} と設定してください。これは、{{AUR|zoom}} など、システムの Qt の実装を使用しない一部のプロプライエタリアプリケーションで必要になる場合があります。
- $ wcap-decode capture.wcap --yuv4mpeg2 > capture.y4m
+また、{{ic|1=QT_QPA_PLATFORM="wayland;xcb"}} を使用すると、Qt が Wayland を利用できない場合に、代わりに xcb (X11)プラグインを使用させることができます。[https://www.qt.io/blog/2018/05/29/whats-new-in-qt-5-11-for-the-wayland-platform-plugin]
+[[sway]] などの一部のコンポジターでは、ネイティブに実行されている Qt アプリケーションの機能が不足している場合があります。たとえば、[https://keepassxc.org KeepassXC] はトレイに最小化できません。これは、アプリケーションを実行する前に {{Pkg|qt5ct}} をインストールし、{{ic|1=QT_QPA_PLATFORMTHEME=qt5ct}} を設定することで解決できます。
-作成された YUV ファイルは [[FFmpeg]] を使うことで他のフォーマットに変換できます。
-==== HiDPI ディスプレイ ====
+=== Clutter ===
-Retina または [[HiDPI]] のディスプレイでは以下を使用してください:
-{{hc|~/.config/weston.ini|<nowiki>
-[output]
-name=...
-scale=2
-</nowiki>}}
+Clutter ツールキットには Wayland バックエンドがあり、Clutter を Wayland のクライアントとして動作させることが可能です。このバックエンドは {{Pkg|clutter}} パッケージで有効になっています。
-==== シェルのフォント ====
+Clutter アプリを Wayland 上で動作させるには、環境変数 {{ic|1=CLUTTER_BACKEND=wayland}} を設定する必要があります。
-Weston はウィンドウのタイトルバーや時計などにデフォルトの sans-serif フォントを使用します。フォントを変更する方法は[[フォント設定#フォントの置き換え]]を見て下さい。
-== GUI ライブラリ ==
+=== SDL2 ===
-[https://wayland.freedesktop.org/toolkits.html 公式ウェブサイト] も参照してください。
+SDL2 アプリケーションを Wayland 上で動作させるには、{{ic|1=SDL_VIDEODRIVER=wayland}} を設定してください。
-=== GTK+ 3 ===
+{{ic|1=SDL_VIDEODRIVER="wayland,x11"}} とすることにより、Wayland が利用できない場合に代わりに X11 ビデオドライバを使用するように SDL2 を設定できます [https://wiki.libsdl.org/SDL2/FAQUsingSDL]。ウィンドウ装飾を有効化するために {{Pkg|libdecor}} をインストールすると良いかもしれません (例えば、GNOME で)。
-公式リポジトリの {{pkg|gtk3}} パッケージは Wayland バックエンドが有効になっています。
+=== GLFW ===
-Wayland と X 両方のバックエンドが有効になっているとき、GTK+ ではデフォルトで Wayland バックエンドを使いますが、{{ic|GDK_BACKEND&#61;x11}} 環境変数を設定することで Xwayland を使うように上書きできます。
+{{Pkg|glfw}} パッケージには Wayland に対するサポートがあります。{{ic|1=XDG_SESSION_TYPE}} が {{ic|1=wayland}} に設定されていて、かつアプリケーションの開発者が特定のバックエンドを使用するようにしていなければ、Wayland バックエンドが使用されます。
-{{Note|GTK+ 3.0 から、GTK+ は実行時に複数のバックエンドをサポートできるようになり、Qt の lighthouse と同じ方法でバックエンドを切り替えることができるようになりました。}}
+詳細は GLFW の[https://github.com/glfw/glfw/blob/3.4/src/platform.c#L87-L99 ソースコード]を参照してください。
-=== Qt5 ===
+=== GLEW ===
-{{Grp|qt5}} パッケージは Wayland をサポートしています。{{Pkg|qt5-wayland}} をインストールしてください。
+{{AUR|glew-wayland}} パッケージは現在のところ、多くの GLEW ベースのアプリケーションでまだ動作しませんので、唯一の選択肢は Xwayland で {{Pkg|glew}} を使うことです。{{Bug|62713}} を参照してください。
-Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[https://wiki.qt.io/QtWayland#How_do_I_use_QtWayland.3F] にあるように、{{ic|1=-platform wayland}} を使用するか、環境変数 {{ic|1=QT_QPA_PLATFORM=wayland-egl}} をセットして下さい。一方、Wayland セッション上で [[X11]] を使用させるには、{{ic|1=QT_QPA_PLATFORM=xcb}} とセットします。
-===Clutter===
+=== EFL ===
+EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland の [https://wayland.freedesktop.org/efl.html プロジェクトページ] を見て下さい。
-Clutter ツールキットには Wayland バックエンドがあり、Clutter を Wayland のクライアントとして動作させることが可能です。このバックエンドは {{Pkg|clutter}} パッケージで有効になっています。
+=== winit ===
-Clutter アプリを Wayland 上で動作させるには、環境変数 {{ic|CLUTTER_BACKEND&#61;wayland}} を設定する必要があります。
+Winit は [[Rust]] で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、環境変数を設定することで Xwayland を使うように上書きすることができます:
-===SDL===
+* バージョン 0.29.2 より前の場合、{{ic|1=WINIT_UNIX_BACKEND=x11}} を設定してください。
-SDL 2.0.2 から実験的に wayland がサポートされており、Arch Linux ではデフォルトで有効になっています。
+* バージョン 0.29.2 以降の場合、{{ic|1=WAYLAND_DISPLAY}} を unset してください。そうすることで、強制的に {{ic|1=DISPLAY}} 変数を使用して X にフォールバックされます。[https://github.com/rust-windowing/winit/blob/baf10de95843f156b0fbad6b10c3137f1ebd4f1e/src/changelog/v0.29.md?plain=1#L134]
+=== Electron ===
-SDL アプリケーションを Wayland 上で動作させるには、環境変数 {{ic|SDL_VIDEODRIVER&#61;wayland}} を設定する必要があります。
+Wayland サポートを有効化する方法は次の2つです: アプリケーションごとのコマンドラインフラグを使って有効化するか、設定ファイルを使ってグローバルに有効化するかです。
-=== GLFW ===
-GLFW で Wayland バックエンドを使用するには、({{Pkg|glfw-x11}} の代わりに) {{Pkg|glfw-wayland}} パッケージをインストールしてください。
+アプリケーションがどの electron バージョンを使用しているか確認する方法については [https://stackoverflow.com/q/50345957] を見てください。
+{{Note|Plasma では、一部の Electron アプリケーションで間違ったアイコン (デフォルトの Wayland アイコン) がウィンドウに表示され、一方タスクバーには正しいアイコンが表示されることがあります。この問題は、デスクトップファイルの名前を強制する特殊なアプリケーション/ウィンドウルールを作成することで解決できます。}}
-=== GLEW ===
+==== 環境変数 ====
-GLEW で Wayland バックエンドを使用するには、({{Pkg|glew}} の代わりに) {{Pkg|glew-wayland}} パッケージをインストールしてください。
+Electron 28 及びそれ以降を使用するアプリケーションは、[[環境変数]] [https://github.com/electron/electron/blob/main/docs/api/environment-variables.md#electron_ozone_platform_hint-linux {{ic|ELECTRON_OZONE_PLATFORM_HINT}}] を {{ic|auto}} または {{ic|wayland}} に設定することで、Wayland モードを使用することができます。
-===EFL===
+コマンドラインフラグは、この環境変数より優先されます。
-EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland の [https://wayland.freedesktop.org/efl.html プロジェクトページ] を見て下さい。
+==== コマンドラインフラグ ====
-==ウィンドウマネージャとデスクトップシェル==
+Electron がベースとしている Chromium とは異なり、Electron アプリケーションはデフォルトで PipeWire による WebRTC 画面共有を有効化しません。なので、Wayland 上で画面共有の問題を防ぐために {{ic|1=--enable-features=WebRTCPipeWireCapturer}} を使用することが推奨されます。画面共有は {{Pkg|xdg-desktop-portal}} をベースとしています。
-===GNOME===
+環境変数を使うことが望ましくない、または不可能である場合に、{{Pkg|electron}} ベースのアプリケーションを Wayland でネイティブに使用するには、Electron 20 以降では {{ic|1=--ozone-platform-hint=auto}} フラグを使用することで可能です。
-{{Warning|Gnome Wayland セッションは {{pkg|xorg-server-xwayland}} をインストールしていないと起動しません。}}
+トップバーが消失してしまう場合、{{ic|1=--enable-features=WaylandWindowDecorations}} フラグを使用することで解決します。これは、典型的には [[GNOME]] で必須です ([https://github.com/electron/electron/pull/29618 electron17] からsパオートされています)。
-バージョン 3.14 から、[[GNOME]] は Wayland を使ってデスクトップを動作させることができるようになりました。Gnome コンポジタは X を使用しなくても動かすことができ、Wayland のシステムコンポジタとして動作します。本番環境で使えるほど安定しているとされていますが、まだサポートされていない機能もいくつか存在します (Gnome のドキュメントを参照)。Gnome デスクトップでは、X を使用するアプリケーションは XWayland で動作します。
+これらのフラグを永続的に設定する方法は2つあります。1つ目は、アプリケーションの [[デスクトップエントリ#desktop ファイルの変更|.desktop ファイルを変更]]して {{ic|1=Exec=}} 行の末尾にフラグを追加する方法。もう一つは、以下で説明している設定ファイルを使用する方法で、こちらはよりきれいに設定できます。
-Gnome Wayland セッションを起動するには、GDM ログインマネージャを使用する必要があります。ログインする前に "Gnome on Wayland" セッションを選択してください。
+{{Note|一部のアプリケーションは、Electron に対してフラグを渡さないため、そのアプリケーションの開発者が解決策を実装する必要があります。}}
-===Enlightenment===
+==== 設定ファイル ====
-E19 から Wayland に対応していましたが、現在は削除されており、E20 以上が通常の利用に耐えうるほど Wayland で安定動作するとされています。詳しくは [https://www.enlightenment.org/about-wayland] を参照。
+ファイル {{ic|${XDG_CONFIG_HOME}/electron25-flags.conf}} ({{ic|${XDG_CONFIG_HOME} }} が設定されていない場合、{{ic|1=~/.config/electron25-flags.conf}} がデフォルトです) を作成/編集し、先に説明したフラグを追加してください (1行につき1オプション、空の行は無し):
-===KDE===
+{{hc|~/.config/electron25-flags.conf|2=
-[[KDE#Wayland]] を見てください。
+--enable-features=WaylandWindowDecorations
+--ozone-platform-hint=auto
+}}
+{{Note|このような設定ファイルは、公式リポジトリ内の Electron のパッケージと、それらの設定ファイルを使用するパッケージでのみ機能します。{{AUR|slack-desktop}} などのような Electron の独自のビルドをバンドルしているパッケージでは機能しません。{{AUR|slack-electron}} のように代替のパッケージが存在する場合があります。}}
-=== Loliwm ===
+==== 古い Electron バージョン ====
-[https://github.com/Cloudef/loliwm loliwm] は Wayland 用のタイル型ウィンドウマネージャです。
+{{ic|electron25-flags.conf}} は Electron バージョン 25 に対してだけ適用されます。それより古い Electron のバージョンは {{ic|electron<バージョン>-flags.conf}} ファイルで設定できます。
-=== sway ===
+古いバージョンでは、対応する Chromium バージョンによって異なるフラグが必要になる場合があります。例えば、以下のフラグは Electron 13 で機能します:
-[[Sway]] は Wayland 用の i3 互換のウィンドウマネージャです。
+{{hc|~/.config/electron13-flags.conf|2=
-=== Velox ===
+--enable-features=UseOzonePlatform
+--ozone-platform=wayland
+}}
+=== Java ===
-[[Velox]] は swc ベースのシンプルなウィンドウマネージャです。[[dwm]] と [[xmonad]] の影響を受けています。
+[[Java]] プラットフォームのオープンソース実装である OpenJDK は、まだ Wayland のネイティブサポートを備えていません。
-=== Orbital ===
+OpenJDK に Wayland を実装することを目的としたプロジェクトである [https://openjdk.java.net/projects/wakefield/ Wakefield] が実用できるようになるまでは、Xwayland を代わりに使用できます。
+[[Debian:Wayland#Java Programs (supported since OpenJDK 16?)]] を参照してください:
-[https://github.com/giucam/orbital Orbital] は Qt5 と Weston を使用する Wayland コンポジタ・シェルです。このプロジェクトではシンプルでありながら柔軟性のある見た目の良い Wayland デスクトップを作成することを目標としています。Orbital は完全装備の DE ではなく、どちらかと言えば [[Awesome]] や [[Fluxbox]] のような X11 におけるウィンドウマネージャに似ています。
+:OpenJDK 16から、JRE は (Wayland をサポートしている) GTK3 を動的にロードできるようになりました。この[https://stackoverflow.com/questions/39197208/java-gui-support-on-wayland 議論]によると、これがサポートされているかもしれません。
-=== Liri Shell ===
+:{{ic|_JAVA_AWT_WM_NONREPARENTING}} [[環境変数]]を "1" に設定することで、アプリケーションが空白の画面で起動する不具合を修正することができます。
+== ヒントとテクニック ==
-[https://github.com/lirios/shell Liri Shell] は [[Liri]] のデスクトップシェルであり、Wayland のコンポジタとして QtQuick と QtCompositor を使用して作られています。
-=== Maynard ===
+=== 自動化 ===
+* [https://github.com/ReimuNotMoe/ydotool ydotool] ({{Pkg|ydotool}}) -　汎用のコマンドラインツール (wayland 以外でも利用可能)。{{ic|ydotool.service}} [[ユーザーユニット]]を[[起動/有効化]]してください。{{man|8|ydotoold}}、{{man|1|ydotoold|url=https://github.com/ReimuNotMoe/ydotool/blob/master/manpage/ydotool.1.scd}} を参照。
-[https://github.com/raspberrypi/maynard Maynard] は GTK ベースの Weston 用デスクトップシェルクライアントです。Tiago Vignatti によるプロジェクト、weston-gtk-shell に基づいています。
+* [https://github.com/atx/wtype wtype] ({{Pkg|wtype}}) - Wayland 用 xdotool type。{{man|1|wtype}} を参照。
+* [https://github.com/boppreh/keyboard keyboard] - Windows と Linux で動作する Python ライブラリ。実験的な OS X サポートあり。[https://github.com/boppreh/mouse mouse] ライブラリも参照。
+* [https://git.sr.ht/~brocellous/wlrctl wlrctl]  ({{AUR|wlrctl}}) - 雑多な wlroots 拡張のためのコマンドラインユーティリティ (foreign-toplevel-management、virtual-keyboard、virtual-pointer をサポート)。
+=== キーボードやマウスキーのリマップ ===
-=== Motorcar ===
+[[入力リマップユーティリティ]] を見てください。
-[https://github.com/evil0sheep/motorcar Motorcar] は 3D ウィンドウを探検できる wayland コンポジタです。
+=== X11 アプリケーションで Wayland ウィンドウをスクリーンキャストする ===
-=== Way Cooler ===
-{{AUR|way-cooler}} は Rust で書かれた (Lua の設定ファイルによる) 豊富な設定を持つ Wayland コンポジタです。i3 と awesome の影響を受けています。
+[[スクリーンキャプチャ#X11 アプリケーションで Wayland ウィンドウをスクリーンキャストする]] を見てください。
-=== Maze Compositor ===
-[https://github.com/capisce/mazecompositor Maze Compositor] は 3D の Qt ベースの Wayland コンポジタです。
-=== Grefsen ===
-[https://github.com/ec1oud/grefsen Grefsen] はミニマルなデスクトップ環境を実現する Qt/Wayland コンポジタです。
 ==トラブルシューティング==
+=== 色補正 ===
-=== root でグラフィカルアプリケーションを実行 ===
+[[バックライト#色補正]]を参照。
-[[Root で X アプリケーションを起動#Wayland]] を見てください。
+=== 動作が遅い、表示がおかしい、クラッシュする ===
-=== LLVM assertion failure ===
-LLVM assertion failure になるときは、この問題が修正されるまで Gallium LLVM なしで {{Pkg|mesa}} をリビルドする必要があります。
+Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に {{ic|1=CLUTTER_PAINT=disable-clipped-redraws:disable-culling}} が設定されている可能性があります。{{ic|/etc/environment}} や rc ファイルから該当箇所を削除してみてください。
-これは LLVM を必要とするドライバを無効にしてしまう可能性があります。ハードウェアドライバに問題が発生するときは、以下の export を試して下さい:
+=== リモートディスプレイ ===
- $ export EGL_DRIVER=/usr/lib/egl/egl_gallium.so
+* ([[sway]] で使用されている) {{pkg|wlroots}} は、バージョン 0.10 より、{{Pkg|wayvnc}} を使って VNC バックエンドを提供しています。RDP バックエンドは削除されました [https://github.com/swaywm/wlroots/releases/tag/0.10.0]。
-=== 動作が遅い、表示がおかしい、クラッシュする ===
+* {{pkg|mutter}} はコンパイル時にリモートデスクトップが有効化されています。詳細は [https://wiki.gnome.org/Projects/Mutter/RemoteDesktop] と {{Pkg|gnome-remote-desktop}} を見てください。
-Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に {{ic|1=CLUTTER_PAINT=disable-clipped-redraws:disable-culling}} が設定されている可能性があります。{{ic|/etc/environment}} などの rc ファイルから該当箇所を削除してみてください。
+* {{pkg|krfb}} は {{pkg|kwin}} に VNC サーバを提供します。{{ic|krfb-virtualmonitor}} を使えば、他のデバイスを外部モニタとしてセットアップすることが可能です。
+* 2013年に FreeRDP が Weston にマージされました。コンパイルフラグで有効化されています。{{Pkg|weston}} パッケージは、バージョン 6.0.0 より、FreeRDP が有効化されています。
+* {{AUR|waypipe}} (や {{AUR|waypipe-git}}) は 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 コンポジタの役目となっています。
+Xorg と異なり、Wayland では入力デバイスを独占 (グラブ) することができません (例: [https://tronche.com/gui/x/xlib/input/XGrabKeyboard.html キーボード]、[https://tronche.com/gui/x/xlib/input/XGrabPointer.html マウス])。キーボードショートカットやポインタデバイスをアプリケーションウィンドウに渡すのは Wayland コンポジタの役目となっています。
 入力グラブが変わったことで以下のように既存のアプリケーションで問題が発生します:
 * ホットキーや修飾キーがコンポジタによって認識されてしまい、リモートデスクトップや仮想マシンのウィンドウに送信されなくなります。
 * マウスポインタがアプリケーションウィンドウに制限されなくなるため、仮想マシンやリモートデスクトップのウィンドウ内のマウスポインタの位置がホスト環境のマウスポインタとずれるようになります。
-Wayland と XWayland にプロトコル拡張を追加することで解決を図っていますが、Wayland コンポジタが拡張をサポートしている必要があり、ネイティブの Wayland クライアントの場合、ウィジェットツールキット (例: GTK, Qt) やアプリケーション自身が拡張に対応していなければなりません。
+Wayland と Xwayland にプロトコル拡張を追加することで解決を図っていますが、Wayland コンポジタが拡張をサポートしている必要があり、ネイティブの Wayland クライアントの場合、ウィジェットツールキット (例: GTK, Qt) やアプリケーション自身が拡張に対応していなければなりません。Xorg アプリケーションの場合、Xwayland のサポートで十分であるため、アプリケーションやウィジェット・ツールキットに変更を加える必要はありません。
+これらの拡張はすでに {{pkg|wayland-protocols}} に含まれており、{{pkg|xorg-xwayland}} によってサポートされています。
 関連する拡張:
-* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/xwayland-keyboard-grab/xwayland-keyboard-grab-unstable-v1.xml XWayland keyboard grabbing protocol] (XWayland のサポートは xorg-server 1.20 開発ツリーに追加されています [https://lists.x.org/archives/xorg-devel/2017-August/054231.html])
-* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/keyboard-shortcuts-inhibit/keyboard-shortcuts-inhibit-unstable-v1.xml Compositor shortcuts inhibit protocol]
+* [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/xwayland-keyboard-grab/xwayland-keyboard-grab-unstable-v1.xml Xwayland keyboard grabbing protocol]
-* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/relative-pointer/relative-pointer-unstable-v1.xml Relative pointer protocol]
+* [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/keyboard-shortcuts-inhibit/keyboard-shortcuts-inhibit-unstable-v1.xml Compositor shortcuts inhibit protocol]
-* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml Pointer constraints protocol]
+* [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/relative-pointer/relative-pointer-unstable-v1.xml Relative pointer protocol]
+* [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml Pointer constraints protocol]
 サポートしている Wayland コンポジタ:
-* Mutter, [[GNOME]] のコンポジタ ([https://bugzilla.gnome.org/show_bug.cgi?id=783342 リリース 3.28] 以上)。
+* Mutter, [[GNOME]] のコンポジタ ([https://bugzilla.gnome.org/show_bug.cgi?id=783342 リリース 3.28] 以降)。
+* wlroots (Relative pointer protocols と Pointer constraints protocol に対応)
+* Kwin
+** [[KDE#Wayland で X11 のショートカットが衝突する]]
+** [https://invent.kde.org/plasma/kwin/-/blob/master/src/wayland/keyboard_shortcuts_inhibit_v1_interface.cpp Keyboard shortcuts inhibit]
 サポートしているウィジェットツールキット:
-* GTK (リリース 3.22.18 以上)。
+* GTK (リリース 3.22.18 以降)。
-==参照==
-* [https://fedoraproject.org/wiki/How_to_debug_Wayland_problems Fedora Wiki の Wayland のデバッグに関する記事]
+=== GTK テーマが動かない ===
-* [https://bbs.archlinux.org/viewtopic.php?id=107499 Arch Linux forum discussion]
+https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland を参照してください。
+=== NVIDIA モジュールを読み込まないようにする ===
+[[sway]] などの Wayland コンポジターを起動する前に {{ic|1=__EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/50_mesa.json}} を [[環境変数]] として追加します。
+=== 拡大/サーフェススケーリング ===
+スクリーンの拡大は、まだ解決していません。[https://gitlab.freedesktop.org/wayland/wayland-protocols/-/merge_requests/145 wp-surface-scale プロトコルを提供する]プルリクエストが2022年半ばにマージされました。
+== 参照 ==
 * [https://wayland.freedesktop.org/docs/html/ Wayland オンラインドキュメント]
+* [https://gitlab.freedesktop.org/wayland 公式リポジトリ]
+* [[Fedora:How to debug Wayland problems]]
+* [https://arewewaylandyet.com/ Are we Wayland yet?]
+* [https://awesomeopensource.com/projects/wayland Awesome Wayland projects]
+* [[カーソルテーマ]]
+* [https://bbs.archlinux.org/viewtopic.php?id=107499 Arch Linux forum discussion]
+* [https://github.com/swaywm/sway/wiki/i3-Migration-Guide#common-x11-apps-used-on-i3-with-wayland-alternatives i3 Migration Guide - Common X11 apps used on i3 with Wayland alternatives]
+* [https://wayland.app/protocols/ Wayland Explorer - A better way to read Wayland documentation]
+* [https://askubuntu.com/questions/1393618/how-can-i-tell-if-an-application-is-using-xwayland How can I tell if an application is using XWayland]
+{{TranslationStatus|Wayland|2024-03-22|803938}}