Hyprland 初期設定とキーバインド

Hyprland をえらぶ理由

Hyprland はさまざまなレイアウトを用意している美しいダイナミックタイリング型のマネージャーで、可変リフレッシュレート、ティアリング、HDR などのコンポジターとして高度な機能を備えています。CachyOS の Hyprland 用ドットファイルでは、インストール直後から快適に利用できるようなデフォルト設定になっており、各アプリケーションもシステム全体のテーマに統一されるよう調整されています。

ドットファイル提供: Jinra

Noctalia に関する問題については Noctalia のドキュメントをご覧ください。

初期設定

セットアップ後は、ご自身に合わせた設定をいくつか行うことをおすすめします。その他の設定については Hyprland Wiki をご覧ください。

`~/.config/hypr/config`

monitors.lua ではモニター設定を行います。(https://wiki.hypr.land/Configuring/Basics/Monitors/)
- output にはモニター ID を指定します。hyprctl monitors で確認できます。(例: DP-1)
- mode は 1920x1080@60 といった形式 (横解像度×縦解像度@リフレッシュレート) で指定します。
- scale は通常 1 のままで問題ありませんが、高解像度ディスプレイではより大きな値を設定したほうが良い場合があります。
- 初回の変更後のみ再起動が必要ですが、それ以降の変更はリアルタイムで反映されます。
variables.lua
- モニターの割り当てを設定できます。通常は PRIMARY_MONITOR と MONITOR1 は同じモニターに設定してください。必要に応じて MONITOR# を追加・削除できます。
- モニターごとのワークスペース数を指定してください。ただし 10 以下で設定してください。
input.lua Hyprland での入力操作の設定を行うことができます。特に sensitivity (感度) の調節をおすすめします。
binds.lua このドットファイルで用意されているすべてのキーバインドを確認できます。下記の一覧も参考にしてください。
windowrules.lua 特定のウィンドウが特別な動作をする理由を確認できます。また、必要に応じてルールを追加・削除できます。
workspaces.lua ワークスペースに関する設定を行うことができます。設定ファイルの例のように、モニターごとに3つのワークスペースを設定し、プライマリモニターへゲーム用ワークスペースを追加することをおすすめします。
environment.lua は Hyprland の設定やカスタムの環境変数の指定に使います。UWSM を使用している場合は設定の必要はなく、UWSM の環境変数ファイルへ追加する方法をおすすめします。

`~/.config/uwsm`

env グローバル環境変数を定義するファイルです。HYPRCURSOR_THEME, XCURSOR_THEME, QT_QPA_PLATFORM などのユーザーアカウント全体で使用する環境変数を設定できます。

`~/.config/noctalia` (バージョン5専用、V4 でも存在するが Noctalia settings から設定できるため編集不要)

config.toml には cachyos-hypr-noctalia のデフォルト設定が保存されています。通常の Noctalia V5 の初期設定と異なるのはこのファイルによるものです。基本的には編集する必要はありません。

`noctalia settings` (Super + Z)

Noctalia の設定を変更できます。Templates の項目で使用するアプリケーション向けのカラーテンプレートを有効にすることをおすすめします。
Plugins Store には、便利な公式&コミュニティ製プラグインも用意されています。

キーバインド

多くのキーバインドは修飾キー (スーパーキーや Windows キー、コマンドキーとも呼ばれます) を使用します。binds.lua から変更することができます。

ウィンドウ操作

説明	キー
アプリ/ウィンドウを強制終了 (キーを押しながら対象をクリック)	Super + Escape
フォーカス中のウィンドウ/アプリを閉じる	Super + Q
フローティング/タイル表示を切り替える	Super + Alt + Space
フォーカス中のウィンドウを最大化	Super + D
フォーカス中のウィンドウを全画面表示	Super + F
分割方向の切り替え	Super + J
左のウィンドウにフォーカス	Super + Left Arrow
右のウィンドウにフォーカス	Super + Right Arrow
上のウィンドウにフォーカス	Super + Up Arrow
下のウィンドウにフォーカス	Super + Down Arrow
ワークスペース内でウィンドウのフォーカスを切り替え	Alt + Tab
ウィンドウスイッチャーを開く	Super + Tab
フォーカス中のウィンドウを指定したモニターに移動	Super + Shift + Number Sign
フォーカス中のウィンドウを指定したワークスペースに移動	Super + Shift + Control + Number Sign
フォーカス中のウィンドウをスペシャルワークスペースに移動	Super + Shift + S
フォーカス中のウィンドウを右に移動	Super + Shift + Right Arrow
フォーカス中のウィンドウを左に移動	Super + Shift + Left Arrow
フォーカス中のウィンドウを上に移動	Super + Shift + Up Arrow
フォーカス中のウィンドウを下に移動	Super + Shift + Down Arrow
フォーカス中のウィンドウを次のワークスペースに移動	Super + Control + Shift + Right Arrow
フォーカス中のウィンドウを前のワークスペースに移動	Super + Control + Shift + Left Arrow
フォーカス中のウィンドウを前のワークスペースに移動 (マウス)	Super + Control + Shift + Scroll up
フォーカス中のウィンドウを次のワークスペースに移動 (マウス)	Super + Control + Shift + Scroll down
フォーカス中のウィンドウを次のモニターに移動	Super + Shift + Scroll down
フォーカス中のウィンドウを前のモニターに移動	Super + Shift + Scroll up
ウィンドウの移動 (マウス)	Super + Left Click
ウィンドウサイズの変更 (マウス)	Super + Right Click

ランチャー

説明	キー
ターミナルを起動	Super + Return
ファイルマネージャーを起動	Super + E
エディターを起動	Super + T
電卓を起動	Super + C
ブラウザを起動	Super + W
システムモニター (btop) を起動	Control + Shift + Escape
Noctalia Settings を開く/閉じる	Super + Z
コントロールセンターを開く/閉じる	Super + X
アプリランチャーを開く/閉じる	Super + Space
絵文字ランチャーを開く/閉じる	Super + period
画面をロック	Super + L
セッションメニューを開く/閉じる	Super + Alt + C

ハードウェア操作

説明	キー
音量を上げる	Volume then Up Arrow
音量を下げる	Volume then Down Arrow
スピーカーをミュート	Mute
マイクをミュート	MicMute
メディアを再生/一時停止	Play / Pause
次のトラック	Next
前のトラック	Previous
画面の明るさを上げる	Brightness then Up Arrow
画面の明るさを下げる	Brightness then Down Arrow

ユーティリティ

説明	キー
カラーピッカー	Super + P
スクリーンショットを撮影してメモを書く	Print
ウィンドウのスクリーンショットを撮影してメモを書く (v4)	Super + Print
モニター全体のスクリーンショットを撮影してメモを書く (v5)	Super + Print
画面録画の開始/停止 (v4 のみ)	Super + R
壁紙メニューを開く/閉じる	Super + Shift + W
クリップボード履歴を開く	Super + V
通知履歴を開く/閉じる	Super + A

ワークスペースとモニター

説明	キー
ワークスペース1〜10へ切り替え	Super + [0-9]
ウィンドウをワークスペース1〜10へ移動 (追従)	Super + Shift + [0-9]
ウィンドウをワークスペース1〜10へ移動 (追従しない)	Super + Alt + [0-9]
指定したワークスペースへフォーカス	Super + Control + Number Sign
次のワークスペースへフォーカス	Super + Control + Right Arrow
前のワークスペースへフォーカス	Super + Control + Left Arrow
最初の空いているワークスペースへフォーカス	Super + Control + Down Arrow
次のワークスペースへフォーカス (マウス)	Super + Control + Scroll down
前のワークスペースへフォーカス (マウス)	Super + Control + Scroll up
次のモニターへフォーカス (マウス)	Super + Scroll down
前のモニターへフォーカス (マウス)	Super + Scroll up
スペシャルワークスペース (スクラッチパッド) を開く/閉じる	Super + S

他の DE/WM から移行する

すでに別のデスクトップ環境 (DE) またはウィンドウマネージャー (WM) をインストールしている場合は、以下の手順でこのドットファイルへ移行できます。

以下の手順では、山括弧 (<>) で囲まれた部分を、山括弧も含めて適切な値に置き換えてください。

sudo pacman -S cachyos-hypr-noctalia を実行してください。cachyos-kde-settings など、他の -settings パッケージと競合する場合は競合しているパッケージを削除してください。
Noctalia V5 Beta (または -git 版) を使用する場合は、かわりに以下の手順を実行してください。
- sudo pacman -Syu noctalia を実行して Noctalia V5 Beta をインストールしてください。
- -git 版を使用する場合は、paru -Syu noctalia-git または shelly -AI noctalia-git を実行してください。
新しいユーザーを作成する場合は sudo useradd -m <new_user> -s /bin/fish を実行してください。
sudo passwd <new_user> を実行し、新しいユーザーのパスワードを設定してください。
- どうしても同じユーザーアカウントを使用したい場合 (非推奨) は、かわりに cp -r /etc/skel/. ~ を実行してドットファイルをホームディレクトリへコピーしてください。その際は、必ず事前にバックアップまたはスナップショットを作成してください。
必要に応じて、SDDM をディスプレイマネージャーとして有効にしてください。まだ設定していない場合は、systemctl disable display-manager と systemctl enable sddm を実行してください。Noctalia greeter を使用すると Noctalia とより統一感のある環境になりますが、設定には追加作業が必要です。
再起動し、ディスプレイマネージャーから Hyprland (UWSM) セッションを選択してください。
- シェルの起動に失敗した場合は、もう一度再起動してみてください。
ログイン後、初期設定の内容に従って初期設定を行ってください。

V4 のドットファイルから V5 へ移行 / ドットファイルの更新

現在 Noctalia V4 の cachyos-hypr-noctalia を使用しており、パッケージをバージョン 1.0 から新しいバージョンへ更新した場合、またはドットファイルを更新したい場合は、以下の手順に従ってください。

ドットファイルを更新する必要があるかどうかは、リリースの変更履歴を確認してください。

Hyprland の更新

meld がインストールされていることを確認してください (pacman -Q meld)。インストールされていない場合はインストールしてください。
meld /etc/skel/.config/hypr ~/.config/hypr を実行してください。
Meld が開くと、変更されたすべてのファイルが一覧表示されます。青色のファイルは変更が加えられたファイル、緑色のファイルは新しく追加されたファイルです。
※Meld は日本語に対応しています。
青色のファイルをクリックすると、適用される変更を確認できます。どの変更を適用するかは必要に応じて判断してください。ただし、自分で変更を加えていない場合は、ファイル全体を上書きしても問題ありません。矢印ボタンで変更を適用し、× ボタンで古い行を削除できます。
モニター設定など、自分で変更した内容は上書きしないよう注意してください。
すべての変更を一括でマージすることもできます。
ファイルの編集が完了したら、保存して終了してください。
新しく追加された緑色のファイルについては、保存先を尋ねられます。同じファイル名のまま ~/.config/hypr/config/ に保存してください。新しく追加されるファイルは次の4つです。
- defaults.lua は variables.lua に変更されます。独自に追加・変更した内容は、新しいファイルに手動で移行してください。
- keybinds.lua は binds.lua に変更されます。独自に追加・変更した内容は、新しいファイルに手動で移行してください。
- input.lua は inputs.lua に変更されます。独自に追加・変更した内容は、新しいファイルに手動で移行してください。
- workspaces.lua は新しく追加されたファイルです。そのままコピーして使用してください。

Noctalia の更新

rm -rf ~/.config/noctalia を実行して現在の設定を削除してください。必要になる可能性がある場合は、削除する代わりに別の場所へ移動してください。
cp -r /etc/skel/.config/noctalia ~/.config を実行し、新しい設定をホームディレクトリへコピーしてください。

その他の更新

他のファイルも更新されている場合があります。必要に応じて Meld を使用して変更を取り込んでください。その他の変更内容については、リリースの変更履歴を確認してください。

孤立パッケージを削除する (V4 → V5 移行)

パッケージを更新すると、古い依存パッケージが孤立状態になります。shelly purify -o を実行して削除してください。

再起動

変更を反映するため、再起動してください。シェルの起動に失敗した場合は、もう一度再起動してみてください。