Hyprland

Configuration Tree

. 📂 ~/.config/hypr
└── 📂 animations/
├── 📄 animations.conf
├── 📄 hyde.conf
├── 📄 hypridle.conf
├── 📄 hyprland.conf
└── 📂 hyprlock/
├── 📄 hyprlock.conf
├── 📄 keybindings.conf
├── 📄 monitors.conf
├── 📄 nvidia.conf
└── 📂 themes/
│ ├── 📄 colors.conf
│ ├── 📄 theme.conf
│ ├── 📄 wallbash.conf
├── 📄 userprefs.conf
└── 📄 windowrules.conf
├──
. 📂 ~/.local/share/hyde
│ ├── 📄 hyprland.conf

HyDE’s Hyprland Configuration

Since Hyprland sources ~/.config/hypr/hyprland.conf, HyDE divides its configuration into three sections:

Boilerplate
Overrides
Users

1. Boilerplate

This section contains the default configuration of HyDE, which you are recommended not to modify directly.

Filepath: $XDG_DATA_HOME/hyde/hyprland.conf

This file is sourced on top of other configurations in ~/.config/hypr/hyprland.conf.

# Boilerplate configuration
source = ~/.local/share/hyde/hyprland.conf

2. Overrides

This section is for overriding HyDE’s default configuration.

To override HyDE’s default Hyprland settings, configure these sections in your config.toml:

[hyprland] - Application defaults, theming, and display settings
[hyprland-start] - Startup commands and services

Configuration File: ~/.local/share/hyde/schema/config.toml

For detailed options, see:

3. Users

This section is for user configuration, which you may adjust as needed.

Filepaths:

$XDG_CONFIG_HOME/hypr/keybindings.conf
$XDG_CONFIG_HOME/hypr/windowrules.conf
$XDG_CONFIG_HOME/hypr/monitors.conf
$XDG_CONFIG_HOME/hypr/userprefs.conf

You will likely need to configure only these files; you can override Hyprland’s variables, so change them as you wish.

Also, Hyprland can hot reload the configuration files, so you can edit them and immediately see the changes.

If you wish to be safe about editing the default configuration, copy it to a backup location first:

cp ~/.local/share/hyde/schema/config.toml ~/config.toml.bak

Or better yet, just stick to messing with ~/.config/hypr, I recommend editing userprefs.conf if you’d like to add a keyboard layout (which you can then switch with super + k), windowrules.conf if you’d like to enable full transparency by changing the layer rules at the bottom, or just leaving them as they comfortably are.

Now you should know which file is which. Refer to the Hyprland Wiki for more information to achieve your perfect desktop experience.

For details on how UWSM manages your system at a service level and session environment variables, see Autostart & UWSM. Also see FAQs and Tips.