Compositors
Hyprland
Full Hyprland integration
zlaunch has full support for Hyprland with native IPC integration.
Features
| Feature | Status |
|---|---|
| Window switching | ✓ Full |
| Automatic blur | ✓ Full |
| Workspace awareness | ✓ Full |
| Focus tracking | ✓ Full |
| Layer shell | ✓ Full |
Setup
Keybind
bind = SUPER, Space, exec, zlaunch toggleMode-specific binds (optional)
bind = SUPER, E, exec, zlaunch show --modes emojis
bind = SUPER, V, exec, zlaunch show --modes clipboard
bind = SUPER, C, exec, zlaunch show --modes calculatorAutomatic Blur
By default, zlaunch applies blur when opening:
hyprland_auto_blur = true # defaultThis injects a layer rule via Hyprland IPC:
layerrule = blur on,match:class zlaunchDisable with hyprland_auto_blur = false if you prefer manual blur rules.
Manual Blur Configuration
If you disable auto-blur, add to your Hyprland config:
layerrule = blur on,match:class zlaunch
layerrule = blur_popups on,match:class zlaunch
layerrule = ignore_alpha 0.35,match:class zlaunchIPC Details
zlaunch communicates via the Hyprland socket at:
$XDG_RUNTIME_DIR/hypr/$HYPRLAND_INSTANCE_SIGNATURE/.socket.sockCommands used:
j/clients— List windowsdispatch focuswindow address:0x...— Focus windowkeyword layerrule ...— Apply blur rules
Troubleshooting
Windows not showing?
- Verify
$HYPRLAND_INSTANCE_SIGNATUREis set - Check socket exists at the expected path
Blur not working?
- Ensure
decoration:blur:enabled = truein Hyprland config - Check
hyprland_auto_bluris not disabled