Hyprland Config

Wayland tiling compositor — modular config split by concern.

Wayland tiling compositor. Modular config split by concern.

Files

  • hyprland.conf — entry point, autostart, monitor/workspace rules
  • keybinds.conf — all bindings, sourced from main
  • plugins.conf — hyprexpo and others
  • theme_0-53.conf — generated by Theme Switcher Script; do not edit directly

Environment Variables

The environment is stabilized through a set of core variables in hyprland.conf.

VariableValuePurpose
XCURSOR_SIZE24Standardizes cursor scaling across XWayland and Wayland.
HYPRCURSOR_SIZE24Native Hyprland cursor scaling.
$terminalkittyGlobal terminal alias.
$fileManagerthunarGlobal GUI file manager alias.
$menuwofi --show drunApplication launcher entry point.

Monitor Topology

The system utilizes a fixed-assignment topology. Rather than letting workspaces float between screens, they are anchored to specific hardware outputs.

# --- Monitor Layout ---
monitor=HDMI-A-1,1920x1080@60,auto,1
monitor=eDP-1,preferred,auto,1

# --- Hardware Binding ---
workspace=1..5,  monitor:HDMI-A-1  # Primary Desktop
workspace=6..10, monitor:eDP-1     # Secondary Laptop Screen

This creates a predictable spatial workflow where specific tasks always live on specific monitors.

Generative Rules

The compositor enforces an aesthetic through rules. Themes like koi-pond inject specific opacity levels:

windowrule {
    match:class = kitty
    opacity = 0.85 0.88 # Active/Inactive split
}
windowrule {
    match:class = firefox
    opacity = 0.92 0.95
}

Mod

$mainMod = SUPER