Hyprland

関連記事

• ウィンドウマネージャ
• Wayland

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

インストール

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

• hyprland - 最新のアップストリームリリース。
• hyprland-git^AUR - master ブランチへの最新のコミット。

#6608 の時点で、Hyprland は独自のレンダリングバックエンドライブラリとして aquamarine を使用しています。以前は、wlroots-git^AUR に密接に従った独自のバージョンの wlroots がバンドルされていました。

ノート:

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

設定

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

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

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

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

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

キーボード

キーマップ

デフォルトでは、Hyprland は US Qwerty を使用します。次のように設定できます:

~/.config/hypr/hyprland.conf

# German Colemark layout
input {
    ...
    kb_layout = de
    kb_variant = colemark
    ...
    }

利用可能なすべてのオプションについては、上流 Wiki を参照してください。

ノート: Hyprland は ロケール 定義をオーバーライドするため、US レイアウトキーボードを使用しない場合はキーマップを変更する必要があります。

典型的な遅延と速度

Xorg ユーザーはこの設定を サーバーレベルで定義 で使用することに慣れていますが、Wayland では各コンポジターがそれを独自に処理します。

~/.config/hypr/hyprland.conf

# Repeat rate and delay
input {
    ...
    repeat_rate = 25
    repeat_delay = 600
    ...
    }

キーボードのバックライト

他の照明コントロールとは異なり、キーボードバックライトには XF86 キーシムがないため、従来のバインドを行う必要があります。

brightnessctl を インストール します、次のバインドを追加します。

~/.config/hypr/hyprland.conf

# Keyboard backlight
bind = SUPER, F3, exec, brightnessctl -d *::kbd_backlight set +33%
bind = SUPER, F2, exec, brightnessctl -d *::kbd_backlight set 33%-

変更が行われたときに 画面上の通知 を実行することもできます。

ノート: ラップトップにハードウェアキーボードバックライトコントロール (キーボードの Fn キーを使用) がある場合、追加の手順なしで機能するはずです。

メディアキー

Hyprland でキーボードメディアコントロールを使用するには、XF86Audio キーシムと、pavucontrol または pamixer や playerctl などの外部アプリケーションを利用することで可能です。

~/.config/hypr/hyprland.conf

# Volume and Media Control
bind = , XF86AudioRaiseVolume, exec, pamixer -i 5 
bind = , XF86AudioLowerVolume, exec, pamixer -d 5 
bind = , XF86AudioMicMute, exec, pamixer --default-source -m
bind = , XF86AudioMute, exec, pamixer -t
bind = , XF86AudioPlay, exec, playerctl play-pause
bind = , XF86AudioPause, exec, playerctl play-pause
bind = , XF86AudioNext, exec, playerctl next
bind = , XF86AudioPrev, exec, playerctl previous

変更が行われたときに 通知 を実行することもできます。

タッチパッドのジェスチャ

Wayland コンポジタである Hyprland はタッチパッドジェスチャを完全にサポートしていますが、デフォルトでは無効になっています。それらを有効にするには、次を編集します:

~/.config/hypr/hyprland.conf

# Enable touchpad gestures
gestures {
    workspace_swipe = true
    workspace_swipe_fingers = 3
}

利用可能なすべてのオプションについては、上流 Wiki を参照してください。

ディスプレイの設定

画面共有

Screen-sharing を参照してください。

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

Hyprland は、領域共有、ウィンドウ共有、グラフィカルピッカーユーティリティなどの機能を追加した wlr ポータルのフォークである xdg-desktop-portal-hyprland も保守しています。ポータルの使用法については、Hyprland wiki で詳しく説明されています。

画面解像度の設定

Hyprland は画面解像度を自動的に検出しようとしますが、複数の画面が存在する場合やハイブリッドラップトップを使用している場合は、場合によっては失敗し、デフォルトでフェールセーフが設定されます。画面上のすべてが大きい場合は、デフォルトのモニターと解像度を設定する必要があります。

まず、hyprctl を使用してデフォルトのモニターを見つけます:

$ hyprctl monitors

Monitor eDP-1 (ID 0):
        1920x1080@144.003006 at 0x0
        description: Chimei Innolux Corporation 0x153C (eDP-1)
        ...

