Hyprland Wiki
Contribute to the Wiki! Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Configuring Hyprland

The config is located in ~/.config/hypr/hyprland.conf.

It is recommended to copy the examples/hyprland.conf, but you can also edit the autogenerated config.

By removing the line autogenerated=1 you’ll remove the yellow warning.

There is no “reload” keybind. The config is reloaded the moment you save it.

Start a section with name { and end in } in separate lines!

The default config is very barebones. Please refer to this wiki page and the pages linked further down here for full configuration instructions.

Make sure to read the “Variables” page as well. It covers all the toggleable / numerical options.

Line style

Every config line is a command followed by a value.

COMMAND=VALUE

The command can be a variable, or a special keyword (described further in this page)

You are allowed to input trailing spaces at the beginning and end.

e.g.:

COMMAND = VALUE

is valid.

Comments

Comments are started with the # character.

If you want to escape it (put an actual # and not start a comment) you can use ##. It will be turned into a single # that WILL be a part of your line.

Basic configuring

To configure the “options” of Hyprland, animations, styling, etc. see Variables.

Advanced configuring

Some keywords (binds, curves, execs, monitors, etc.) are not variables but define special behaviour.

See all of them in Keywords and the sidebar.