The desktop

Hyprland configuration

A complete Hyprland setup, with your own file loaded last.

Package: hyprnux-hyprland
License: GPL3
Needs: Hyprland 0.56 or latersystemd 254 or later
Without the shell: Works on its own

What it does

A working desktop at first login

Shortcuts, window rules, spring animations, touchpad gestures and monitor defaults are all set. The shortcuts are listed in Settings, under Shortcuts.

Five layers, yours last

Defaults, then packages, then this machine, then the files Settings writes, then your own ~/.config/hypr/custom.lua. A later layer beats an earlier one.

The session services

Starts the screen-idle service, the clipboard history and the location service with Hyprland. To turn one off: systemctl --user mask <unit>.

Why you would want it

Your changes are never overwritten

custom.lua is a starter file for new accounts and an update does not touch yours. Every Hyprnux rule has a name, so you can switch one off without copying it.

Read the guide

A broken file does not break the session

A file with an error is reported, and the other files still load. If no bind could be made, Hyprland’s own emergency shortcuts take over.

Installs without the shell

The shell is optional. Without it, the power menu, screen recording and the lock screen that closing the lid calls are not available.

After you install it

Log out, choose the Hyprland session on your login screen and sign in. An account with no ~/.config/hypr/hyprland.lua uses the configuration.
Press Super + Return for a terminal, Super + E for the file manager, Super + Q to close a window. Super is the Windows key, or the Command key on a Mac keyboard.
Put your own changes in ~/.config/hypr/custom.lua.

Install it on its own

Before you start. Hyprland 0.56 or later and systemd 254 or later.

Packaged for pacman, on Arch Linux. Add the Hyprnux repository once first: Install Hyprnux. On another distribution, build it from its sources.

sudo pacman -S hyprnux-hyprland

With a ~/.config/hypr/hyprland.lua of your own, add this line to it once:

require("/usr/share/hyprnux/hyprland/hyprland")

The pacman package is for Arch Linux, where foot, nemo, gnome-keyring, hypridle and the other dependencies come from the Arch repositories.

Remove it

sudo pacman -Rns hyprnux-hyprland

If something goes wrong, see the install guide.