Launcher Window
This page documents how to customize the Vicinae launcher window. If you are looking for ways to programmatically control the window, consider using deeplinks.
Window sizing
For now it is not possible to change window dimensions. If you really need this, feel free to create a feature request.
Hyprland blur
All you need are the following layer rules in your Hyprland config:
# old rule syntax (Hyprland < 0.53)
# layerrule = blur, vicinae
# layerrule = ignorealpha 0, vicinae
# named rule syntax (Hyprland 0.53+)
layerrule {
blur = on
ignore_alpha = 0
match:namespace = vicinae
}
# anonymous rule syntax (Hyprland 0.53+)
# layerrule = blur on, ignore_alpha 0, match:namespace vicinae
You also need to make sure the window opacity is less than 1.0 in the Vicinae settings. It should default to a slightly transparent value.
Window scaling
It is possible to enable window scaling for Vicinae by setting the QT_SCALE_FACTOR environment variable to an appropriate value:
QT_SCALE_FACTOR=1.5 vicinae server
It is not recommended to set this value globally as it will force scaling for every QT app. If you need desktop-wide scaling you probably want your Wayland compositor to handle this for you. Only use this if you only need the Vicinae window to scale up or down.
Wayland Layer Shell
The layer shell wayland protocol is used to position the window and grant it exclusive keyboard focus as long as it is shown. The default behavior is to use it to position the launcher window if the running compositor supports it.
Note that the settings window is always set to be a regular floating window: it doesn't use layer shell under any circumstance.
Disable layer shell
If layer shell usage is not desired, you can disable it explicitly from the config file.
Font size
It is possible to change the base font size from within the settings.
Gnome Integration
Since Gnome doesn't natively support the layer shell protocol, the launcher window is always a regular floating window. To make it behave like a layer shell window which closes on focus loss, you can use the companion Vicinae Gnome Extension.