If you’re on Void Linux and want a desktop that feels like it came from the future, Hyprland is your move. But unlike other distros, Void doesn’t support it out of the box.

Here’s a quick and clean guide to get Hyprland running.

1. Add the Hyprland Repository

Create a config file to add the custom repo:

echo repository=https://raw.githubusercontent.com/Makrennel/hyprland-void/repository-x86_64-glibc | sudo tee /etc/xbps.d/hyprland-void.conf

This tells xbps where to find the latest Hyprland builds for Void.

2. Update the Repositories

Refresh the package list and accept the new repo’s fingerprint:

sudo xbps-install -S

3. Install Hyprland

Now install Hyprland along with the optional XDG desktop portal package:

sudo xbps-install -S hyprland xdg-desktop-portal-hyprland

This gets you the compositor and portal integration for better app compatibility. Now you have installed hyprland successfully on void linux.

4. Check for Related Packages (Optional)

Want lock screens? Wallpapers? Idle dimming? Just do:

xbps-query -Rs hypr

• hyprlock – for locking
• hypridle – for idle stuff
• hyprpaper – for wallpaper

5. Different Architecture?

This tutorial used x86_64-glibc. If you’re using:

• x86_64-musl
• aarch64-glibc
• aarch64-musl

Just change the URL in your .conf file to match your setup.

Huge Thanks to Makrennel

This guide wouldn’t exist without Makrennel’s hyprland-void repo. They’re maintaining this so you don’t have to build from source or cry into your terminal.