Table of Contents
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Hypr
Hypr is the Hyprland compositor setup: window manager, wallpapers, lock screen, and idle/sleep behaviour. Config is split across the main config and sourced files in HyprSource/.
What the config does
-
hyprland.conf– Entry point; sources (in order):- hyprgpu.conf – Nvidia/GPU settings.
- hyprmonitor.conf – Default monitor and display rules.
- hypraliases.conf – Variables (e.g.
$terminal,$menu,$lockscreen,$volume,$brightness). - hyprstart.conf – Autostart: waybar, hypridle, hyprpaper, dunst, mpd; Mullvad; cliphist for clipboard; polkit agent.
- hyprenv.conf – Environment (e.g. XDG, themes).
- hyprkeybinds.conf – Key bindings: apps (terminal, launcher, lock, screenshot, browser, etc.), workspaces 1–10, move focus, move windows, media/brightness, etc.
-
hyprpaper.conf– Wallpapers:- Preloads several images (Linux/Arch/RHEL/BlackArch, Ansible).
- Per-monitor wallpaper (e.g. DP-2, DVI-D-1) with paths and
fit_mode = cover. splash = false.
-
hypridle.conf– Idle/sleep/lock:- Lock with
hyprlock; before sleep = lock session, after sleep = dpms on. - Timeouts: dim backlight (150 s), lock (300 s), dpms off (330 s), suspend (900 s).
- Lock with
-
hyprlock.conf– Lock screen:- Background image, contrast/brightness/vibrancy; optional time/date labels; lock icon; user image and name; input field and styling.
-
HyprSource/– Sourced configs (see above). May also containhyprstart.conf,Informations/(e.g. XF86 key reference), and optional alternate configs. -
Other files – e.g.
hyprpaper-*.conf(alternate wallpapers),hyprlock.conf.sakooraandsakoora.hyprlock/(theme/variant),HyprLock/(lock assets likelockscreen.png,user.jpg).
How to use it
- Install Hyprland, hyprpaper, hypridle, hyprlock, and any tools your keybinds use (terminal, launcher, screenshot, etc.).
- Copy or symlink this folder to
~/.config/hypr/. - Edit paths in
hyprpaper.confandhyprlock.confto your wallpaper and lock images (e.g.$HOME/Pictures/...,HyprLock/lockscreen.png,user.jpg). - In
HyprSource/hypraliases.conf(and keybinds), set$terminal,$menu,$lockscreen, and other commands to match your system. - Start Hyprland (e.g. from Ly or a Wayland session). Waybar, hypridle, hyprpaper, and dunst start via
hyprstart.conf.
File reference
| File / folder | Purpose |
|---|---|
hyprland.conf |
Main entry; sources all other configs |
hyprpaper.conf |
Wallpaper preload and per-monitor assignment |
hypridle.conf |
Idle timeouts: dim, lock, dpms, suspend |
hyprlock.conf |
Lock screen look and behaviour |
HyprSource/ |
GPU, monitor, env, aliases, keybinds, autostart |
HyprLock/ |
Lock screen images and assets |