hyprutil

Utilities for the Hyprland Wayland compositor.

urgency-watch

Event-driven XWayland urgency monitor. Reacts instantly when any XWayland window sets the WM_HINTS urgency bit and forwards it to Hyprland via the seturgent dispatcher (provided by urgency-plugin).

Dependencies: libX11, jq, hyprctl

make
./urgency-watch &

urgency-plugin

Hyprland plugin that adds the seturgent dispatcher. It marks a window as urgent, emits the urgent>>addr IPC event on socket2 (consumed by Waybar's hyprland/workspaces module), and fires the internal EventBus event.

make install   # builds and hot-loads urgency-<epoch>.so into Hyprland

The timestamped filename is required because Hyprland caches dlopen handles by path — reloading the same filename would run stale code.

Usage:

hyprctl dispatch seturgent "address:0xADDR"

Other scripts

File	Description
urgency.sh	Legacy polling script (superseded by urgency-watch)
rename-workspace.tcl	Tk dialog to rename the active workspace
send-key.tcl	Send key events to the active window (XWayland or native Wayland)
event.sh	Stream raw Hyprland socket2 events to stdout (debug helper)

Urgency flow

urgency-watch  →  hyprctl dispatch seturgent  →  urgency-plugin
    (Xlib)                                          (C++ .so)
                                                       │
                                               socket2 urgent>>addr
                                                       │
                                                    Waybar
                                          #workspaces button.urgent

Build

make          # urgency-watch + urgency-plugin/urgency.so
make install  # also installs plugin into ~/.config/hypr/plugins/
make clean