zlaunch
Compositors

Niri

Full Niri integration

zlaunch has full support for Niri with native IPC integration.

Features

FeatureStatus
Window switching✓ Full
Clipboard history✓ Full
Workspace awareness✓ Full
Focus tracking✓ Full
Layer shell✓ Full

Setup

Autostart

Add to ~/.config/niri/config.kdl:

spawn-at-startup "zlaunch"

Keybind

binds {
    Mod+Space { spawn "zlaunch" "toggle"; }
}

Mode-specific binds (optional)

binds {
    Mod+E { spawn "zlaunch" "show" "--modes" "emojis"; }
    Mod+V { spawn "zlaunch" "show" "--modes" "clipboard"; }
}

IPC Details

zlaunch communicates via the Niri socket at $NIRI_SOCKET.

JSON protocol commands:

  • {"Windows"} — List windows
  • {"Action":{"FocusWindow":{"id":N}}} — Focus window by ID

Blur

Niri doesn't support automatic blur rules via IPC. Configure blur in your Niri config if desired.

Troubleshooting

Windows not showing?

  • Verify $NIRI_SOCKET is set
  • Check socket is accessible

Clipboard not working?

  • Niri supports wlr-data-control by default
  • Verify clipboard works in other apps first

On this page