hyprland

Hyprland ドキュメント

Hyprland Wayland コンポジターの完全なリファレンスです。https://wiki.hypr.land/ の公式 Wiki から自動生成されています。

references/ ディレクトリには、https://github.com/hyprwm/hyprland-wiki の Wiki Markdown が一切変更されずに保存されており、毎日更新されています。

使い方

1. ユーザーの質問からトピックを特定し、以下の表にある該当するリファレンスファイルを読みます。
2. それらのファイルを基に回答します。さらに詳しい情報が必要な場合は、「Live Fetching」に記載されている GitHub の raw URL から最新のドキュメントを取得します。
3. Hyprland 0.55 以降では、設定ファイルは Lua です（~/.config/hypr/hyprland.lua）：hl.config({...})、hl.bind(...)、hl.monitor({...})、hl.window_rule({...})、hl.on(...) を使用します。従来の hyprlang 形式（hyprland.conf）は非推奨です。判断に迷った場合は、hyprctl version でユーザーのバージョンを確認します。
4. Hyprland 0.54 以前では hyprlang 構文を使用し、バージョン別 Wiki（https://wiki.hypr.land/0.54.0/）を案内します（ここにあるリファレンスファイルは、現行の Lua ドキュメントを対象としています）。
5. 設定ファイルを分割する場合は、従来の source = キーワードではなく、Lua の require("subdir/file") を使用します。
6. NixOS ユーザーには、hyprpm は Nix ではサポートされていないことを伝えます。プラグインには Home Manager または NixOS モジュールを使用します。
7. トラブルシューティングでは、まず references/faq.md を確認します。

リファレンスファイル

設定

トピック	ファイル
設定ファイルの基本、Lua 構文、require、LSP スタブ	references/start.md
変数／オプション（一般、装飾、入力、その他など）	references/variables.md
キーバインド（hl.bind、フラグ、サブマップ）	references/binds.md
ディスパッチャー（hl.dsp.*、hl.dispatch）	references/dispatchers.md
ウィンドウルールとレイヤールール	references/window-rules.md
モニター設定	references/monitors.md
自動起動（hyprland.start イベント）	references/autostart.md
アニメーションとベジェ曲線	references/animations.md
ワークスペースルールとスマートギャップ	references/workspace-rules.md
環境変数	references/environment-variables.md
レイアウト（dwindle、master、scrolling、monocle、custom）	references/layouts.md
Lua スクリプト、イベント、タイマー（hl.on、hl.exec_cmd）	references/lua-scripting.md
デバイスごとの入力設定	references/devices.md
通知 API	references/notifications.md
パフォーマンスの調整	references/performance.md
XWayland	references/xwayland.md
画面のティアリング	references/tearing.md
マルチ GPU	references/multi-gpu.md
仮想 GPU	references/virtual-gpu.md
権限	references/permissions.md
ジェスチャー	references/gestures.md
systemd との統合（graphical-session.target）	references/systemd.md
命名規則（ワークスペース、モニター、ウィンドウセレクター）	references/naming-conventions.md
Lua コードスニペットと設定例	references/code-snippets.md

ツール

トピック	ファイル
hyprctl CLI の使い方（eval、repl、batch）	references/hyprctl.md
IPC ソケットとイベント	references/ipc.md

Hypr エコシステム

トピック	ファイル
Hyprlock（画面ロック）	references/hyprlock.md
Hypridle（アイドル管理）	references/hypridle.md
Hyprpaper（壁紙）	references/hyprpaper.md
Hyprlauncher（アプリランチャー）	references/hyprlauncher.md
Hyprpicker（カラーピッカー）	references/hyprpicker.md
Hyprsunset（ブルーライトフィルター）	references/hyprsunset.md
Hyprcursor（カーソルテーマ）	references/hyprcursor.md
XDPH（xdg-desktop-portal-hyprland）	references/xdph.md
Hyprpolkitagent（polkit 認証）	references/hyprpolkitagent.md
Hyprshutdown（シャットダウンユーティリティ）	references/hyprshutdown.md
Hyprsysteminfo（システム情報）	references/hyprsysteminfo.md
Hyprpwcenter（電源管理）	references/hyprpwcenter.md
Hyprland Qt サポート	references/hyprland-qt-support.md
開発ライブラリ（hyprtoolkit、hyprlang、hyprutils、aquamarine など）	references/hypr-libraries.md

プラグイン

トピック	ファイル
プラグインの使用と開発	references/plugins.md

プラットフォーム固有

トピック	ファイル
NixOS / Nix / Home Manager	references/nix.md
Nvidia のセットアップ	references/nvidia.md

ヘルプ

トピック	ファイル
FAQ とトラブルシューティング	references/faq.md
入門 / インストール	references/getting-started.md
便利なユーティリティ（バー、ランチャー、スクリーンショット、systemd など）	references/useful-utilities.md
クラッシュとバグ	references/crashes-and-bugs.md
Hyprland への貢献	references/contributing.md

ライブ取得

参照ファイルの情報が不十分な場合は、GitHub の raw から最新のドキュメントを取得してください：

https://raw.githubusercontent.com/hyprwm/hyprland-wiki/main/content/<section>/<page>.md

パスは小文字です。セクションのインデックスページは _index.md です。例：

• https://raw.githubusercontent.com/hyprwm/hyprland-wiki/main/content/configuring/core/config-options.md
• https://raw.githubusercontent.com/hyprwm/hyprland-wiki/main/content/configuring/core/advanced-configuration/using-hyprctl.md
• https://raw.githubusercontent.com/hyprwm/hyprland-wiki/main/content/hypr-ecosystem/user/hyprlock.md
• https://raw.githubusercontent.com/hyprwm/hyprland-wiki/main/content/nix/installing-hyprland-on-nixos.md

各参照ファイルの先頭にある `` ヘッダーに、対応する Wiki セクションが記載されています。

クイックリファレンス（Hyprland 0.55 以降、Lua 設定）

設定ファイルの場所

~/.config/hypr/hyprland.lua（または $XDG_CONFIG_HOME/hypr/hyprland.lua。Hyprland --config で上書きできます）

オプション

hl.config({
    general = {
        border_size = 2,
        gaps_in = 5,
    },
})

複数の hl.config() 呼び出しが許可されており、それぞれ受け取った項目のみを更新します。

キーバインド

hl.bind("SUPER + SHIFT + Q", hl.dsp.exec_cmd("firefox"))
hl.bind("SUPER + X", function()
    hl.dispatch(hl.dsp.window.float({ action = "toggle" }))
end)

自動起動

hl.on("hyprland.start", function()
    hl.exec_cmd("waybar & hyprpaper")
end)

ウィンドウルール

hl.window_rule({
    match = { class = "firefox" },
    opacity = 0.9,
    float = true,
})

モニター

hl.monitor({
    output = "DP-1",
    mode = "1920x1080@144",
    position = "0x0",
    scale = 1,
})

設定の分割

require("conf/binds")      -- ~/.config/hypr/conf/binds.lua

hyprctl による実行時制御

hyprctl reload
hyprctl eval 'hl.config({ general = { border_size = 3 } })'
hyprctl repl               # interactive Lua REPL
hyprctl --batch "..."

レガシー（Hyprland 0.54 以前、hyprlang）

旧形式の ~/.config/hypr/hyprland.conf：

bind = MODS, key, dispatcher, params
general {
    border_size = 2
}
monitor = name, resolution@rate, position, scale

レガシー版のドキュメント全文：https://wiki.hypr.land/0.54.0/