次に、モニターを設定に追加します:

~/.config/hypr/hyprland.conf

...
# Monitor details
monitor=eDP-1,1920x1080@144,0x0,1
...

0x0 はマルチスクリーン設定に使用される位置オフセットで、最後の 1 は画面のスケーリング係数です。

画面のバックライト

brightnessctl を インストール して、次のバインドを追加します。

~/.config/hypr/hyprland.conf

# Screen brightness
bind = , XF86MonBrightnessUp, exec, brightnessctl -s +5%
bind = , XF86MonBrightnessDown, exec, brightnessctl -s 5%-

変更が行われたときに 通知 を実行することもできます。

使用方法

起動

Universal Wayland Session Manager

Uwsm は、systemdを使用するディストリビューション(特に Arch Linux) で Hyprland セッションを開始する推奨方法 です。これは、Hyprland と適切に設定されたアプリケーションやデーモンを systemd ユニットファイルを通じてラップし、systemctl を使用して管理できるようにします。

TTY 上で Hyprland を起動するには、以下のスクリプトを ~/.profile に追加します。

if uwsm check may-start && uwsm select; then
  exec systemd-cat -t uwsm_start uwsm start default
fi

ノート: uwsm check may-start は、Wayland セッションを開始できるかどうか(特にログインシェルから実行されているか)を確認します。ただし、.bashrc やその他の非ログインシェルでも読み込まれるファイル内で使用することは避けてください。

ヒント: コンポジター選択メニューをバイパスし、直接 Hyprland を起動したい場合は、代わりに以下のコードをシェルのプロファイルに追加してください。

if uwsm check may-start; then
  exec uwsm start hyprland.desktop
fi

デスクトップマネージャー経由で起動する場合は、hyprland-uwsm.desktop エントリを使用するか、デスクトップマネージャー内で hyprland (uwsm-managed) を選択してください。

警告: uwsm を使用して Hyprland を起動する場合は、設定を適切に調整する必要があります。特に以下の点に注意してください:

• exit ディスパッチャーを使用したり、Hyprland プロセスを直接終了したりしないでください。 これは正常なシャットダウン処理を妨げる可能性があります。その代わりに、例えば uwsm stop または loginctl terminate-user "" を使用して Hyprland を終了し、ユーザーセッションを終了してください。

~/.config/hypr/hyprland.conf

bind = $mainMod, M, exec, uwsm stop

• 環境変数を hyprland.conf に記述せず、代わりに uwsm の設定ファイルを使用してください。uwsm が管理するすべてのグラフィカルセッション (GTK、Qt、xcursor など) に共通の環境変数は /.config/uwsm/env に、Hyprland 専用の環境変数 (例えば HYPR* や AQ_* など) は /.config/uwsm/env-hyprland に記述してください。これらのファイルのフォーマットは、各行に export KEY=VALUE を記述し、コメントは入れないようにします。

複数の GPU を使用している場合、他のコンポジターとの競合を避けるため、AQ_DRM_DEVICES 環境変数を env-hyprland に記述することを強く推奨します。

uwsm を使用した設定の詳細については、Hyprland の公式 Wiki の関連ページ を参照してください。

ターミナル

TTYから以下のコマンドでHyprlandを起動できます。

$ Hyprland

ディスプレイマネージャー

ディスプレイマネージャ からの起動は公式にはサポートされていませんが、GDM、SDDM などからの起動に成功したという報告があります。upstream wiki では、ディスプレイマネージャーとの互換性リストを公開しています。 hyprland パッケージにはディスプレイマネージャーのエントリが含まれており、すべての Hyprland AUR パッケージも自動で生成します。

どちらの方法でも同じ結果が得られますが、環境変数やサービスの違いが若干ある場合があります。

自動ログイン

ユーザーはディスプレイマネージャを使用するか、xinit#ログイン時に X を自動起動 で紹介されている方法を適用することで、自動ログインを設定できます。

hyprctl と IPC

hyprctl は、Hyprland に付属するコマンドラインユーティリティで、ディスプレイサーバーと通信するために使用されます。 これを使用すると、サーバーにコマンドを送信 (設定ファイルのコマンドと同様ですが、少し異なる構文を持ちます)、キーワードを設定、クエリの送信、情報の取得ができます。 詳細は 公式ドキュメント を参照してください。

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

