hyprwm/Hyprland

⭐ 28,363 🍴 1,200 C++📄 BSD 3-Clause "New" or "Revised" License GitHubで見る →

主な特徴

グラデーションボーダー、ブラー、アニメーション、シャドウなどの豊富なビジュアルエフェクト
100%独立実装（wlroots、libweston、kwin、mutterに依存しない）
カスタムベジェ曲線による滑らかなアニメーション
強力なプラグインシステムとビルトインプラグインマネージャー
ゲーミングパフォーマンス向上のためのテアリングサポート
読みやすく拡張しやすいコードベース
高速で活発な開発
先進的な機能の積極的な採用
設定ファイルの即座リロード
完全に動的なワークスペース管理
2つのビルトインレイアウト（Dwindle、Master）
グローバルキーバインド
タイリング/疑似タイリング/フローティング/フルスクリーンウィンドウ
特殊ワークスペース（スクラッチパッド）
ウィンドウグループ（タブモード）
強力なウィンドウ/モニター/レイヤールール
ソケットベースのIPC
ネイティブIMEおよび入力パネルサポート

リポジトリ解析: hyprwm/Hyprland

基本情報

リポジトリ名: hyprwm/Hyprland
主要言語: C++
スター数: 28,363
フォーク数: 1,200
最終更新: 2025年（非常に活発に開発中）
ライセンス: BSD 3-Clause "New" or "Revised" License
トピックス: Waylandコンポジタ、タイリングウィンドウマネージャー、アニメーション、カスタマイズ、Linuxデスクトップ

概要

一言で言うと

見た目を犠牲にしない100%独立した動的タイリングWaylandコンポジタで、最新のWayland機能と高度なカスタマイズ性、美しいビジュアルを提供する。

詳細説明

Hyprlandは、Waylandプロトコル上で動作する次世代のウィンドウコンポジタで、伝統的なタイリングウィンドウマネージャーの機能性と、モダンなデスクトップ環境の美しさを融合させたプロジェクトです。

wlroots、libweston、kwin、mutterなどの既存のライブラリに依存しない完全独立実装を特徴とし、ゼロから構築されたコードベースにより、高いパフォーマンスと柔軟性を実現しています。アニメーション、グラデーションボーダー、ブラーエフェクトなどの視覚的な機能を豊富に揃えながら、実用的なタイリング機能を提供します。

主な特徴

グラデーションボーダー、ブラー、アニメーション、シャドウなどの豊富なビジュアルエフェクト
100%独立実装（wlroots、libweston、kwin、mutterに依存しない）
カスタムベジェ曲線による滑らかなアニメーション
強力なプラグインシステムとビルトインプラグインマネージャー
ゲーミングパフォーマンス向上のためのテアリングサポート
読みやすく拡張しやすいコードベース
高速で活発な開発
先進的な機能の積極的な採用
設定ファイルの即座リロード
完全に動的なワークスペース管理
2つのビルトインレイアウト（Dwindle、Master）
グローバルキーバインド
タイリング/疑似タイリング/フローティング/フルスクリーンウィンドウ
特殊ワークスペース（スクラッチパッド）
ウィンドウグループ（タブモード）
強力なウィンドウ/モニター/レイヤールール
ソケットベースのIPC
ネイティブIMEおよび入力パネルサポート

使用方法

インストール

前提条件

Linuxシステム（Waylandサポートが必須）
C++26対応コンパイラ
aquamarine (>=0.9.0)
hyprcursor (>=0.1.7)
hyprgraphics (>= 0.1.3)
hyprlang (>= 0.3.2)
hyprutils (>= 0.8.1)
Mesa または NVIDIAドライバー

インストール手順

# 方法1: ディストリビューションパッケージ経由
# Arch Linux
sudo pacman -S hyprland

# Ubuntu/Debian (サードパーティリポジトリ経由)
sudo add-apt-repository ppa:hyprland/ppa
sudo apt update
sudo apt install hyprland

# 方法2: ソースからビルド
git clone --recursive https://github.com/hyprwm/Hyprland
cd Hyprland
meson setup build
ninja -C build
sudo ninja -C build install

# 方法3: Nix経由
nix-env -iA nixos.hyprland

基本的な使い方

Hello World相当の例

# TTYからHyprlandを起動
Hyprland

# またはログインマネージャーから起動
# SDDM、GDMなどかHyprlandを選択

実践的な使用例

# 基本設定ファイル (~/.config/hypr/hyprland.conf)
monitor=,preferred,auto,auto

# キーバインド設定
bind = SUPER, Q, exec, kitty                    # ターミナル起動
bind = SUPER, C, killactive,                    # ウィンドウを閉じる
bind = SUPER, M, exit,                          # Hyprland終了
bind = SUPER, V, togglefloating,                # フローティング切り替え
bind = SUPER, P, pseudo,                        # 疑似タイリング

