hyprland-wiki/pages/Configuring/_index.md
2024-10-18 15:41:24 +01:00

1.5 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 >}}

Language style and syntax

See the hyprlang page.

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.