hyprctl と IPC ソケットの両方を活用すれば、スクリプトで Hyprland を制御し、複雑なタスクを実行することが可能です。

exec と exec-once の違い

アプリケーションを起動する際は、適切なディスパッチャーを使用することが重要です。exec を誤って使用すると、アプリケーションが複数回起動し、システムリソースを消費したり、最悪の場合は競合 (レースコンディション) を引き起こし、システムがクラッシュする可能性があります。

ノート: #設定 で述べたように、Hyprland は 設定ファイル (hyprland.conf) の変更が保存されるたびに自動的にパースします そのため、すべてに exec を使用しないようにしてください。 通常、アプリケーションやデーモンの起動には exec-once を使用すべきです。このコマンドは再読み込み時には再実行されません。逆に、再読み込みのたびにコマンドを実行する必要がある場合のみ exec を使用してください。

ヒント: Hyprland を Universal Wayland Session Manager (uwsm) 経由で起動しており、起動したいアプリケーションが systemd ユニットを提供している場合は、それを 有効化 することで、Hyprland の準備が整った際に自動的に起動できます。そうでない場合は、uwsm app にアプリケーションを引数として渡すことで、uwsm によって管理できます。 例えば:

~/.config/hypr/hyprland.conf

exec-once = uwsm app -- mycommand --arg1 --arg2
bind = SUPER, E, exec, uwsm app -- pcmanfm-qt.desktop

環境変数の設定

環境変数 は、hyprland.conf 内で env キーワードを使用して直接設定できます。ただし、env の構文は、シェルで使用される UNIX コマンド env とは異なります。

この違いについては、上流の Wiki で説明されています。

Hypr-Ecosystem

警告: 以下のセクションで紹介されているツールの一部はまだ開発中であり、バグが発生する可能性があります。そのため、完全な手順や具体例は安定するまで省略されています。詳細な使用方法については、Wiki を参照してください。

Hyprland 開発チームは、Hyprland 専用のアプリケーションエコシステムを構築しています。これらのツールには、スクリプトに頼ることなく、hyprctl を使用して制御できるディスパッチャーが含まれます。

現在、このエコシステムには以下のツールが含まれています。

Hyprpaper

Hyprpaperは壁紙管理ツールです。hyprpaper パッケージでインストールできます。

Hyprpicker

Hyprpicker はデスクトップ上の色を取得するためのユーティリティです。hyprpicker パッケージでインストールできます。

Hypridle

Hypridle はアイドル管理デーモンです。hypridle パッケージでインストールできます。

Hyprlock

Hyprlock はスクリーンロックマネージャーです。hyprlock パッケージでインストールできます。

Hyprcursor

Hyprcursorは、新しいカーソル管理フォーマットを提供するツールで、従来の方法に比べて多くの改善をもたらします。hyprcursor パッケージでインストールできます。

Hyprcursor themes

ヒント: Hyprcursor をインストールしても、テーマをインストールしない場合は、従来のカーソル設定が適用されます。

カーソルテーマは AUR からインストールできます。例えば、以下のようなものがあります:

• sweet-cursors-hyprcursor-git^AUR
• nordzy-hyprcursors^AUR
• xcursor-pro-hyprcursor^AUR
• hyprcursor-dracula-kde-git^AUR

既存のテーマを Hyprcursor 用に移植する方法については、上流の GitHub リポジトリ に記載されています。

xdg-desktop-portal-hyprland

Hyprland 独自の XDG Desktop Portal 実装です。他の wlroots ベースのコンポジターとも互換性がありますが、Hyprland 上で使用すると追加機能が利用できます。xdg-desktop-portal-hyprland パッケージで入手可能です。

ヒントとテクニック

ノート:

• 以下のすべてのセクションでは、通常、同様の結果を達成する方法が複数あります。ここで提供するものはすべて基本的な例です。
• 代替手段の包括的なリストについては、アプリケーション一覧 を参照してください。Hyprland 固有のリストは、上流 Wiki にあります。

ファイルマネージャー

