IPC and scripting

A running slintlu listens on a Unix socket so scripts, compositor keybindings and other programs can control it. The socket is $XDG_RUNTIME_DIR/slintlu/$WAYLAND_DISPLAY.sock (override with SLINTLU_SOCKET).

From the command line

slintlu msg ping                         # {"version": "0.1.0"}
slintlu msg reload
slintlu msg quit
slintlu msg windows                      # components and the output they are on
slintlu msg outputs
slintlu msg get Audio.output             # read any exported global property
slintlu msg set MyGlobal.open true       # write it (values are JSON; bare words are strings)
slintlu msg toggle MyGlobal.open         # flip a bool, prints the new value
slintlu msg call Shared.toggle launcher  # shared cross-window state
slintlu msg call Audio.set-volume 0.5    # invoke a global callback or function
slintlu msg call Launcher.search firefox

The exit status is non-zero when the request fails.

Exposing your own commands

Any global your shell exports is reachable, but keep in mind that globals you define yourself exist once per window: when one panel changes its copy, the others do not see it. For state several windows share — which popup is open, toggles — use the native Shared global, which every window sees:

import { PanelWindow, Shared } from "@slintlu";

export component LauncherPanel inherits PanelWindow {
    layer: overlay;
    keyboard-mode: exclusive;
    shown: Shared.get-bool("launcher", false, Shared.revision);
    // ... close with Shared.set-bool("launcher", false)
}

niri (~/.config/niri/config.kdl):

binds {
    Mod+D { spawn "slintlu" "msg" "call" "Shared.toggle" "launcher"; }
}

Hyprland: bind = SUPER, D, exec, slintlu msg call Shared.toggle launcher Sway: bindsym $mod+d exec slintlu msg call Shared.toggle launcher

set, toggle and call on a global the shell defines apply to every window, get reads the first one. Callbacks implemented by SlintLu (e.g. Audio.set-volume) run once.

Protocol

One JSON request per line, answered by one JSON line. Requests carry a cmd tag:

{"cmd": "ping"}
{"cmd": "reload"}
{"cmd": "quit"}
{"cmd": "windows"}
{"cmd": "outputs"}
{"cmd": "get", "target": "Audio.output"}
{"cmd": "set", "target": "MyGlobal.open", "value": true}
{"cmd": "toggle", "target": "MyGlobal.open"}
{"cmd": "call", "target": "Audio.set-volume", "args": [0.5]}

Responses: {"ok": true, "result": ...} or {"ok": false, "error": "..."}.

echo '{"cmd":"get","target":"Clock.time"}' | socat - UNIX-CONNECT:$XDG_RUNTIME_DIR/slintlu/$WAYLAND_DISPLAY.sock

Rust programs can use slintlu::ipc::{Client, Request} directly.