# ワークスペース切り替え
bind = SUPER, 1, workspace, 1
bind = SUPER, 2, workspace, 2

# ウィンドウルール
windowrule = float, ^(pavucontrol)$
windowrule = size 800 600, ^(pavucontrol)$

高度な使い方

# アニメーション設定
animations {
    enabled = yes
    bezier = myBezier, 0.05, 0.9, 0.1, 1.05
    animation = windows, 1, 7, myBezier
    animation = windowsOut, 1, 7, default, popin 80%
    animation = border, 1, 10, default
    animation = borderangle, 1, 8, default
    animation = fade, 1, 7, default
    animation = workspaces, 1, 6, default
}

# プラグインの使用
plugin {
    hyprbars {
        # ウィンドウタイトルバー設定
        bar_color = rgba(33ccffee)
        bar_height = 20
    }
}

# IPC経由でのコントロール
hyprctl dispatch exec kitty
hyprctl keyword general:gaps_in 5
hyprctl clients  # ウィンドウ情報取得

ドキュメント・リソース

公式ドキュメント

README.md: プロジェクト概要、機能一覧、ギャラリー
docs/Hyprland.1.rst: manページのソース
docs/hyprctl.1.rst: hyprctlコマンドのmanページ
Wiki: https://wiki.hypr.land - 包括的なドキュメント、設定ガイド、APIリファレンス

サンプル・デモ

example/hyprland.conf: 基本設定ファイルのテンプレート
example/hyprland.desktop: デスクトップエントリファイル
example/screenShader.frag: カスタムシェーダーの例

チュートリアル・ガイド

Getting Started: https://wiki.hypr.land/Getting-Started/Master-Tutorial/
Configuration: https://wiki.hypr.land/Configuring/
FAQ: https://wiki.hypr.land/FAQ/
Contributing: https://wiki.hypr.land/Contributing-and-Debugging/

技術的詳細

アーキテクチャ

全体構造

Hyprlandは完全独立実装のWaylandコンポジタで、以下の主要コンポーネントで構成されています：

Compositor Core: Waylandプロトコルの実装とウィンドウ管理
Renderer: OpenGLベースの描画システム
Layout Manager: タイリングアルゴリズムの実装
Protocol Manager: Waylandプロトコル拡張の管理
Plugin System: 動的ロード可能なプラグインシステム
IPC System: ソケットベースの通信システム

ディレクトリ構成

Hyprland/
├── src/                      # メインソースコード
│   ├── Compositor.*         # コンポジタコア
│   ├── config/              # 設定管理システム
│   ├── debug/               # デバッグ・ログ機能
│   ├── desktop/             # ウィンドウ・ワークスペース管理
│   ├── devices/             # 入力デバイスハンドリング
│   ├── events/              # イベントハンドラー
│   ├── helpers/             # ユーティリティ関数
│   ├── layout/              # レイアウトアルゴリズム
│   ├── managers/            # 各種マネージャー
│   ├── plugins/             # プラグインシステム
│   ├── protocols/           # Waylandプロトコル実装
│   ├── render/              # 描画システム
│   └── xwayland/            # XWaylandサポート
├── protocols/                # WaylandプロトコルXML
├── assets/                   # 画像・リソース
├── example/                  # 設定例
└── hyprctl/                  # IPCクライアント

主要コンポーネント

Compositor: コアコンポジタロジック
- 場所: src/Compositor.cpp
- 依存: Aquamarine、各種マネージャー
- インターフェース: init、run、cleanup
ConfigManager: 設定ファイルの解析と管理
- 場所: src/config/ConfigManager.cpp
- 依存: hyprlang
- インターフェース: loadConfig、reloadConfig、handleBind
OpenGL Renderer: OpenGLベースの描画エンジン
- 場所: src/render/OpenGL.cpp
- 依存: OpenGL 3.3+
- インターフェース: renderWindow、renderBorder、blur

技術スタック

コア技術

言語: C++26 （最新規格を積極的に採用）
グラフィックスAPI: OpenGL 3.3+ / OpenGL ES 3.0+
主要ライブラリ:
- aquamarine (>=0.9.0): バックエンド抽象化レイヤー
- hyprcursor (>=0.1.7): カーソル管理
- hyprgraphics (>=0.1.3): グラフィックスユーティリティ
- hyprlang (>=0.3.2): 設定言語パーサー
- hyprutils (>=0.8.1): 汎用ユーティリティ
- re2: 正規表現エンジン
- tracy: プロファイリング（オプション）

開発・運用ツール

ビルドツール: Meson (主要) / CMake (サポート)
テスト: CTest、実践的なテストはhyprtester
CI/CD: GitHub Actions (自動ビルド、テスト)
デプロイ: systemdサービスファイル提供

