Hyprland

本 Wiki 页面是关于 Hyprland，一个基于 Wayland 的平铺式窗口管理器，具有炫酷的视觉效果、强大的插件以及更多功能。

请参阅 Hyprland 教程 以开始使用 Hyprland。

注意： 在安装任何桌面环境之前，

• 确保您已连接互联网 网络。如果测试失败，请先设置您的 互联网连接，然后再继续操作。
• 如果您在 安装 过程中跳过了此步骤，出于安全原因，请创建一个非特权 用户账户。
• 启用 community 仓库。
• 为您的视频硬件安装 图形驱动。

setup-wayland-base 脚本安装并启用 elogind 作为 会话管理器，启用 community 仓库，并自动启用 eudev，因为这些是 Wayland 正常工作所必需的。

安装

使用以下命令安装软件包 hyprland

# apk add hyprland

故障排除

黑/品红色棋盘格背景：Hyprland 未能加载 1 个必要的资源

从 Hyprland 0.45.0 版本开始，如果您没有安装他们的壁纸，上游会显示一条吓人的消息（和一个丑陋的图形）。

当您启动 壁纸工具 后，丑陋的图形就会消失，但吓人的消息仍然存在。

解决此问题的规范方法是使用以下命令安装 hyprland-wallpapers 软件包

# apk add hyprland-wallpapers

或者您可以将一些文件放在 /usr/share/hypr/wall0.png 或 /usr/local/share/hypr/wall0.png，并修改您的配置文件，添加如下行

~/.config/hypr/hyprland.conf 的内容

misc {
        force_default_wallpaper = 0
    }

Hyprland 几乎立即崩溃

Hyprland 0.46 有一个 bug，如果未安装 Xwayland，默认配置将会崩溃。您可以安装 xwayland，或者在您的配置中禁用它

~/.config/hypr/hyprland.conf 的内容

xwayland:enabled = false

这应该会在下一次更新中修复。

关于 hyprland-qtutils 的警告消息

Hyprland 0.46 及更高版本建议您安装 hyprland-qtutils，但目前 alpine 中没有提供。

您的系统未安装 hyprland-qtutils。这是某些对话框的运行时依赖项。请考虑安装它。

您可以像这样在您的配置中禁用此检查

~/.config/hypr/hyprland.conf 的内容

misc:disable_hyprland_qtutils_check = true

参见

• Hyprland 官方 Wiki