Hyprland Quickstart

This guide shows the best way to quickly get started with Vicinae on Hyprland.

Main configuration

Add the following to your Hyprland configuration, and you are good to go.

# ~/.config/hypr/hyprland.conf

exec-once = vicinae server

# use whatever shortcut floats your boat
bind = $mainMod, Space, exec, vicinae toggle

# blur
layerrule = blur,vicinae
layerrule = ignorealpha 0, vicinae

# disable fade animation for vicinae only
layerrule = noanim, vicinae

Bind to a custom command

You can easily create a binding to open any vicinae command directly:

# ~/.config/hypr/hyprland.conf

bind = $mainMod, P, exec, vicinae vicinae://extensions/vicinae/clipboard/history

You can do a lot with this: learn more about deeplinks.

Focus window on activation

You may want to focus an application window after vicinae triggers an action related to it. For example : using a shortcut action in vicinae that opens a browser tab → Instantly focus the window where the action happened

You can have this behavior by having this to your config:

misc {
    focus_on_activate = true
}