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.

• 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.

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
    }

See Also

• Official Hyprland wiki