Keywords
Keywords are not variables, but “commands” for more advanced configuring. On this page, you will be presented with some that do not deserve their own page.
See the sidebar for more keywords to control binds, animations, monitors, et cetera.
Please remember, that for ALL arguments separated by a comma, if you want to leave one of them empty, you cannot reduce the number of commas, unless told otherwise in a specific section:
three_param_keyword = A, B, C # OK three_param_keyword = A, C # NOT OK three_param_keyword = A, , C # OK three_param_keyword = A, B, # OK
you can execute a shell script on startup of the compositor or on each time it’s reloaded.
exec-once=command will execute only on launch
exec=command will execute on each reload
You can define your own custom variables like this:
$VAR = value
for example:
$MyFavoriteGame = Among Us
then, to use them, simply use them. For example:
col.active_border=$MyColor
You ARE allowed to do this:
col.active_border=ff$MyRedValue1111
Use the source keyword to source another file.
For example, in your hyprland.conf you can:
source=~/.config/hypr/myColors.conf
And Hyprland will enter that file and parse it like a Hyprland config.
Please note it’s LINEAR. Meaning lines above the source= will be parsed first,
then lines inside ~/.config/hypr/myColors.conf, then lines below.
Use something like
libinput-gestures, with
hyprctl if you want to expand Hyprland’s gestures beyond what’s offered in
Variables.
Per-device config options will overwrite your options set in the input
section. It’s worth noting that ONLY values explicitly changed will be
overwritten.
In order to apply per-device config options, make a new category like this:
device:name {
}
The name can be easily obtained by doing hyprctl devices.
Inside of it, put your config options. All options from the input category
(and all subcategories, e.g. input:touchpad) can be put inside, EXCEPT:
force_no_accel, follow_mouse, float_switch_override_focus
Properties that change names:
touchdevice:transform -> touch_transform
touchdevice:output -> touch_output
Additional properties only present in per-device configs:
enabled -> (only for mice / touchpads) enables / disables the device (connects / disconnects from the on-screen cursor) - default: Enabled
Example config section:
device:royuan-akko-multi-modes-keyboard-b {
repeat_rate=50
repeat_delay=500
middle_button_emulation=0
}
remember about the space after the end of the device’s name (before the {)!
The hyprland background you see when you first start Hyprland is NOT A WALLPAPER, it’s the default image rendered at the bottom of the render stack.
To set a wallpaper, use a wallpaper utility like hyprpaper or swaybg.
More can be found in Useful Utilities.
LayerSurfaces are not windows. These are for example: Your wallpapers, notification overlays, bars, etc.
If you really want to blur them, use blurls=
blurls=NAMESPACE
where NAMESPACE is the namespace of the layerSurface. (You can get it from
hyprctl layers)
To remove a namespace from being blurred (useful in dynamic situations) use:
blurls=remove,NAMESPACE