hyprland-wiki/pages/Configuring/Configuring-Hyprland.md

55 lines
1.3 KiB
Markdown
Raw Normal View History

2022-10-19 18:14:08 +02:00
# Configuring Hyprland
2022-08-12 20:46:36 +02:00
The config is located in `~/.config/hypr/hyprland.conf`.
I recommend you 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.
2022-10-19 15:22:42 +02:00
However, some options may require a restart before taking effect.
2022-08-12 20:46:36 +02:00
2022-10-19 15:22:42 +02:00
Start a section with `name {` and end in `}` **_in separate lines!_**
2022-08-12 20:46:36 +02:00
2022-09-05 13:35:21 +02:00
{{< hint type=important >}}
2022-10-19 15:22:42 +02:00
The default config is _very_ barebones. Please refer to this wiki page and the pages
2022-09-05 13:35:21 +02:00
linked further down here for full configuration instructions.
2022-09-24 16:37:22 +02:00
**Make sure to read the "Variables" page as well**. It covers all the
2022-09-05 13:35:21 +02:00
toggleable / numerical options.
{{< /hint >}}
2022-10-19 18:14:08 +02:00
## Line style
2022-08-12 20:46:36 +02:00
2022-10-19 15:22:42 +02:00
Every config line is a command followed by a value.
2022-08-12 20:46:36 +02:00
2022-09-24 16:03:37 +02:00
```ini
2022-08-12 20:46:36 +02:00
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.:
2022-09-24 16:03:37 +02:00
```ini
2022-08-12 20:46:36 +02:00
COMMAND = VALUE
```
is valid.
2022-10-19 18:14:08 +02:00
## Basic configuring
2022-08-12 20:46:36 +02:00
To configure the "options" of Hyprland, animations, styling, etc. see
2022-09-24 16:37:22 +02:00
[Variables](../Variables).
2022-08-12 20:46:36 +02:00
2022-10-19 18:14:08 +02:00
## Advanced configuring
2022-08-12 20:46:36 +02:00
2022-10-19 15:22:42 +02:00
Some keywords (binds, curves, execs, monitors, etc.) are not variables but define
2022-08-12 20:46:36 +02:00
special behaviour.
2022-09-24 16:37:22 +02:00
See all of them in [Keywords](../Keywords) and the sidebar.