設計パターン・手法

イベント駆動アーキテクチャ: Waylandイベントを中心とした設計
プラグインアーキテクチャ: 動的ロード可能なプラグインシステム
Hookシステム: 柔軟な拡張性を提供
Passベースレンダリング: 効率的な描画パイプライン
RAIIパターン: リソース管理の安全性確保

データフロー・処理フロー

入力処理: libinput経由でマウス/キーボード入力を受信
イベント処理: Waylandプロトコルに変換
レイアウト計算: 選択されたレイアウトアルゴリズムで配置決定
レンダリング: OpenGLで描画命令生成
コンポジット: ウィンドウ、エフェクト、デコレーションを合成
出力: DRM/KMS経由でディスプレイに出力

API・インターフェース

公開API

hyprctl IPC API

目的: Hyprlandの動的制御と情報取得
Unixソケット経由の通信
使用例:

# ウィンドウ情報取得
hyprctl clients -j

# ディスパッチコマンド
hyprctl dispatch workspace 2
hyprctl dispatch movetoworkspace 3

# 動的設定変更
hyprctl keyword general:border_size 3
hyprctl keyword decoration:rounding 10

# リロード
hyprctl reload

設定・カスタマイズ

設定ファイル

# ~/.config/hypr/hyprland.conf
# 基本設定
general {
    gaps_in = 5
    gaps_out = 20
    border_size = 2
    col.active_border = rgba(33ccffee) rgba(00ff99ee) 45deg
    col.inactive_border = rgba(595959aa)
    layout = dwindle
}

# デコレーション設定
decoration {
    rounding = 10
    blur {
        enabled = true
        size = 3
        passes = 1
    }
    drop_shadow = yes
    shadow_range = 4
    shadow_render_power = 3
}

# アニメーション設定
animations {
    enabled = yes
    bezier = myBezier, 0.05, 0.9, 0.1, 1.05
    animation = windows, 1, 7, myBezier
}

拡張・プラグイン開発

// プラグインAPIの例
#include <hyprland/src/plugins/PluginAPI.hpp>

PLUGIN_API_VERSION 1

// プラグイン初期化
EXPORT void onPluginLoad(HANDLE handle) {
    // Hookの登録
    HyprlandAPI::addConfigValue(handle, "plugin:example:enabled", true);
    HyprlandAPI::registerCallbackDynamic(handle, "openWindow", 
        [&](void* self, void* data) { /* 処理 */ });
}

// hyprpmでインストール
hyprpm add https://github.com/example/plugin
hyprpm enable plugin-name

パフォーマンス・スケーラビリティ

パフォーマンス特性

メモリ使用量: 通常100-200MB（軽量）
CPU使用率: アイドル時<1%
レンダリング: 60-144FPSを安定して維持
最適化手法:
- ダメージトラッキングによる再描画最小化
- OpenGLバッファーの効率的な管理
- アニメーションのFPS制限
- テアリングサポートによるゲーミング最適化

スケーラビリティ

複数モニターの完全サポート
最大16K解像度まで対応
100以上のワークスペースを管理可能
大量のウィンドウでもパフォーマンス維持

制限事項

Wayland専用（X11は未サポート）
Linux専用（BSDは部分的サポート）
NVIDIA GPUは完全サポートされていない場合がある
一部のレガシーX11アプリケーションは互換性問題の可能性

評価・所感

技術的評価

強み

完全独立実装による高い制御性と柔軟性
最新C++標準を採用したモダンなコードベース
美しいビジュアルと実用性の両立
活発な開発とコミュニティ
強力なプラグインシステム
詳細なドキュメントとWiki
軽量で高速な動作

改善の余地

エンタープライズ向けサポートの拡充
スクリーンリーダー対応
テストカバレッジの向上
デバッグツールの拡充

向いている用途

パワーユーザー向けデスクトップ環境
開発者向けワークステーション
ゲーミングPC（テアリングサポート）
カスタマイズを重視するユーザー
タイリングWM愛好者

向いていない用途

初心者向けLinuxデスクトップ
安定性最優先のエンタープライズ環境
レガシーX11アプリケーションの利用が主体の環境
キーボード操作が困難なユーザー

総評

Hyprlandは、Waylandコンポジタの中でも特に野心的で革新的なプロジェクトです。既存のライブラリに依存しない完全独立実装という選択は、開発の難易度を上げる一方で、圧倒的な柔軟性とパフォーマンスを実現しています。

美しいビジュアルエフェクトと実用的なタイリング機能の融合は、他のコンポジタでは見られない特徴で、「見た目を犠牲にしない」というプロジェクトの理念が完全に実現されています。活発な開発と先進的な機能の積極的な採用により、今後も更なる発展が期待されるプロジェクトです。