Launcher Window

This page documents how to customize the Vicinae launcher window. If you are looking for ways to programatically 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:

layerrule = blur,vicinae
layerrule = ignorealpha 0, 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, it can be turned off at runtime by passing the USE_LAYER_SHELL=0 environment variable to the vicinae process, like so:

USE_LAYER_SHELL=0 vicinae server

Layer shell support can also be disabled at compile time, although that option is only available to users compiling from source. Using the runtime environment variable is the preferred way to opt out of layer shell, as most binary releases will be compiled with support for it.

Gnome Integration

Since Gnome doesn't natively suppot 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.