Hyprland-0.52.1

Introduction to Hyprland

Hyprland is an independent Wayland compositor aiming to have more features than other Wayland compositors and be highly customizable, written in C++.

[Important]

Important

Be sure to update all the libraries in Hypr Libraries prior to updating this package to prevent configuration failures, and note that doing so will break ABI against the present version of Hyprland until you rebuild it. In most cases, Hyprland will still be running if the libraries have been updated while in the session, however. In any case, rebuild/update this package immediately after upgrading Hypr Libraries.

[Note]

Note

This may take a while to build. Feel free to do something else while this is building.

Additional Downloads

Hyprland Dependencies

Required

Cairo, CMake, elogind, GBM (libgbm or Mesa), glaze-6.0.3, GLib2, Glslang, Hypr Libraries, libdisplay-info, libdrm, libinput, libliftoff-0.5.0, libxkbcommon, OpenGL + EGL + GLESv2 (libglvnd or Mesa; Mesa's GL is not supported), Pango (with Cairo), Pixman, re2-2025-08-12, seatd-0.9.1, toml++-3.4.0, Vulkan-Loader, Wayland, Wayland-Protocols, XCB Utilities, xcb-util-errors-1.0.1, and Xorg Libraries

Recommended

Optional

cpio (to build and install plugins)

Installation of Hyprland

Extract the udis86 submodule in place:

tar -xf ../udis86-5336633af70f3917760a6d441ff02d93477b0c86.tar.gz &&
mv -T udis86-5336633af70f3917760a6d441ff02d93477b0c86 subprojects/udis86

Install Hyprland by running the following commands:

mkdir build &&
cd    build &&

cmake -D CMAKE_INSTALL_PREFIX=/usr   \
      -D CMAKE_BUILD_TYPE=Release    \
      -D CMAKE_SKIP_INSTALL_RPATH=ON \
      -D BUILD_TESTING=OFF           \
      -W no-dev -G Ninja .. &&
ninja

Now, as the root user:

ninja install

Configuring Hyprland

Config Files

~/.config/hypr/hyprland.conf. The default version is in /usr/share/hypr and will not be used and must be copied to ~/.config/hypr

Configuration Information

Create the config file:

mkdir -pv ~/.config/hypr &&
cp /usr/share/hypr/hyprland.conf ~/.config/hypr

Now inspect the file and make any changes to suit your workflow.

Contents

Installed Programs: hyprctl, hyprland (link to Hyprland), Hyprland, and hyprpm
Installed Libraries: None
Installed Directories: /usr/include/hyprland, /usr/share/hypr, and /usr/share/wayland-sessions

Short Descriptions

hyprctl

retrieves and configures information about the current instance of Hyprland

hyprland

is a symlink pointing to Hyprland

Hyprland

is the Hyprland compositor

hyprpm

is the plugin manager for Hyprland