「Hyprland」の版間の差分

2023年11月12日 (日) 00:34時点における版

Hyprland は C++ で書かれた wlroots ベースのタイリング Wayland コンポジターです。Hyprland の特筆すべき点は、ダイナミックタイリング、タブ付きウィンドウ、クリーンで読みやすい C++ コードベース、ウィンドウアニメーションや角丸、透明ウィンドウでの Dual-Kawase Blur を提供するカスタムレンダラーなどです。一般的な使い方や設定方法は、 Hyprland Wiki に詳しく書かれています。

インストール

次のいずれかをインストールします:

hyprland - 最新のアップストリームリリース。
hyprland-git^AUR - master ブランチへの最新のコミット。
hyprland-nvidia^AUR - NVIDIA GPU パッチを含む最新のアップストリームリリース。

Hyprland は、wlroots-git^AUR に厳密に従う独自のバージョンの wlroots をバンドルしています。これにより、安定性が向上すると同時に、他の wlroots ベースのコンポジターとの依存関係の競合も回避されます。

ノート:

NVIDIA GPU ユーザーは、Hyprland を起動する前に、upstream Wiki のNVIDIA専用ページにも必ず従ってください。これを怠ると、ログインできない、ウィンドウが点滅する、CPU使用率が高いなど、多くのバグが発生する可能性があります。
Hyprland での NVIDIA GPU の使用はサポートされていません。問題が起きても全て自己責任でお願いします。

設定

ノート: リストされているオプションのほとんど (およびその他) は、Wiki の変数ページで詳しく説明されています。

設定は 1 つの設定ファイル、hyprland.conf を通して行われます。パッケージマネージャで Hyprland をインストールした場合、おそらく /usr/share/hyprland/hyprland.conf にあります。ソースからインストールした場合は、Hyprland をクローンしたレポジトリにあります。hyprland.conf を ~/.config/hypr/hyprland.conf にコピーしてください。

hyprland.conf には、デバイス (モニタ、キーボード、マウス、トラックパッド) を設定するディレクティブと、アニメーション、装飾、レイアウトなどの設定が含まれています。キーバインディングやウィンドウのルールを設定したり、コマンドを実行したりできます (一度だけ、あるいはコンフィグが再読み込みされるたびに)

ファイルを更新するたびに設定が自動的にリロードされます。同じ効果を得るために hyprctl reload を使うこともできます。いくつかの設定(特に入力設定)については、Hyprland セッションを再起動する必要があるかもしれません。

設定は hyprctl を使用してその場で変更することもできますが、保存されません。

使用方法

起動

現在、Hyprland は TTY から起動することを推奨しています。

$ Hyprland

ディスプレイマネージャからの起動は公式にはサポートされていませんが、GDM、SDDM、その他からの起動に成功したとの報告があります。全ての Hyprland AUR パッケージは自動的にディスプレイマネージャーエントリーを生成します。ソースから手動でインストールする場合、ソースコードの example ディレクトリに Hyprland.desktop ファイルのサンプルがあります、これを /usr/share/wayland-sessions/ にコピーしてディスプレイマネージャーのエントリーを提供することができます。

どちらの方法でも、いくつかの環境変数やサービスを追加したり削除したりすることで、同じ結果を得ることができます

自動ログイン

ディスプレイマネージャまたはシェルからユーザーは自動的にログインできます。

hyprctl と IPC

hyprctl は Hyprland にインストールされている、ディスプレイサーバーと通信するためのコマンドライン・ユーティリティです。サーバーにコマンドを送ったり (設定ファイルのコマンドと同じですが、構文が少し違います)、キーワードを設定したり、クエリを送ったり、情報を要求したりすることができます。full documentation を参照してください。

Hyprland は 2 つの UNIX ソケットも公開しており、コードやコマンドライン・ユーティリティを使って Hyprland の情報を制御・取得することができます。これらのソケットはフォーカスの変更 (ウィンドウ、ワークスペース、モニター) やウィンドウ/ワークスペースの作成などのイベントをブロードキャストします。

hyprctl と IPC ソケットは、複雑なタスクのために Hyprland を制御するスクリプトの中で効果的に使うことができます。

画面共有

Screensharing も参照してください。

wlroots ベースのコンポジタである Hyprland は、xdg-desktop-portal-wlr を利用して xdg-desktop-portal 経由で様々なアプリケーションをスクリーンキャプチャすることができます。

