「Wayland」の版間の差分
(→要件: 英語版に追従) |
(→コンポジタ: 同期) |
||
(6人の利用者による、間の135版が非表示) | |||
1行目: | 1行目: | ||
[[Category:グラフィカルユーザーインターフェイス]] |
[[Category:グラフィカルユーザーインターフェイス]] |
||
− | [[es:Wayland]] |
||
[[en:Wayland]] |
[[en:Wayland]] |
||
− | [[ |
+ | [[es:Wayland]] |
[[pt:Wayland]] |
[[pt:Wayland]] |
||
[[ru:Wayland]] |
[[ru:Wayland]] |
||
[[zh-hans:Wayland]] |
[[zh-hans:Wayland]] |
||
{{Related articles start}} |
{{Related articles start}} |
||
− | {{Related| |
+ | {{Related|カーネルモード設定}} |
{{Related|Xorg}} |
{{Related|Xorg}} |
||
− | {{Related|スクリーンショットの取得}} |
+ | {{Related|スクリーンショットの取得#Wayland}} |
{{Related articles end}} |
{{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 プロトコルを使用するディスプレイサーバは、[[Wikipedia:ja:コンポジット型ウィンドウマネージャ|コンポジット型ウィンドウマネージャ]] としても機能するため、'''コンポジタ''' と呼ばれます。以下に[[#コンポジタ|Wayland コンポジタのリスト]]を示します。 |
||
+ | |||
+ | ネイティブな X11 アプリケーションをシームレスに動かすための後方互換性として、[[#Xwayland|Xwayland]] を使うことができます。これは Wayland に X サーバを提供します。 |
||
== 要件 == |
== 要件 == |
||
− | ほとんどの Wayland コンポジタは [[KMS]] を利用しているシステムで動作します。 |
||
+ | ほとんどの Wayland コンポジタは、[[カーネルモード設定]]を利用しているシステムでのみ動作します。Wayland それ自体はグラフィカルな環境を提供しません。ゆえに、Wayland に加えてコンポジタ (以下のセクションを参照)、あるいは、コンポジタを含むデスクトップ環境 (例: [[GNOME]]、[[Plasma]]) が必要となります。 |
||
− | また、Wayland はただのライブラリなので、それだけでは使い物になりません。X サーバーを置き換えるには、([[Weston]] や [[Sway]] などの) コンポジタあるいは ([[GNOME]] や [[KDE]] など) デスクトップ環境が必要です。 |
||
− | GPU ドライバ |
+ | 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" |
{| class="wikitable" |
||
− | |- |
||
! バッファ API !! GPU ドライバーのサポート !! Wayland コンポジタのサポート |
! バッファ 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] |
||
− | == GUI ライブラリ == |
||
− | [https://wayland.freedesktop.org/toolkits.html 公式ウェブサイト] も参照してください。 |
||
+ | 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 のサポートを打ち切りました]。 |
||
− | === GTK+ 3 === |
||
+ | 人気なデスクトップ環境/コンポジタと、NVIDIA によってまだサポートされている GPU を使用している場合、おそらくすでに GBM バックエンドを使用しています。確認するには、次を実行してください: {{ic|journalctl -b 0 --grep "renderer for"}}。GBM をバックエンドとして強制的に使用させるには、次の[[環境変数]]を設定してください: |
||
− | 公式リポジトリの {{pkg|gtk3}} パッケージは Wayland バックエンドが有効になっています。 |
||
+ | GBM_BACKEND=nvidia-drm |
||
− | Wayland と X 両方のバックエンドが有効になっているとき、GTK+ ではデフォルトで Wayland バックエンドを使いますが、{{ic|GDK_BACKEND=x11}} 環境変数を設定することで Xwayland を使うように上書きできます。 |
||
+ | __GLX_VENDOR_LIBRARY_NAME=nvidia |
||
+ | == コンポジタ == |
||
− | {{Note|GTK+ 3.0 から、GTK+ は実行時に複数のバックエンドをサポートできるようになり、Qt の lighthouse と同じ方法でバックエンドを切り替えることができるようになりました。}} |
||
+ | '''タイル型''', '''スタック型''', '''ダイナミック型''' の違いについては、[[ウィンドウマネージャ#種類]] を参照してください。 |
||
− | === Qt5 === |
||
+ | === スタック型 === |
||
− | {{Grp|qt5}} パッケージは Wayland をサポートしています。{{Pkg|qt5-wayland}} をインストールしてください。 |
||
+ | * {{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}}}} |
||
− | 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}} とセットします。 |
||
+ | * {{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}}}} |
||
− | === |
+ | === タイル型 === |
+ | * {{App|[[Cagebreak]]|cage をベースに、[[ratpoison]] にインスパイアされています。|https://github.com/project-repo/cagebreak|{{AUR|cagebreak}}}} |
||
− | Clutter ツールキットには Wayland バックエンドがあり、Clutter を Wayland のクライアントとして動作させることが可能です。このバックエンドは {{Pkg|clutter}} パッケージで有効になっています。 |
||
+ | * {{App|niri|スクロール可能なタイル型 Wayland コンポジタ。|https://github.com/YaLTeR/niri/|{{Pkg|niri}}}} |
||
+ | * {{App|Polonium|[[KDE]] 6 上でタイル型ウィンドウを使用できる、Bismuth の後継。|https://github.com/zeroxoneafour/polonium|{{AUR|kwin-polonium}}}} |
||
+ | * {{App|[[Qtile]]|Python で記述および設定されたフル機能のハッキング可能なタイリングウィンドウマネージャーと Wayland コンポジタ。|https://github.com/qtile/qtile|{{Pkg|qtile}}}} |
||
+ | * {{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}}}} |
||
+ | === ダイナミック型 === |
||
− | Clutter アプリを Wayland 上で動作させるには、環境変数 {{ic|CLUTTER_BACKEND=wayland}} を設定する必要があります。 |
||
+ | * {{App|[[dwl]]|wlroots ベースの [[dwm]] ライクな Wayland コンポジタ。|https://codeberg.org/dwl/dwl|{{AUR|dwl}}}} |
||
− | ===SDL=== |
||
+ | * {{App|[[Hyprland]]|見た目を犠牲にしないダイナミックなタイリング Wayland コンポジタ。|https://hyprland.org|{{Pkg|hyprland}}}} |
||
+ | * {{App|japokwm|wlroots ベースの、レイアウト作成を中心とした動的な Wayland タイリングコンポジタ。|https://github.com/werererer/japokwm|{{AUR|japokwm-git}}}} |
||
+ | * {{App|[[river]]|dwm と [[bspwm]] にインスパイアされた動的なタイル型 Wayland コンポジタ。|https://codeberg.org/river/river|{{Pkg|river}}}} |
||
+ | * {{App|Vivarium|wlroots を使用するダイナミックタイル型 Wayland コンポジタ。[[xmonad]] にインスパイアされたデスクトップセマンティクスを持ちます。|https://github.com/inclement/vivarium|{{AUR|vivarium-git}}}} |
||
+ | === その他 === |
||
− | SDL アプリケーションを Wayland 上で動作させるには、環境変数 {{ic|SDL_VIDEODRIVER=wayland}} を設定する必要があります。一方、XWayland を使うようにするには、{{ic|1=SDL_VIDEODRIVER=x11}} を指定します。 |
||
+ | * {{App|Cage|キオスクのような単一のフルスクリーンアプリケーションを表示します。|https://www.hjdskes.nl/projects/cage/|{{Pkg|cage}}}} |
||
− | {{Note|Wayland 未対応の古い SDL が内部に含まれたゲームでは、{{ic|1=SDL_VIDEODRIVER=wayland}} を指定すると動作が壊れる場合があります。}} |
||
+ | * {{App|nwg-shell|Sway と Hyprland Wayland コンポジタのための GTK ベースシェル。|https://github.com/nwg-piotr/nwg-shell|{{Pkg|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}}}} |
||
+ | 上記のいくつかは [[ディスプレイマネージャ]] をサポートする場合があります。 |
||
− | === GLFW === |
||
+ | それらがどのように開始されるかを {{ic|/usr/share/wayland-sessions/''compositor''.desktop}} を見て確認してください。 |
||
− | |||
− | GLFW で Wayland バックエンドを使用するには、({{Pkg|glfw-x11}} の代わりに) {{Pkg|glfw-wayland}} パッケージをインストールしてください。 |
||
− | |||
− | === GLEW === |
||
− | |||
− | GLEW で Wayland バックエンドを使用するには、({{Pkg|glew}} の代わりに) {{Pkg|glew-wayland}} パッケージをインストールしてください。 |
||
− | |||
− | ===EFL=== |
||
− | |||
− | EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland の [https://wayland.freedesktop.org/efl.html プロジェクトページ] を見て下さい。 |
||
− | |||
− | === winit === |
||
− | |||
− | [https://github.com/rust-windowing/winit Winit] は [[Rust]] で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、明示的に設定することもできます。{{ic|XINIT_UNIX_BACKEND}} 環境変数の値を {{ic|x11}} や {{ic|wayland}} としてください。 |
||
== ディスプレイマネージャ == |
== ディスプレイマネージャ == |
||
− | Wayland コンポジタの実行をサポートし |
+ | Wayland コンポジタの実行をサポートしている[[ディスプレイマネージャ]]は以下の表の通りです。 |
{| class="wikitable sortable" |
{| class="wikitable sortable" |
||
! 名前 |
! 名前 |
||
+ | ! それ自体は Wayland で動作するか? |
||
− | ! 種類 |
||
! 説明 |
! 説明 |
||
+ | |- |
||
+ | | {{Pkg|emptty}} |
||
+ | | {{No}} |
||
+ | | TTY で動作するシンプルな CLI ディスプレイマネージャ。 |
||
|- |
|- |
||
| [[GDM]] |
| [[GDM]] |
||
+ | | {{Yes}} |
||
− | | Wayland/X11 上で動作 |
||
| [[GNOME]] ディスプレイマネージャ。 |
| [[GNOME]] ディスプレイマネージャ。 |
||
|- |
|- |
||
− | | |
+ | | [[greetd]] |
+ | | {{G|Wayland の greeter を使用した場合}} |
||
− | | ログインデーモン |
||
| 最小でありながら柔軟なログインデーモン。 |
| 最小でありながら柔軟なログインデーモン。 |
||
+ | |- |
||
+ | | {{Pkg|lemurs}} |
||
+ | | {{No}} |
||
+ | | Rust で書かれた TUI ディスプレイマネージャ。 |
||
|- |
|- |
||
| [[LightDM]] |
| [[LightDM]] |
||
− | | |
+ | | {{No|https://github.com/canonical/lightdm/issues/267}} |
| 様々なデスクトップに対応したディスプレイマネージャ。 |
| 様々なデスクトップに対応したディスプレイマネージャ。 |
||
|- |
|- |
||
− | | |
+ | | [[Ly]] |
+ | | {{No}} |
||
− | | コンソール上で動作 |
||
− | | TUI ディスプレイマネージャ。 |
+ | | C で書かれた TUI ディスプレイマネージャ。 |
|- |
|- |
||
| [[SDDM]] |
| [[SDDM]] |
||
+ | | {{Yes}} |
||
− | | X11 上で動作 [https://github.com/sddm/sddm/pull/616] |
||
| QML ベースのディスプレイマネージャ。 |
| QML ベースのディスプレイマネージャ。 |
||
|- |
|- |
||
− | | |
+ | | [[tbsm]] |
+ | | {{No}} |
||
− | | コンソール上で動作 |
||
| bash のみに依存するシンプルな CLI セッションランチャー。 |
| bash のみに依存するシンプルな CLI セッションランチャー。 |
||
+ | |- |
||
+ | | {{AUR|uwsm}} |
||
+ | | {{No}} |
||
+ | | Systemd のメカニズムを使用するスタンドアローンなコンポジタのための、セッションと XDG autostart のマネージャ。 |
||
|} |
|} |
||
+ | == Xwayland == |
||
− | ==ウィンドウマネージャとデスクトップシェル== |
||
+ | [https://wayland.freedesktop.org/xserver.html Xwayland] は、Wayland の下で実行される X サーバーで、Wayland サポートをまだ提供していないネイティブな [[X11]] アプリケーションに互換性を提供します。これを使用するには、{{Pkg|xorg-xwayland}} パッケージを[[インストール]]します。 |
||
− | ===GNOME=== |
||
+ | Xwayland はコンポジタを介して開始されるため、あなたの使用しているコンポジタのドキュメントを読み、Xwayland との互換性についてや、Xwayland の起動方法に関する指示を確認しておく必要があります。 |
||
− | {{Warning|Gnome Wayland セッションは {{pkg|xorg-server-xwayland}} をインストールしていないと起動しません。}} |
||
+ | {{Note| |
||
− | バージョン 3.14 から、[[GNOME]] は Wayland を使ってデスクトップを動作させることができるようになりました。Gnome コンポジタは X を使用しなくても動かすことができ、Wayland のシステムコンポジタとして動作します。本番環境で使えるほど安定しているとされていますが、まだサポートされていない機能もいくつか存在します (Gnome のドキュメントを参照)。Gnome デスクトップでは、X を使用するアプリケーションは XWayland で動作します。 |
||
+ | * セキュリティ: Xwayland は X サーバーであるため、 Wayland のセキュリティ機能はありません。 |
||
+ | * パフォーマンス: Xwayland は X11 と[https://openbenchmarking.org/result/2202053-NE-NVIDIARTX35 ほぼ同等のパフォーマンス]を発揮します。しかし、一部のケースで (特に NVIDIA カード上で) パフォーマンスの低下を感じるかもしれません。 |
||
+ | * 互換性: Xwayland は X11 と完全な後方互換性があるわけではありません。一部のアプリケーションは Xwayland 下では正しく動作しない場合があります。}} |
||
+ | === NVIDIA ドライバ === |
||
− | Gnome Wayland セッションを起動するには、GDM ログインマネージャを使用する必要があります。ログインする前に "Gnome on Wayland" セッションを選択してください。 |
||
+ | {{Note|バージョン 470 より前の Nvidia ドライバ(例: {{aur|nvidia-390xx-dkms}}) はハードウェア支援のある Xwayland をサポートしておらず、非 Wayland ネイティブなアプリケーションは Wayland セッションでのパフォーマンスが低下します。}} |
||
− | ===Enlightenment=== |
||
+ | なお、[[NVIDIA#DRM カーネルモード設定|DRM KMS]] を有効にする必要があります。また、お使いのディスプレイマネージャ(例: [[GDM#Wayland と独自の NVIDIA ドライバ|GDM]])の[https://download.nvidia.com/XFree86/Linux-x86_64/515.48.07/README/xwayland.html 公式ドキュメント]に記載されている情報も見てください。 |
||
− | E19 から Wayland に対応していましたが、現在は削除されており、E20 以上が通常の利用に耐えうるほど Wayland で安定動作するとされています。詳しくは [https://www.enlightenment.org/about-wayland] を参照。 |
||
+ | === Kwin Wayland デバッグコンソール === |
||
− | ===KDE=== |
||
+ | {{pkg|kwin}} を使用している場合、以下を実行すると、どのウィンドウが Xwayland とネイティブ Wayland を使用しているか、表面、入力イベント、クリップボードの内容などを確認することができます。 |
||
− | [[KDE#Wayland]] を見てください。 |
||
+ | $ qdbus6 org.kde.KWin /KWin org.kde.KWin.showDebugConsole |
||
− | === Loliwm === |
||
+ | === Xwayland アプリケーションであることを視認する === |
||
− | [https://github.com/Cloudef/loliwm loliwm] は Wayland 用のタイル型ウィンドウマネージャです。 |
||
+ | アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、{{AUR|extramaus}} を使用します。 |
||
− | === sway === |
||
+ | アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが Xwayland 経由で実行されています。 |
||
+ | または、{{pkg|xorg-xeyes}} を使用して、アプリケーションウィンドウ上でマウスポインタを移動するときに、目が動いているかどうかで確認することもできます。 |
||
− | [[Sway]] は Wayland 用の i3 互換のウィンドウマネージャです。 |
||
+ | 他の方法として、({{Pkg|xorg-xwininfo}} の) ''xwininfo'' をターミナルウィンドウで実行するというものがあります。Xwayland ウィンドウ上にマウスポインタをホバーすると、マウスポインタが + マークに変わります。ウィンドウをクリックすると、xwininfo は情報を表示して終了しますが、ネイティブな Wayland ウィンドウでは何も起こりません。{{ic|Ctrl+C}} を押すことで xwininfo を終了できます。 |
||
− | === Velox === |
||
+ | あるいは、''xlsclients'' ({{Pkg|xorg-xlsclients}} パッケージ) を使用することもできます。Xwayland で動作中のアプリケーションを全てリストアップするには、{{ic|xlsclients -l}} を実行してください。 |
||
− | [[Velox]] は swc ベースのシンプルなウィンドウマネージャです。[[dwm]] と [[xmonad]] の影響を受けています。 |
||
− | + | == GUI ライブラリ == |
|
+ | [https://wayland.freedesktop.org/toolkits.html 公式ウェブサイト] で詳細を確認してください。 |
||
− | [https://github.com/giucam/orbital Orbital] は Qt5 と Weston を使用する Wayland コンポジタ・シェルです。このプロジェクトではシンプルでありながら柔軟性のある見た目の良い Wayland デスクトップを作成することを目標としています。Orbital は完全装備の DE ではなく、どちらかと言えば [[Awesome]] や [[Fluxbox]] のような X11 におけるウィンドウマネージャに似ています。 |
||
− | === |
+ | === GTK === |
+ | {{Pkg|gtk3}} と {{Pkg|gtk4}} パッケージは Wayland バックエンドが有効になっています。GTK ではデフォルトで Wayland バックエンドを使いますが、[[環境変数]]を設定することで Xwayland を使うように上書きできます: {{ic|1=GDK_BACKEND=x11}}。 |
||
− | [https://github.com/lirios/shell Liri Shell] は [[Liri]] のデスクトップシェルであり、Wayland のコンポジタとして QtQuick と QtCompositor を使用して作られています。 |
||
+ | テーマの問題は [[GTK#Wayland バックエンド]] を見てください。 |
||
− | === Maynard === |
||
+ | === Qt === |
||
− | [https://github.com/raspberrypi/maynard Maynard] は GTK ベースの Weston 用デスクトップシェルクライアントです。Tiago Vignatti によるプロジェクト、weston-gtk-shell に基づいています。 |
||
+ | [[Qt]] 5 または 6 で Wayland のサポートを有効化するには、Qt 5 と 6 に対してそれぞれ {{Pkg|qt5-wayland}} または {{Pkg|qt6-wayland}} パッケージをインストールしてください。これで、Qt アプリケーションは Wayland セッション上では Wayland で動作するようになります。 |
||
− | === Motorcar === |
||
+ | 必須ではないはずですが、明示的に Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[https://wiki.qt.io/QtWayland#How_do_I_use_QtWayland.3F] にあるように、{{ic|1=-platform wayland}} を使用するか、[[環境変数]] {{ic|1=QT_QPA_PLATFORM=wayland}} をセットして下さい。 |
||
− | [https://github.com/evil0sheep/motorcar Motorcar] は 3D ウィンドウを探検できる wayland コンポジタです。 |
||
+ | 一方、Wayland セッション上で [[X11]] を使用させるには、{{ic|1=QT_QPA_PLATFORM=xcb}} と設定してください。これは、{{AUR|zoom}} など、システムの Qt の実装を使用しない一部のプロプライエタリアプリケーションで必要になる場合があります。 |
||
− | === Way Cooler === |
||
+ | また、{{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] |
||
− | {{AUR|way-cooler}} は Rust で書かれた (Lua の設定ファイルによる) 豊富な設定を持つ Wayland コンポジタです。i3 と awesome の影響を受けています。 |
||
+ | [[sway]] などの一部のコンポジターでは、ネイティブに実行されている Qt アプリケーションの機能が不足している場合があります。たとえば、[https://keepassxc.org KeepassXC] はトレイに最小化できません。これは、アプリケーションを実行する前に {{Pkg|qt5ct}} をインストールし、{{ic|1=QT_QPA_PLATFORMTHEME=qt5ct}} を設定することで解決できます。 |
||
− | === Maze Compositor === |
||
+ | === Clutter === |
||
− | [https://github.com/capisce/mazecompositor Maze Compositor] は 3D の Qt ベースの Wayland コンポジタです。 |
||
+ | Clutter ツールキットには Wayland バックエンドがあり、Clutter を Wayland のクライアントとして動作させることが可能です。このバックエンドは {{Pkg|clutter}} パッケージで有効になっています。 |
||
− | === Grefsen === |
||
+ | Clutter アプリを Wayland 上で動作させるには、環境変数 {{ic|1=CLUTTER_BACKEND=wayland}} を設定する必要があります。 |
||
− | [https://github.com/ec1oud/grefsen Grefsen] はミニマルなデスクトップ環境を実現する Qt/Wayland コンポジタです。 |
||
+ | === SDL2 === |
||
− | ==トラブルシューティング== |
||
+ | SDL2 アプリケーションを Wayland 上で動作させるには、{{ic|1=SDL_VIDEODRIVER=wayland}} を設定してください。 |
||
− | === root でグラフィカルアプリケーションを実行 === |
||
+ | {{ic|1=SDL_VIDEODRIVER="wayland,x11"}} とすることにより、Wayland が利用できない場合に代わりに X11 ビデオドライバを使用するように SDL2 を設定できます [https://wiki.libsdl.org/SDL2/FAQUsingSDL]。ウィンドウ装飾を有効化するために {{Pkg|libdecor}} をインストールすると良いかもしれません (例えば、GNOME で)。 |
||
− | [[Root で X アプリケーションを起動#Wayland]] を見てください。 |
||
− | === |
+ | === GLFW === |
− | LLVM assertion failure になるときは、この問題が修正されるまで Gallium LLVM なしで {{Pkg|mesa}} をリビルドする必要があります。 |
||
+ | {{Pkg|glfw}} パッケージには Wayland に対するサポートがあります。{{ic|1=XDG_SESSION_TYPE}} が {{ic|1=wayland}} に設定されていて、かつアプリケーションの開発者が特定のバックエンドを使用するようにしていなければ、Wayland バックエンドが使用されます。 |
||
− | これは LLVM を必要とするドライバを無効にしてしまう可能性があります。ハードウェアドライバに問題が発生するときは、以下の export を試して下さい: |
||
+ | 詳細は GLFW の[https://github.com/glfw/glfw/blob/3.4/src/platform.c#L87-L99 ソースコード]を参照してください。 |
||
− | $ export EGL_DRIVER=/usr/lib/egl/egl_gallium.so |
||
+ | |||
+ | === GLEW === |
||
+ | |||
+ | {{AUR|glew-wayland}} パッケージは現在のところ、多くの GLEW ベースのアプリケーションでまだ動作しませんので、唯一の選択肢は Xwayland で {{Pkg|glew}} を使うことです。{{Bug|62713}} を参照してください。 |
||
+ | |||
+ | === EFL === |
||
+ | |||
+ | EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland の [https://wayland.freedesktop.org/efl.html プロジェクトページ] を見て下さい。 |
||
+ | |||
+ | === winit === |
||
+ | |||
+ | Winit は [[Rust]] で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、環境変数を設定することで Xwayland を使うように上書きすることができます: |
||
+ | |||
+ | * バージョン 0.29.2 より前の場合、{{ic|1=WINIT_UNIX_BACKEND=x11}} を設定してください。 |
||
+ | * バージョン 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 === |
||
+ | |||
+ | Wayland サポートを有効化する方法は次の2つです: アプリケーションごとのコマンドラインフラグを使って有効化するか、設定ファイルを使ってグローバルに有効化するかです。 |
||
+ | |||
+ | アプリケーションがどの electron バージョンを使用しているか確認する方法については [https://stackoverflow.com/q/50345957] を見てください。 |
||
+ | |||
+ | {{Note|Plasma では、一部の Electron アプリケーションで間違ったアイコン (デフォルトの Wayland アイコン) がウィンドウに表示され、一方タスクバーには正しいアイコンが表示されることがあります。この問題は、デスクトップファイルの名前を強制する特殊なアプリケーション/ウィンドウルールを作成することで解決できます。}} |
||
+ | |||
+ | ==== 環境変数 ==== |
||
+ | |||
+ | Electron 28 及びそれ以降を使用するアプリケーションは、[[環境変数]] [https://www.electronjs.org/docs/latest/api/environment-variables#electron_ozone_platform_hint-linux ELECTRON_OZONE_PLATFORM_HINT] を {{ic|auto}} または {{ic|wayland}} に設定することで、Wayland モードを使用することができます。 |
||
+ | |||
+ | コマンドラインフラグは、この環境変数より優先されます。 |
||
+ | |||
+ | ==== コマンドラインフラグ ==== |
||
+ | |||
+ | Electron がベースとしている Chromium とは異なり、Electron アプリケーションはデフォルトで PipeWire による WebRTC 画面共有を有効化しません。なので、Wayland 上で画面共有の問題を防ぐために {{ic|1=--enable-features=WebRTCPipeWireCapturer}} を使用することが推奨されます。画面共有は {{Pkg|xdg-desktop-portal}} をベースとしています。 |
||
+ | |||
+ | 環境変数を使うことが望ましくない、または不可能である場合に、{{Pkg|electron}} ベースのアプリケーションを Wayland でネイティブに使用するには、Electron 20 以降では {{ic|1=--ozone-platform-hint=auto}} フラグを使用することで可能です。 |
||
+ | |||
+ | トップバーが消失してしまう場合、{{ic|1=--enable-features=WaylandWindowDecorations}} フラグを使用することで解決します。これは、典型的には [[GNOME]] で必須です ([https://github.com/electron/electron/pull/29618 electron17] からsパオートされています)。 |
||
+ | |||
+ | これらのフラグを永続的に設定する方法は2つあります。1つ目は、アプリケーションの [[デスクトップエントリ#desktop ファイルの変更|.desktop ファイルを変更]]して {{ic|1=Exec=}} 行の末尾にフラグを追加する方法。もう一つは、以下で説明している設定ファイルを使用する方法で、こちらはよりきれいに設定できます。 |
||
+ | |||
+ | {{Note|一部のアプリケーションは、Electron に対してフラグを渡さないため、そのアプリケーションの開発者が解決策を実装する必要があります。}} |
||
+ | |||
+ | ==== 設定ファイル ==== |
||
+ | |||
+ | Electron 系のパッケージは {{ic|1=~/.config/electron''XX''-flags.conf}} を読み込みます。ここで、''XX'' は Electron のバージョンです。該当するバージョンのファイルが存在しない場合、{{ic|1=~/.config/electron-flags.conf}} を代わりに読み込みます。 |
||
+ | |||
+ | 前述のフラグを一行ずつ書き込んでください: |
||
+ | |||
+ | {{hc|~/.config/electron-flags.conf|2= |
||
+ | --enable-features=WaylandWindowDecorations |
||
+ | --ozone-platform-hint=auto |
||
+ | }} |
||
+ | |||
+ | {{Note|このような設定ファイルは、公式リポジトリ内の Electron のパッケージと、それらの設定ファイルを使用するパッケージでのみ機能します。{{AUR|slack-desktop}} などのような Electron の独自のビルドをバンドルしているパッケージでは機能しません。{{AUR|slack-electron}} のように代替のパッケージが存在する場合があります。}} |
||
+ | |||
+ | ==== 古い Electron バージョン ==== |
||
+ | |||
+ | {{ic|electron25-flags.conf}} は Electron バージョン 25 に対してだけ適用されます。それより古い Electron のバージョンは {{ic|electron<バージョン>-flags.conf}} ファイルで設定できます。 |
||
+ | |||
+ | 古いバージョンでは、対応する Chromium バージョンによって異なるフラグが必要になる場合があります。例えば、以下のフラグは Electron 13 で機能します: |
||
+ | |||
+ | {{hc|~/.config/electron13-flags.conf|2= |
||
+ | --enable-features=UseOzonePlatform |
||
+ | --ozone-platform=wayland |
||
+ | }} |
||
+ | |||
+ | === Java === |
||
+ | |||
+ | [[Java]] プラットフォームのオープンソース実装である OpenJDK は、まだ Wayland のネイティブサポートを備えていません。 |
||
+ | OpenJDK に Wayland を実装することを目的としたプロジェクトである [https://openjdk.java.net/projects/wakefield/ Wakefield] が実用できるようになるまでは、Xwayland を代わりに使用できます。 |
||
+ | |||
+ | [[Debian:Wayland#Java Programs (supported since OpenJDK 16?)]] を参照してください: |
||
+ | |||
+ | :OpenJDK 16から、JRE は (Wayland をサポートしている) GTK3 を動的にロードできるようになりました。この[https://stackoverflow.com/questions/39197208/java-gui-support-on-wayland 議論]によると、これがサポートされているかもしれません。 |
||
+ | :{{ic|_JAVA_AWT_WM_NONREPARENTING}} [[環境変数]]を "1" に設定することで、アプリケーションが空白の画面で起動する不具合を修正することができます。 |
||
+ | |||
+ | == ヒントとテクニック == |
||
+ | |||
+ | === 自動化 === |
||
+ | |||
+ | * [https://github.com/ReimuNotMoe/ydotool ydotool] ({{Pkg|ydotool}}) - 汎用のコマンドラインツール (wayland 以外でも利用可能)。{{ic|ydotool.service}} [[ユーザーユニット]]を[[起動/有効化]]してください。{{man|8|ydotoold}}、{{man|1|ydotool|url=https://github.com/ReimuNotMoe/ydotool/blob/master/manpage/ydotool.1.scd}} を参照。 |
||
+ | * [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 をサポート)。 |
||
+ | |||
+ | === キーボードやマウスキーのリマップ === |
||
+ | |||
+ | [[入力リマップユーティリティ]] を見てください。 |
||
+ | |||
+ | === X11 アプリケーションで Wayland ウィンドウをスクリーンキャストする === |
||
+ | |||
+ | [[スクリーンキャプチャ#X11 アプリケーションで Wayland ウィンドウをスクリーンキャストする]] を見てください。 |
||
+ | |||
+ | ==トラブルシューティング== |
||
+ | === 色補正 === |
||
− | === Electronベースのアプリケーションでは、ディスプレイ::0を開けません === |
||
+ | [[バックライト#色補正]]を参照。 |
||
− | GDK_BACKEND = wayland を設定していないことを確認してください。グローバルに設定すると、 Electron アプリが機能しなくなります。 |
||
=== 動作が遅い、表示がおかしい、クラッシュする === |
=== 動作が遅い、表示がおかしい、クラッシュする === |
||
− | Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に {{ic|1=CLUTTER_PAINT=disable-clipped-redraws:disable-culling}} が設定されている可能性があります。{{ic|/etc/environment}} などの rc ファイルから該当箇所を削除してみてください。 |
||
+ | Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に {{ic|1=CLUTTER_PAINT=disable-clipped-redraws:disable-culling}} が設定されている可能性があります。{{ic|/etc/environment}} や rc ファイルから該当箇所を削除してみてください。 |
||
− | === ゲームやリモートデスクトップ、仮想マシンウィンドウでの入力 === |
||
+ | === リモートディスプレイ === |
||
− | Xorg と異なり、Wayland では入力デバイスを独占 (グラブ) することができません。キーボードショートカットやポインタデバイスをアプリケーションウィンドウに渡すのは Wayland コンポジタの役目となっています。 |
||
+ | |||
+ | * ([[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}} を見てください。 |
||
+ | * {{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 では入力デバイスを独占 (グラブ) することができません (例: [https://tronche.com/gui/x/xlib/input/XGrabKeyboard.html キーボード]、[https://tronche.com/gui/x/xlib/input/XGrabPointer.html マウス])。キーボードショートカットやポインタデバイスをアプリケーションウィンドウに渡すのは Wayland コンポジタの役目となっています。 |
||
入力グラブが変わったことで以下のように既存のアプリケーションで問題が発生します: |
入力グラブが変わったことで以下のように既存のアプリケーションで問題が発生します: |
||
+ | |||
* ホットキーや修飾キーがコンポジタによって認識されてしまい、リモートデスクトップや仮想マシンのウィンドウに送信されなくなります。 |
* ホットキーや修飾キーがコンポジタによって認識されてしまい、リモートデスクトップや仮想マシンのウィンドウに送信されなくなります。 |
||
* マウスポインタがアプリケーションウィンドウに制限されなくなるため、仮想マシンやリモートデスクトップのウィンドウ内のマウスポインタの位置がホスト環境のマウスポインタとずれるようになります。 |
* マウスポインタがアプリケーションウィンドウに制限されなくなるため、仮想マシンやリモートデスクトップのウィンドウ内のマウスポインタの位置がホスト環境のマウスポインタとずれるようになります。 |
||
− | Wayland と |
+ | 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:// |
+ | * [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/xwayland-keyboard-grab/xwayland-keyboard-grab-unstable-v1.xml Xwayland keyboard grabbing protocol] |
− | * [https:// |
+ | * [https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/unstable/keyboard-shortcuts-inhibit/keyboard-shortcuts-inhibit-unstable-v1.xml Compositor shortcuts inhibit protocol] |
− | * [https:// |
+ | * [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 コンポジタ: |
サポートしている 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://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-08-24|814878}} |
2024年9月26日 (木) 01:14時点における最新版
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
コンポジタ
タイル型, スタック型, ダイナミック型 の違いについては、ウィンドウマネージャ#種類 を参照してください。
スタック型
- 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 ベースのコンポジタ。
タイル型
- niri — スクロール可能なタイル型 Wayland コンポジタ。
- Polonium — KDE 6 上でタイル型ウィンドウを使用できる、Bismuth の後継。
- Qtile — Python で記述および設定されたフル機能のハッキング可能なタイリングウィンドウマネージャーと Wayland コンポジタ。
- SwayFx — 魅力的な視覚効果機能を追加した Sway。
ダイナミック型
- Hyprland — 見た目を犠牲にしないダイナミックなタイリング Wayland コンポジタ。
- japokwm — wlroots ベースの、レイアウト作成を中心とした動的な Wayland タイリングコンポジタ。
- Vivarium — wlroots を使用するダイナミックタイル型 Wayland コンポジタ。xmonad にインスパイアされたデスクトップセマンティクスを持ちます。
その他
- Cage — キオスクのような単一のフルスクリーンアプリケーションを表示します。
- nwg-shell — Sway と Hyprland Wayland コンポジタのための GTK ベースシェル。
- kiwmi — 完全にプログラミング可能な Wayland コンポジタ。
- phoc — モバイル端末のための wlroots ベースの小さなコンポジタ。
上記のいくつかは ディスプレイマネージャ をサポートする場合があります。
それらがどのように開始されるかを /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 の起動方法に関する指示を確認しておく必要があります。
NVIDIA ドライバ
なお、DRM KMS を有効にする必要があります。また、お使いのディスプレイマネージャ(例: GDM)の公式ドキュメントに記載されている情報も見てください。
Kwin Wayland デバッグコンソール
kwin を使用している場合、以下を実行すると、どのウィンドウが Xwayland とネイティブ Wayland を使用しているか、表面、入力イベント、クリップボードの内容などを確認することができます。
$ qdbus6 org.kde.KWin /KWin org.kde.KWin.showDebugConsole
Xwayland アプリケーションであることを視認する
アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、extramausAUR を使用します。 アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが 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
と設定してください。これは、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 に対するサポートがあります。XDG_SESSION_TYPE
が wayland
に設定されていて、かつアプリケーションの開発者が特定のバックエンドを使用するようにしていなければ、Wayland バックエンドが使用されます。
詳細は GLFW のソースコードを参照してください。
GLEW
glew-waylandAUR パッケージは現在のところ、多くの 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] を見てください。
環境変数
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 系のパッケージは ~/.config/electronXX-flags.conf
を読み込みます。ここで、XX は Electron のバージョンです。該当するバージョンのファイルが存在しない場合、~/.config/electron-flags.conf
を代わりに読み込みます。
前述のフラグを一行ずつ書き込んでください:
~/.config/electron-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)、ydotool(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 バックエンドは削除されました [9]。
- mutter はコンパイル時にリモートデスクトップが有効化されています。詳細は [10] と 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