Guides:Installing Hyprland

This section will change overtime, as such, you should probably follow the official installation guide instead.

To install Hyprland, it is recommended to use a rolling release or a semi-rolling release distributions. Most recommended ones include Arch Linux, Gentoo, NixOS, Fedora and openSUSE (Tumbleweed) due to them having the most recent packages as Hyprland is a bleeding edge window manager.

You must also install kitty if you do not have an existing configuration or existing dotfiles you want to try.

Arch Linux

By far the easiest one to install Hyprland on, you just run this command:

sudo pacman -S hyprland --needed

The --needed flag is to make sure that you do not reinstall Hyprland.

NixOS

Just enable Hyprland in your NixOS configuration by adding:

programs.hyprland.enable = true;

openSUSE (Tumbleweed)

It is quite simple here also, you can just simply run:

sudo zypper install hyprland

Alternatively, you can install it via YaST2 Software, you can also try manual building if you are not on Tumbleweed. It is not recommended to use Hyprland on other versions than Tumbleweed.

Fedora

You must have the latest version of Fedora installed, if so run the following:

sudo dnf install hyprland

You can also install the hyprland-devel package to build plugins.

Gentoo

You can edit some USE flags like:

• X : To add support for X11.
• legacy-renderer : to enable the Legacy renderer.
• systemd : Enable use of specific systemd libraries like socket activation or session tracking.

But, it is not necessary to edit any of these USE flags and should be able to manually build using:

emerge --ask gui-wm/hyprland # please run as root

Ubuntu 23.04

WARNING: Not recommended by the Hyprland developers as it is potentially unsafe for other packages on a system.

This can lead to system breakages so we are not including it in this article but you can read this article. Please do note that this is long and tedious and may require you to manually build extremely lengthy packages and/or dependency hell since most dependencies on the Ubuntu repositories can be outdated.

Slackware

For Slackware, you might need to use the SlackBuilds repository which has the hyprland-bin package.

Void Linux

Hyprland is not available for Void Linux from the official repositories as Hyprland doesn’t build against tagged wlroots, however template files are available from a third party which can build Hyprland using xbps-src. The README has a pretty good explanation on how to install and use it.

For a manual releases install and for a manual build install you can check the Hyprland wiki.

Configuration

This is a pretty verbose topic but is very simple for new users. Hyprland configuration files are generally suffixed with a .conf extension and are quite simple to read because almost everything is a variable. The Hyprland Wiki has a step above but this guide will teach you pretty much everything you need to know. Your configuration file is located at ~/.config/hypr/hyprland.conf and can contain configurations of programs that are under the hypr-ecosystem.

This topic is divided into 6 sub-sections:

• Variables
• Section-specific variables
• Binding Keys
• Binding Special Keys
• Animations
• Monitors

Variables

This is the most important part of your configuration file because it is most of your whole configuration file, the entire hyprland.conf is comprised of a syntax like:

variable = arg1, arg2, arg3, arg4

Each line is required to have 3 commas, however not 4 arguments, for example you can do:

monitor =,preferred,auto,1 # this is actually part of your auto-generated configuration file

There are some exceptional cases where all 3 commas are not necessary like the exec-once command but most of the time it does require 3 commas.