グラフィカルなファイル管理が必要な場合、Hyprland には Wayland 互換の外部アプリケーションが必要です。例として thunar を使用すると、次のようにキーバインドを割り当てるだけで済みます。

~/.config/hypr/hyprland.conf

...
bind = SUPER, E, exec, thunar
...

アプリケーションランチャー

Hyprland では、アプリケーションを起動するために Wayland と互換性のある外部アプリケーションが必要です。例として wofi を使用すると、次のようにキーバインドを割り当てるだけで済みます。

~/.config/hypr/hyprland.conf

...
bind = SUPER, F, exec, wofi
...

アイドル状態

Hyprland には、Wayland 互換の外部アイドル管理デーモンが必要です。最も一般的なセットアップは、swayidle と swaylock です。次のようにバインドを使用して画面を手動でロックできます。

~/.config/hypr/hyprland.conf

...
bind = SUPER, L, exec, swaylock -f -c 000000
...

自動画面ロックとサスペンド

次のスクリプトを作成します:

~/.config/hypr/scripts/sleep.sh

swayidle -w timeout 300 'swaylock -f -c 000000' \
            timeout 600 'systemctl suspend' \
            before-sleep 'swaylock -f -c 000000' &

ヒント:

• 数値を編集することでタイムアウト期間を秒単位で調整できます。300 は 5 分、600 は 10 分などです。
• スクリプトは 実行可能ファイル である必要があります。

次に、それを呼び出します:

~/.config/hypr/hyprland.conf

...
exec-once = ~/.config/hypr/scripts/sleep.sh
...

タイムアウト期間後に DPMS を使用して画面をオフにする

Hyprland には DPMS リクエストを処理する組み込みディスパッチャがありますが、これを直接キーバインドとして使用することはお勧めできません。使用すると、画面を再びオンにできなくなり、再起動が必要になります。

上記のスクリプトを編集して次のように変更します:

~/.config/hypr/scripts/sleep.sh

swayidle -w timeout 300 'swaylock -f -c 000000' \
            timeout 600 'hyprctl dispatch dpms off' \
            resume 'hyprctl dispatch dpms on' \
            timeout 900 'systemctl suspend' \
            before-sleep 'swaylock -f -c 000000' &

ヒント: resume コマンドは前のコマンドにリンクされているため、正しく機能するには、hyprctldispatch dpms on コマンドをスクリプト内の hyprctldispatch dpms off コマンドの直後に指定する必要があります。

アプリケーションの使用中に DPMS を停止する

上記の設定を行うと、ゲームをプレイしたり、ビデオを見たり、音楽を聴いたりするなど、タイムアウト期間を超えてシステムに触らない可能性のある作業を行っているときにモニターの電源がオフになります。

これを修正するには、idleinhibit ルールを持つ Window Rules V2 関数に組み込まれた Hyprlands を使用するか、idlehack-git^AUR または sway-audio-idle-inhibit-git^AUR のいずれかをインストールします。前者は、Firefox または Chromium がオーディオ/ビデオを再生しているときは常に D-Bus を使用して Swayidle リクエストを防止します。後者は、アプリケーションがオーディオを再生しているときは常に Swayidle リクエストを阻止します。

スクリーンセーバーを一時停止するために org.freedesktop.ScreenSaver.inhibit を使うプログラムについては、wscreensaver-bridge-git^AUR をインストールすることで Hyprland (または idle-inhibit プロトコルをサポートする Wayland コンポジター) に実装することができます。

ステータスバー

Hyprland でステータス バーを表示するには、Wayland 互換の外部アプリケーションが必要です。例として waybar を使用すると、次のように呼び出すだけで済みます:

~/.config/hypr/hyprland.conf

...
exec-once = waybar -c ~/.config/waybar/waybar.conf
...

ワークスペースの概要

waybar には、Hyprland ワークスペースの切り替えをネイティブにサポートする、完全にカスタマイズ可能なモジュールが組み込まれています。

詳細については、waybar Wiki [1] を参照してください。

Polkit 認証

Polkit 認証には、外部 認証エージェント の使用が必要です。Hyprland では polkit-kde-agent の使用を推奨していますが、どれでも機能するはずです。

次のように呼び出します:

