Date 2025-12-30

Hyprland - 雑にアプデしたら hyprpaper が動かない

  tech ,  hyprland ,  hyprpaper

GPD Pocket 3 に Arch + Hyprland を入れてるんだけど、 引き篭もり生活だからノート PC 使わなくて、 月1くらいでしか起動してない。

で、久々に起動して雑に pacman -Syu したところ、 hyprpaper で設定しているはずの背景が設定されなかった。

原因

hyprpaper.conf の設定の書き方が古かった。

ちゃんと追ってなかったのでいつからか分からないけど、 設定ファイルの記述方法が変わった模様。

https://wiki.hypr.land/Hypr-Ecosystem/hyprpaper/#configuration

対応

hyprpaper.conf を新しいフォーマットで書き直した。

古いやつ

preload = /home/mitsu/media/wallpapers/wallpaper.png
wallpaper = , /home/mitsu/media/wallpapers/wallpaper.png

更新後

wallpaper {
  monitor =
  path = ~/media/wallpapers/wallpaper.png
  fit_mode = cover
}

全てのモニタに同じ画像を設定する場合は monitor = でいいっぽい。

バージョン

一応、現在のバージョン。

% hyprctl version
Hyprland 0.53.0 built from branch v0.53.0 at commit ea444c35bb23b6e34505ab6753e069de7801cc25 clean (version: bump to 0.53.0).
Date: Mon Dec 29 15:21:36 2025
Tag: v0.53.0, commits: 6756

Libraries:
Hyprgraphics: built against 0.5.0, system has 0.5.0
Hyprutils: built against 0.11.0, system has 0.11.0
Hyprcursor: built against 0.1.13, system has 0.1.13
Hyprlang: built against 0.6.7, system has 0.6.7
Aquamarine: built against 0.10.0, system has 0.10.0

Version ABI string: ea444c35bb23b6e34505ab6753e069de7801cc25_aq_0.10_hu_0.11_hg_0.5_hc_0.1_hlg_0.6
no flags were set


% hyprpaper -h
┏ hyprpaper v0.8.0
┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┣ --config  -c [str]  | Set a custom config path                                 ┃
┣ --verbose           | Enable more logging                                      ┃
┣ --help    -h        | Show the help menu                                       ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

おわり

hyprland は結構活発に開発が続いているので、 ちゃんと追ってかないとスッと置いていかれてしまう……!