Hyprland

関連記事

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

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

インストール

Hyprland は AUR からインストールするか、ソースからビルドすることができます。source.

Hyprland は独自のバージョンの wlroots をバンドルしており、wlroots-git^AUR に忠実に準拠しています。これは安定性を高め、他の wlroots ベースのコンポジターとの依存関係の衝突を避けることができます。

AUR から

hyprland^AUR、hyprland-bin^AUR または hyprland-git^AUR パッケージをインストールします。

ソースから

Hyprland は非常に活発なリポジトリです。現時点では、通常1日に数回のコミットがあります。

$ git clone --recursive https://github.com/vaxerski/Hyprland
$ cd Hyprland
# make install

recursive フラグは適切なバージョンの wlroots を取り出し、Hyprland のためにローカルにビルドします。

使用方法

起動

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

$ Hyprland

You can also execute a script of your own, e.g. setting 環境変数, that finishes with exec Hyprland, for instance (adapt to your needs):

#!/bin/bash
export SDL_VIDEODRIVER=wayland
export MOZ_ENABLE_WAYLAND=1
export GTK_THEME=Catppuccin-blue:dark
exec Hyprland

While launching from a ディスプレイマネージャ is not officially supported, users have reported success launching from GDM, SDDM, and others. All Hyprland AUR packages will generate a display manager entry automatically. If manually installing from source, an example Hyprland.desktop file is provided in the example directory of the source code, which may be copied to /usr/share/wayland-sessions/ to provide a display manager entry.

Both methods provide identical results, plus or minus a few environment variables and services.

hyprctl and IPC

hyprctl is a command line utility that comes installed with Hyprland to communicate with the display server. It allows you to dispatch commands to the server (equivalent to commands in the configuration file, but with a slightly different syntax), set keywords, send queries and request information. See the full documentation.

Hyprland also exposes 2 UNIX Sockets, for controlling and getting information about Hyprland via code or command-line utilities. These sockets broadcast events on focus change (windows, workspaces, monitors), creation of windows/workspace, and so on.

Both hyprctl and the IPC sockets can be effectively used in scripts to control Hyprland for complex tasks.

設定

Configuration is done through a single config file, hyprland.conf. If you installed Hyprland with your package manager, it is likely in /usr/share/hyprland/hyprland.conf. If you installed from source, it is in the Hyprland cloned repository. Copy hyprland.conf to ~/.config/hypr/hyprland.conf.

hyprland.conf includes directives to configure your devices (monitors, keyboards, mice, trackpads), as well as settings for animations, decorations, layout, etc. You can set key bindings, window rules, and execute commands (once or each time the config is reloaded).

The config is automatically reloaded each time you update the file. You can also use hyprctl reload for the same effect. For some settings (particularly input settings), you may have to restart your Hyprland session.

Settings can also be changed on the fly with hyprctl but they will not be saved.

Configuration is documented in the Hyprland wiki.

参照

• Developer's wiki on GitHub