~/.config/hypr/hyprland.conf

...
exec-once = /usr/lib/polkit-kde-authentication-agent-1
...

デスクトップの壁紙

Hyprland では、デスクトップの壁紙を管理するために、Wayland と互換性のある外部アプリケーションが必要です。例として swww^AUR を使用すると、次のように呼び出すだけで済みます:

~/.config/hypr/hyprland.conf

...
exec-once = swww init
exec-once = swww img path/to/image
...

スクリプトを使用して X 分ごとに壁紙を変更する

次のスクリプトを作成し、実行可能ファイル であることを確認します:

~/.config/hypr/scripts/swww-random

#!/bin/bash

# This script will randomly go through the files of a directory, setting it
# up as the wallpaper at regular intervals
#
# NOTE: this script uses bash (not POSIX shell) for the RANDOM variable

if [[ $# -lt 1 ]] || [[ ! -d $1   ]]; then
	echo "Usage:
	$0 <dir containing images>"
	exit 1
fi

# Edit below to control the images transition
export SWWW_TRANSITION_FPS=144
export SWWW_TRANSITION_STEP=2
export SWWW_TRANSITION_TYPE=random

# This controls (in seconds) when to switch to the next image
INTERVAL=300

while true; do
	find "$1" \
		| while read -r img; do
			echo "$((RANDOM % 1000)):$img"
		done \
		| sort -n | cut -d':' -f2- \
		| while read -r img; do
			swww img "$img"
			sleep $INTERVAL
		done
done

次に、背景画像を保存する新しいフォルダーを作成します。~/.config/hypr/backgrounds のようなフォルダーを作成し、そこに必要な画像を追加します。

最後にスクリプトを呼び出します:

~/.config/hypr/hyprland.conf

...
exec-once = swww init
exec-once = ~/.config/hypr/scripts/swww-random ~/.config/hypr/background
...

画面上の通知

外部通知デーモンを使用すると、明るさや音量の変更などのアクションを画面上で通知できます。これは非常に複雑なトピックなので、完全に説明することはこのページの範囲を超えています。むしろ、このセクションでは mako に焦点を当てますので、インストール してください。

詳細な手順については デスクトップ通知 を、代替手段のリストについては デスクトップ通知#スタンドアロン を参照してください。

ノート:

• ここで提供されるすべてのスクリプトは例であり、セットアップに合わせて調整する必要があります。
• このセクションのすべてのスクリプトは 実行可能ファイル である必要があります。

Mako

Mako は軽量の通知デーモンです。詳細については、mako(5) を参照してください。設定ファイルは ~/.config/mako/config で、OSD に使用されるアイコンは ~/.config/mako/icons/ に保存されており、PNG 形式である必要があります。

このセクションの残りの部分では、スクリプトで使用されるすべてのイメージは この GitHub フォルダー から入手できます。

キーボードのバックライト通知

まず次のスクリプトを作成します:

~/.config/hypr/scripts/kbbacklight

#!/usr/bin/env bash

iDIR="$HOME/.config/mako/icons"

# Get brightness
get_backlight() {
	LIGHT="$(cat /sys/class/leds/*::kbd_backlight/brightness)"
	echo "${LIGHT}"
}

# Get icons
get_icon() {
	current="$(cat /sys/class/leds/*::kbd_backlight/brightness)"

	if [[ ("$current" -ge "0") && ("$current" -le "1") ]]; then
		icon="$iDIR/brightness-20.png"
	elif [[ ("$current" -ge "1") && ("$current" -le "2") ]]; then
		icon="$iDIR/brightness-60.png"
	elif [[ ("$current" -ge "2") && ("$current" -le "3") ]]; then
		icon="$iDIR/brightness-100.png"
	fi
}

# Notify
notify_user() {
	notify-send -h string:x-canonical-private-synchronous:sys-notify -u low -i "$icon" "Keyboard Brightness : $(brightnessctl -d '*::kbd_backlight' g)"
}

# Increase brightness
inc_backlight() {
	brightnessctl -d *::kbd_backlight set 33%+ && get_icon && notify_user
}

# Decrease brightness
dec_backlight() {
	brightnessctl -d *::kbd_backlight set 33%- && get_icon && notify_user
}

# Zero brightness
zero_backlight() {
	brightnessctl -d *::kbd_backlight s 0%
}

# Full brightness
full_backlight() {
	brightnessctl -d *::kbd_backlight s 100%
}

# Execute accordingly
if [[ "$1" == "--get" ]]; then
	brightnessctl -d '*::kbd_backlight' g
elif [[ "$1" == "--inc" ]]; then
	inc_backlight
elif [[ "$1" == "--dec" ]]; then
	dec_backlight
elif [[ "$1" == "--zero" ]]; then
	zero_backlight
elif [[ "$1" == "--full" ]]; then
	full_backlight

else
	get_backlight
fi

次に、以下を追加します (または既存のバインドを編集します):

~/.config/hypr/hyprland.conf

# Keyboard brightness
bind = SUPER, F2, exec, ~/.config/hypr/scripts/kbbacklight --dec
bind = SUPER, F3, exec, ~/.config/hypr/scripts/kbbacklight --inc

メディアキーの通知

まず次のスクリプトを作成します:

~/.config/hypr/scripts/volume

#!/usr/bin/env bash

iDIR="$HOME/.config/mako/icons"

# Get Volume
get_volume() {
	volume=$(pamixer --get-volume)
	echo "$volume"
}

# Get icons
get_icon() {
	current=$(get_volume)
	if [[ "$current" -eq "0" ]]; then
		echo "$iDIR/volume-mute.png"
	elif [[ ("$current" -ge "0") && ("$current" -le "30") ]]; then
		echo "$iDIR/volume-low.png"
	elif [[ ("$current" -ge "30") && ("$current" -le "60") ]]; then
		echo "$iDIR/volume-mid.png"
	elif [[ ("$current" -ge "60") && ("$current" -le "100") ]]; then
		echo "$iDIR/volume-high.png"
	fi
}

# Notify
notify_user() {
	notify-send -h string:x-canonical-private-synchronous:sys-notify -u low -i "$(get_icon)" "Volume : $(get_volume) %"
}

# Increase Volume
inc_volume() {
	pamixer -i 5 && notify_user
}

# Decrease Volume
dec_volume() {
	pamixer -d 5 && notify_user
}

# Toggle Mute
toggle_mute() {
	if [ "$(pamixer --get-mute)" == "false" ]; then
		pamixer -m && notify-send -h string:x-canonical-private-synchronous:sys-notify -u low -i "$iDIR/volume-mute.png" "Volume Switched OFF"
	elif [ "$(pamixer --get-mute)" == "true" ]; then
		pamixer -u && notify-send -h string:x-canonical-private-synchronous:sys-notify -u low -i "$(get_icon)" "Volume Switched ON"
	fi
}

# Toggle Mic
toggle_mic() {
	if [ "$(pamixer --default-source --get-mute)" == "false" ]; then
		pamixer --default-source -m && notify-send -h string:x-canonical-private-synchronous:sys-notify -u low -i "$iDIR/microphone-mute.png" "Microphone Switched OFF"
	elif [ "$(pamixer --default-source --get-mute)" == "true" ]; then
		pamixer -u --default-source u && notify-send -h string:x-canonical-private-synchronous:sys-notify -u low -i "$iDIR/microphone.png" "Microphone Switched ON"
	fi
}
# Get icons
get_mic_icon() {
	current=$(pamixer --default-source --get-volume)
	if [[ "$current" -eq "0" ]]; then
		echo "$iDIR/microphone.png"
	elif [[ ("$current" -ge "0") && ("$current" -le "30") ]]; then
		echo "$iDIR/microphone.png"
	elif [[ ("$current" -ge "30") && ("$current" -le "60") ]]; then
		echo "$iDIR/microphone.png"
	elif [[ ("$current" -ge "60") && ("$current" -le "100") ]]; then
		echo "$iDIR/microphone.png"
	fi
}
# Notify
notify_mic_user() {
	notify-send -h string:x-canonical-private-synchronous:sys-notify -u low -i "$(get_mic_icon)" "Mic-Level : $(pamixer --default-source --get-volume) %"
}

# Increase MIC Volume
inc_mic_volume() {
	pamixer --default-source -i 5 && notify_mic_user
}

# Decrease MIC Volume
dec_mic_volume() {
	pamixer --default-source -d 5 && notify_mic_user
}

# Execute accordingly
if [[ "$1" == "--get" ]]; then
	get_volume
elif [[ "$1" == "--inc" ]]; then
	inc_volume
elif [[ "$1" == "--dec" ]]; then
	dec_volume
elif [[ "$1" == "--toggle" ]]; then
	toggle_mute
elif [[ "$1" == "--toggle-mic" ]]; then
	toggle_mic
elif [[ "$1" == "--get-icon" ]]; then
	get_icon
elif [[ "$1" == "--get-mic-icon" ]]; then
	get_mic_icon
elif [[ "$1" == "--mic-inc" ]]; then
	inc_mic_volume
elif [[ "$1" == "--mic-dec" ]]; then
	dec_mic_volume
else
	get_volume
fi

次に、以下を追加します (または既存のバインドを編集します):

~/.config/hypr/hyprland.conf

# Volume
bind = , XF86AudioRaiseVolume, exec, ~/.config/hypr/scripts/volume --inc 
bind = , XF86AudioLowerVolume, exec, ~/.config/hypr/scripts/volume --dec 
bind = , XF86AudioMicMute, exec, ~/.config/hypr/scripts/volume --toggle-mic 
bind = , XF86AudioMute, exec, ~/.config/hypr/scripts/volume --toggle

画面のバックライト通知

まず次のスクリプトを作成します:

~/.config/hypr/scripts/backlight

!/usr/bin/env bash

iDIR="$HOME/.config/mako/icons"

# Get brightness
get_backlight() {
	LIGHT=$(printf "%.0f\n" $(brightnessctl g))
	echo "${LIGHT}"
}

# Get icons
get_icon() {
	current="$(get_backlight)"
	if [[ ("$current" -ge "0") && ("$current" -le "19200") ]]; then
		icon="$iDIR/brightness-20.png"
	elif [[ ("$current" -ge "19200") && ("$current" -le "38400") ]]; then
		icon="$iDIR/brightness-40.png"
	elif [[ ("$current" -ge "38400") && ("$current" -le "57600") ]]; then
		icon="$iDIR/brightness-60.png"
	elif [[ ("$current" -ge "57600") && ("$current" -le "76800") ]]; then
		icon="$iDIR/brightness-80.png"
	elif [[ ("$current" -ge "76800") && ("$current" -le "96000") ]]; then
		icon="$iDIR/brightness-100.png"
	fi
}

# Notify
notify_user() {
	notify-send -h string:x-canonical-private-synchronous:sys-notify -u low -i "$icon" "Brightness : $(get_backlight)"
}

# Increase brightness
inc_backlight() {
	brightnessctl s +5% && get_icon && notify_user
}

# Decrease brightness
dec_backlight() {
	brightnessctl s 5%- && get_icon && notify_user
}

# Execute accordingly
if [[ "$1" == "--get" ]]; then
	get_backlight
elif [[ "$1" == "--inc" ]]; then
	inc_backlight
elif [[ "$1" == "--dec" ]]; then
	dec_backlight
else
	get_backlight
fi

次に、以下を追加します (または既存のバインドを編集します):

~/.config/hypr/hyprland.conf

# Screen brightness
bind = , XF86MonBrightnessUp, exec, ~/.config/hypr/scripts/backlight --inc 
bind = , XF86MonBrightnessDown, exec, ~/.config/hypr/scripts/backlight --dec

キーボード言語の通知

このスクリプトを実行するには、コマンドライン JSON プロセッサ gojq^AUR が必要です。

まず次のスクリプトを作成します:

~/.config/hypr/scripts/lang

#!/usr/bin/env bash

icon="$HOME/.config/mako/icons/language.png"

# Get language
get_lang() {
	lang=$(hyprctl devices -j | gojq -r '.keyboards[] | select(.name == "at-translated-set-2-keyboard") | .active_keymap' | cut -c 1-2 | tr 'A-Z' 'a-z')
	case $lang in
		en)
			lang="English language"
			;;
		ru)
			lang="Русский язык"
			;;
		uk)
			lang="Українська мова"
			;;
	esac
	echo $lang
}