また、Hyprland は xdg-desktop-portal-hyprland も保守しています。これは、wlr ポータルのフォークであり、領域共有 (2022-12-12 の時点で壊れています)、ウィンドウ共有、グラフィカルな選択ユーティリティなどの機能が追加されています。このポータルの使い方は Hyprland wiki で詳しく説明されています。

ノート: xdg-desktop-portal-wlr と xdg-desktop-portal-hyprland の両方とも、Hyprland で他のポータル実装と競合することが知られています。インストールされている場合は、xdg-desktop-portal-kde、xdg-desktop-portal-gnome、または xdg-desktop-portal-lxqt を削除することをお勧めします。

トラブルシューティング

NVIDIAカードでのちらつきについて

これは NVIDIA の既知の問題です。代わりに hyprland-nvidia^AUR や hyprland-nvidia-git^AUR を使えばより良い体験ができます。

xdg-desktop-portal-hyprland が大量の CPU を使用する

これは既知のバグ [1] であり、最新の Git ビルドでは解決されているはずです。これを回避するには、こちら Hyprland wiki で説明されているように、スクリプトを hyprland.conf ファイルで呼び出すことで回避できます。

参照

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

@@ 22行目: / 22行目: @@
 * Hyprland での NVIDIA GPU の使用はサポートされていません。問題が起きても全て自己責任でお願いします。
 }}
+== 設定 ==
+{{Note|リストされているオプションのほとんど (およびその他) は、[https://wiki.hyprland.org/Cconfiguring/Variables/upstream Wiki] の変数ページで詳しく説明されています。}}
+設定は 1 つの設定ファイル、[https://github.com/vaxerski/Hyprland/blob/main/example/hyprland.conf hyprland.conf] を通して行われます。パッケージマネージャで Hyprland をインストールした場合、おそらく /usr/share/hyprland/hyprland.conf にあります。ソースからインストールした場合は、Hyprland をクローンしたレポジトリにあります。hyprland.conf を {{ic|~/.config/hypr/hyprland.conf}} にコピーしてください。
+{{ic|hyprland.conf}} には、デバイス (モニタ、キーボード、マウス、トラックパッド) を設定するディレクティブと、アニメーション、装飾、レイアウトなどの設定が含まれています。キーバインディングやウィンドウのルールを設定したり、コマンドを実行したりできます (一度だけ、あるいはコンフィグが再読み込みされるたびに)
+ファイルを更新するたびに設定が自動的にリロードされます。同じ効果を得るために {{ic|hyprctl reload}} を使うこともできます。いくつかの設定(特に入力設定)については、Hyprland セッションを再起動する必要があるかもしれません。
+設定は {{ic|hyprctl}} を使用してその場で変更することもできますが、保存されません。
 == 使用方法 ==
@@ 46行目: / 58行目: @@
 ''hyprctl'' と IPC ソケットは、複雑なタスクのために Hyprland を制御するスクリプトの中で効果的に使うことができます。
-== 設定 ==
-設定は 1 つの設定ファイル、[https://github.com/vaxerski/Hyprland/blob/main/example/hyprland.conf hyprland.conf] を通して行われます。パッケージマネージャで Hyprland をインストールした場合、おそらく /usr/share/hyprland/hyprland.conf にあります。ソースからインストールした場合は、Hyprland をクローンしたレポジトリにあります。hyprland.conf を {{ic|~/.config/hypr/hyprland.conf}} にコピーしてください。
-{{ic|hyprland.conf}} には、デバイス (モニタ、キーボード、マウス、トラックパッド) を設定するディレクティブと、アニメーション、装飾、レイアウトなどの設定が含まれています。キーバインディングやウィンドウのルールを設定したり、コマンドを実行したりできます (一度だけ、あるいはコンフィグが再読み込みされるたびに)。
-ファイルを更新するたびに設定が自動的にリロードされます。同じ効果を得るために {{ic|hyprctl reload}} を使うこともできます。いくつかの設定(特に入力設定)については、Hyprland セッションを再起動する必要があるかもしれません。
-設定は {{ic|hyprctl}} を使用してその場で変更することもできますが、保存されません。
-設定方法は [https://github.com/vaxerski/Hyprland/wiki Hyprland wiki] に記載されています。
 == 画面共有 ==