Configuration
Window Settings
Configure launcher size, backdrop, and transparency
Launcher Size
Set the dimensions of the launcher panel:
launcher_size = [800.0, 500.0] # [width, height] in pixels| Property | Default | Recommended Range |
|---|---|---|
| Width | 600.0 | 300 – 2000 px |
| Height | 400.0 | 200 – 1500 px |
Window Size (VRAM Optimization)
When using a backdrop overlay, set an explicit buffer size to reduce VRAM usage:
window_size = [1920.0, 1080.0]Only set this if you experience high VRAM usage. It must be at least as large as launcher_size.
Default: Automatic (8K on most compositors, 1920×1080 on KDE)
Backdrop
The backdrop is a transparent overlay behind the launcher. Clicking it hides the launcher.
enable_backdrop = true # defaultWhen disabled, the launcher window is just the panel—no click-outside-to-close behavior.
Transparency
Enable transparent background rendering:
enable_transparency = true # defaultHyprland Auto Blur
Automatically apply Hyprland blur rules via IPC:
hyprland_auto_blur = true # defaultThis applies blur layer rules via Hyprland IPC.
Only applies when running on Hyprland.
Complete Example
launcher_size = [900.0, 600.0]
window_size = [1920.0, 1080.0]
enable_backdrop = true
enable_transparency = true
hyprland_auto_blur = true