CLI Reference

Daemon Management

Start Daemon

zlaunch

Starts the zlaunch daemon. Run once, typically via compositor autostart.

Creates a socket at $XDG_RUNTIME_DIR/zlaunch.sock for client communication.

Stop Daemon

zlaunch quit

Reload Daemon

zlaunch reload

Fully restarts the daemon. Use after config changes that don't auto-reload.

Window Control

zlaunch toggle

Shows if hidden, hides if visible. Bind this to a key.

With specific modes:

zlaunch toggle --modes combined,emojis,clipboard

zlaunch show

With specific modes:

zlaunch show --modes emojis
zlaunch show --modes applications,windows

zlaunch hide

Mode Selection

The --modes flag accepts a comma-separated list:

Mode	Aliases
`applications`	`apps`, `app`
`windows`	`window`
`calculator`	`calc`
`emojis`	`emoji`
`clipboard`	—
`actions`	`action`
`search`	—
`themes`	`theme`
`ai`	—
`combined`	—

Theme Commands

zlaunch theme

Prints the currently active theme.

zlaunch theme list

Lists all available themes (bundled + custom).

zlaunch theme set <name>

Examples:

zlaunch theme set dracula
zlaunch theme set catppuccin-mocha
zlaunch theme set my-custom-theme

Exit Codes

Code	Meaning
0	Success
1	Error (connection failed, invalid args, etc.)

Examples

Hyprland Keybinds

bind = SUPER, Space, exec, zlaunch toggle
bind = SUPER, E, exec, zlaunch show --modes emojis
bind = SUPER, V, exec, zlaunch show --modes clipboard
bind = SUPER SHIFT, T, exec, zlaunch show --modes themes

Check if Daemon is Running

if zlaunch hide 2>/dev/null; then
    echo "Daemon is running"
else
    echo "Daemon not running, starting..."
    zlaunch &
fi

Theme Switcher Script

#!/bin/bash
themes=$(zlaunch theme list)
selected=$(echo "$themes" | fzf)
[ -n "$selected" ] && zlaunch theme set "$selected"

CLI Reference

On this page