1 hypr
Luca Matteo Spoljarevic edited this page 2026-02-27 21:44:07 +01:00
This file contains ambiguous Unicode characters

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 110, 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).
  • 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 contain hyprstart.conf, Informations/ (e.g. XF86 key reference), and optional alternate configs.

  • Other files e.g. hyprpaper-*.conf (alternate wallpapers), hyprlock.conf.sakoora and sakoora.hyprlock/ (theme/variant), HyprLock/ (lock assets like lockscreen.png, user.jpg).

How to use it

  1. Install Hyprland, hyprpaper, hypridle, hyprlock, and any tools your keybinds use (terminal, launcher, screenshot, etc.).
  2. Copy or symlink this folder to ~/.config/hypr/.
  3. Edit paths in hyprpaper.conf and hyprlock.conf to your wallpaper and lock images (e.g. $HOME/Pictures/..., HyprLock/lockscreen.png, user.jpg).
  4. In HyprSource/hypraliases.conf (and keybinds), set $terminal, $menu, $lockscreen, and other commands to match your system.
  5. 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