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.

Prerequisites

• Internet connectivity, unless the packages have been pre-fetched into a local cache.
• Install appropriate Graphics driver drivers for your hardware. Without graphics drivers, errors are likely to occur when starting your desktop.
• A non-root user account.
• The community repository must be enabled.
• Set up eudev.
• Install and enable D-Bus. Without D-Bus, icons and keyboard shortcuts may be missing.
• Install wayland-base.This enables elogind as seat manager, enables community repository and enables eudev.

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

See Also

• Official Hyprland wiki