zlaunch
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
PropertyDefaultRecommended Range
Width600.0300 – 2000 px
Height400.0200 – 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  # default

When disabled, the launcher window is just the panel—no click-outside-to-close behavior.

Transparency

Enable transparent background rendering:

enable_transparency = true  # default

Hyprland Auto Blur

Automatically apply Hyprland blur rules via IPC:

hyprland_auto_blur = true  # default

This 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

On this page