# Notify
notify-send -h string:x-canonical-private-synchronous:sys-notify -u low -i "$icon" "$(get_lang)"

次に、以下を追加します (または既存のバインドを編集します):

~/.config/hypr/hyprland.conf

device:at-translated-set-2-keyboard {
    kb_layout = us,ru,ua
    kb_variant = lang
    kb_options = grp:win_space_toggle
}

# Language
bind = SUPER, SPACE, exec, ~/.config/hypr/scripts/lang

電源制御

Hyprland では、電源制御のために Wayland 互換の外部アプリケーションが必要です。例として nwg-bar^AUR を使用すると、次のようにバインドするだけで済みます:

~/.config/hypr/hyprland.conf

...
bind = SUPER, ESCAPE, exec, nwg-bar
...

クリップボード

Wayland クリップボードの動作により、コピー元のアプリケーションを閉じるとデータが削除されます。他のデスクトップ環境では、専用のクリップボードマネージャーを使用することでこの問題を回避できますが、Hyprland には互換性のある選択肢が複数あります。詳細については、上流 Wiki を参照してください。

このセクションでは、テキストだけでなく画像のコピーもサポートしている cliphist について説明します。まず、次の行を追加します:

~/.config/hypr/hyprland.conf

...
exec-once = wl-paste --type text --watch cliphist store 
exec-once = wl-paste --type image --watch cliphist store
...

