Hyprland
This wiki page is about Hyprland, a wayland based tiling compositor with all the eyecandy, powerful plugins and much more.
Refer to hyprland Tutorial to get started on using Hyprland.
- Setup your Internet access, if not done already, before you proceed further.
- Create a non-privileged user account for security reasons, if you skipped this step during Installation.
- Enable community repository.
- Install graphics driver for your video hardware.
The setup-wayland-base script installs and enables elogind as seat manager, enables community repository and enables eudev automatically as these are required for Wayland to work.
Installation
Install the package hyprland using the command:
# apk add hyprland
Troubleshooting
Black/Magenta checkerboard background: Hyprland failed to load 1 essential asset
As of Hyprland 0.45.0, upstream shows a scary message (and an ugly graphic) if you don't have their wallpapers installed.
The ugly graphic goes away when you've launched a wallpaper utility, but the scary message remains.
The canonical way to solve this is to install hyprland-wallpapers package using the command:
# apk add hyprland-wallpapers
Or you can just have some file at /usr/share/hypr/wall0.png or /usr/local/share/hypr/wall0.png and modify your config file to have a line as follows:
Contents of ~/.config/hypr/hyprland.conf
misc {
force_default_wallpaper = 0
}Hyprland crashes almost immediately
Hyprland 0.46 has a bug where the default configuration will crash if Xwayland is not installed. You can either install xwayland, or disable in your config:
Contents of ~/.config/hypr/hyprland.conf
xwayland:enabled = false
This should be fixed in the next update.
warning message about hyprland-qtutils
Hyprland 0.46 and newer suggest you install hyprland-qtutils, which is currently not available in alpine.
Your system does not have hyprland-qtutils installed. This is a runtime dependency for some dialogs. Consider installing it.
You can disable the check in your config like so:
Contents of ~/.config/hypr/hyprland.conf
misc:disable_hyprland_qtutils_check = true