Hyprland 0.55.3をインストールしました。
現在の構成は以下の通り。

$ pacman -Q hyprland quickshell caelestia-cli caelestia-shell
hyprland 0.55.3-1
quickshell-git 0.2.0.r148.g8db8ca1-1
caelestia-cli 1.0.8-1
caelestia-shell 2.0.2-1

2026-06-27

設定ファイルのlua言語対応

  1. Caelestiaの強制アップデート
    paru
    git -C ~/.local/share/caelestia fetch origin main
    git -C ~/.local/share/caelestia reset --hard origin/main
  2. 設定ファイルの変換
    paru -S hyprlang2lua
    cd ~/.config/caelestia
    hyprlang2lua hypr-user.conf > hypr-user.lua
  3. 表記の補正
    ~/.config/caelestia/hypr-user.lua
    キーバインドのCtrl+AltCTRL + ALTに置換
  4. 変数設定の移植
    ~/.config/caelestia/hypr-vars.lua
    return {
    browser = "google-chrome-stable",
    editor = "code",
    fileExplorer = "thunar",
    windowGapsOut = 20,
    workspaceSwipeFingers = 3,
    volumeStep = 5,
    }
  5. 各種ツールの誤認識を防ぐために設定ファイルをリネーム
    mv ~/.config/hypr/hyprland.conf ~/.config/hypr/hyprland.conf~

変化点

Hyprland

Caelestia

調査

Hyprland

  • luaへの完全移行は0.57〜0.58くらい?
    https://hypr.land/news/update55/

    This does not mean your hyprlang config is now broken - it will still work, for a few releases.

  • 設定ファイルは~/.config/hypr/hyprland.lua
  • サンプル
    https://github.com/hyprwm/Hyprland/blob/main/example/hyprland.lua
  • グローバル変数hlで設定する
  • ファイル分割(参照先ファイルの拡張子は不要で.の扱いが変則的)
    -- refers to $XDG_CONFIG_HOME/hypr/awesomeconf/keybinds.lua
    require("awesomeconf/keybinds")

    -- refers to $XDG_CONFIG_HOME/hypr/awesomeconf/animation.lua
    require("awesomeconf.animation")
  • 変換ツール
    paru -S hyprlang2lua
    hyprlang2lua ~/.config/hypr/hyprland.conf > ~/.config/hypr/hyprland.lua
    mv ~/.config/hypr/hyprland.conf ~/.config/hypr/hyprland.conf~

Caelestia

対策