次に、選択した アプリケーションランチャー の履歴を呼び出すバインドを作成します:

~/.config/hypr/hyprland.conf

...
bind = SUPER, V, exec, cliphist list | wofi --dmenu | cliphist decode | wl-copy
...

Super+v を押すと、wofi ウィンドウが開き、クリップボード履歴リストが表示されます。

デバイスの有効化/無効化

デバイス(例:タッチパッド)を有効化または無効化するには、まず

$ hyprctl devices

を使用してデバイスの名前を調べます。

以下のコード行を設定ファイルに追加し(上記で照会したデバイス名で<device_name>を置き換えて)、デバイスをオン/オフにします:

~/.config/hypr/hyprland.conf

device:<device_name> {
  enabled = {true/false}
}

デバイスを動的にオン/オフするには、hyprctlを使用します:

$ hyprctl keyword "device:<device_name>:enabled" {true|false}

また、キーバインドを作成することもできます。例えば:

~/.config/hypr/hyprland.conf

...
bind = $mainMod, t, exec, hyprctl keyword "device:pixa3854:00-093a:0274-touchpad:enabled" false
bind = $mainMod Shift, t, exec, hyprctl keyword "device:pixa3854:00-093a:0274-touchpad:enabled" true
...

別の dconf プロファイルを使用する

