hyprland-wiki/pages/Configuring/_index.md

2.2 KiB

weight title sidebar
3 Configuring
open
true

The config is located in $XDG_CONFIG_HOME/hypr/hyprland.conf. In most cases, that maps to ~/.config/hypr/hyprland.conf.

You can tell Hyprland to use a specific configuration file by using the --config (or -c) argument.

Hyprland will automatically generate an example config for you if you don't have one. You can find an example config here.

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

The config is reloaded the moment you save it. However, you can use hyprctl reload to reload the config manually.

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

{{< callout >}}

The default config is not complete and does not list all the options / features of Hyprland. 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.

{{< /callout >}}

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)

The trailing spaces at the beginning and end of words are not necessary, and are there only for legibility.

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.

Escaping errors

If you use plugins, you may want to ignore errors from missing options/keywords so that you don't get an error bar before they are loaded. To do so, do this:

# hyprlang noerror true

bind = MOD, KEY, something, amogus
someoption = blah

# hyprlang noerror false

Basic configuring

To configure Hyprland's options, animations, styling, etc. see Variables.

Advanced configuring

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

See all of them in Keywords and the sidebar.