Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Noro18/linux-ricing-dotfiles/llms.txt
Use this file to discover all available pages before exploring further.
Hyprland is the Wayland compositor at the center of this setup, managing window layout, borders, shadows, animations, and workspaces. Its configuration is split across several modular files so that the auto-generated color theme stays cleanly separated from hand-edited settings like keybinds and monitor layout.
File structure
~/.config/hypr/
├── hyprland.conf # Main config — imports all other files
├── hyprland-gui.conf # Visual appearance: borders, shadows, rounding, blur
├── colors/
│ └── colors.conf # ⚠ Generated by matugen on wallpaper change — do not edit
├── configurations/ # Modular configs (keybinds, monitors, etc.)
├── scripts/ # Helper scripts (e.g. matu.sh for color generation)
├── hypridle.conf # Idle timeout configuration
├── hyprlock.conf # Lock screen configuration
├── hyprpaper.conf # Wallpaper daemon configuration
├── hyprsunset.conf # Sunset/sunrise color temperature adjustment
├── plugins.conf # Plugin loading configuration
├── env # Environment variables
├── monitors.conf # Monitor layout and resolution
├── workspaces.conf # Workspace rules and names
└── windows-mode.conf # Windows-specific behavior tweaks
How the files relate
hyprland.conf is the entry point. It sources every other config file at startup:
source = ~/.config/hypr/colors/colors.conf
source = ~/.config/hypr/monitors.conf
source = ~/.config/hypr/workspaces.conf
source = ~/.config/hypr/configurations/keybinds.conf
hyprland.conf, the GUI overrides are loaded last so they can override any defaults set earlier:
source = /home/noro18/.config/hypr/hyprland-gui.conf
hyprland-gui.conf has final say over all visual settings. The file itself is managed by HyprMod and should not be edited by hand — use HyprMod’s interface to change visual settings, or adjust the Matugen template to change how colors are applied.
How colors work
Hyprland gets its colors from Matugen, which generates a Material You palette from the current wallpaper and writes it to a single file.
| File | Generated by | When |
|---|
~/.config/hypr/colors/colors.conf | matugen | On every wallpaper change |
colors.conf defines variables like $primary, $background, $surface_container_low, and others that are referenced throughout hyprland.conf and hyprland-gui.conf.
To change how Material You color tokens map to Hyprland variables, edit the Matugen template at ~/.config/matugen/templates/hyprland-colors.conf. This is the right place to remap, for example, which token drives the active border color.
Key configuration files
hyprland-gui.conf
This file controls all visual appearance and is written by HyprMod. The actual values in the repo show what the settings look like:
# Generated by HyprMod
decoration:blur:brightness = 0.77
decoration:blur:contrast = 0.84
decoration:blur:noise = 0.007
decoration:blur:passes = 3
decoration:blur:size = 2
decoration:dim_special = 0.25
decoration:dim_strength = 0.25
decoration:fullscreen_opacity = 0.9
decoration:rounding = 18
decoration:rounding_power = 4.4
decoration:shadow:color = 0xac090202
decoration:shadow:color_inactive = 0xac090202
decoration:shadow:enabled = 1
decoration:shadow:offset = 1 2
decoration:shadow:range = 14
decoration:shadow:render_power = 4
general:border_size = 0
general:col.active_border = 0xff3d3846 0deg
general:extend_border_grab_area = 50
general:gaps_in = 8
general:gaps_out = 16
general:resize_on_border = 0
general:col.active_border holds a hex color rather than a $variable reference — this value is what HyprMod writes based on the current Matugen output. Shadow colors are also set here as static hex values.
keybinds.conf
Keyboard shortcuts for launching apps, switching workspaces, and controlling the compositor. Sourced from ~/.config/hypr/configurations/keybinds.conf.
monitors.conf
Monitor layout, resolution, refresh rate, and position. Edit this file to configure multi-monitor setups.
workspaces.conf
Workspace names, rules, and window assignment rules. Controls which apps open on which workspace.
hypridle.conf
Defines idle actions such as dimming the screen, locking, or suspending after a configurable period of inactivity.
hyprlock.conf
Configures the lock screen appearance — background, clock, password field, and any overlay widgets.
hyprsunset.conf
Adjusts the display color temperature based on time of day (warmer in the evening, neutral during the day).
Never edit ~/.config/hypr/colors/colors.conf by hand. It is overwritten by Matugen every time the wallpaper changes, so any manual edits will be lost immediately.