他の GTK ベースのデスクトップ環境 (DE) の設定を汚染したくない場合は、個別の dconf プロファイルを使用できます。例えば、以下の手順で設定できます。

新しいグローバル dconf プロファイルを宣言します:

/etc/dconf/profile/hyprland

user-db:hyprland

~/.config/hypr/hyprland.conf

...
env = DCONF_PROFILE, hyprland
...

これで、gsettings を使用しても他のデスクトップ環境に影響を与えず、Hyprland 用の独立した設定を管理できます。

トラブルシューティング

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

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

NVIDIA 環境でのネイティブ (Wayland) Electron アプリのちらつき問題

Hyprland を使用している NVIDIA ユーザーの間で広く報告されている問題です ([3]、[4]) これは、Hyprland における明示的同期 (explicit sync) のサポート不足が原因とされています ([5])

この問題の推奨される一時的な対策として、該当するアプリケーションを X11 (XWayland) で動作させる方法があります。 具体的には、アプリケーションの起動時に --ozone-platform-hint=x11 を指定するか、すべての Electron アプリを XWayland で動作させるために、~/.config/hypr/hyprland.conf 内で env = ELECTRON_OZONE_PLATFORM_HINT,x11 を環境変数に設定してください。

参照

• Hyprland Web サイト
• 公式ドキュメント
• Hyprland Github Page
• コミュニティが管理するツール、プラグイン、拡張機能のリスト
• SolDoesTech - Github リポジトリ 通知スクリプト

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