xprop-sink

lightweight, streaming X11 property updater

git clone https://9o.is/git/xprop-sink.git

xprop-sink.1

(923B)

      1 .TH XPROP-SINK 1 "FEBRUARY 2026" "Linux" "User Commands"
      2 .SH NAME
      3 xprop-sink \- Stream stdin updates to an X11 window property
      4 .SH SYNOPSIS
      5 .B xprop-sink
      6 \fIWINDOW_ID\fR \fIPROPERTY_NAME\fR
      7 .SH DESCRIPTION
      8 .B xprop-sink
      9 reads lines from standard input and sets the specified X11 property on the given window. It is optimized for high-frequency updates, such as status bar indicators or keyboard state tracking.
     10 .PP
     11 The program is line-buffered. If an input line exceeds the internal 1024-byte buffer, the remainder of the line is drained and ignored to prevent property fragmentation.
     12 .SH ARGUMENTS
     13 .TP
     14 .I WINDOW_ID
     15 The X11 window ID (decimal or hex) to target.
     16 .TP
     17 .I PROPERTY_NAME
     18 The name of the X11 atom (property) to update (e.g., _MY_WIN_STATUS).
     19 .SH EXIT STATUS
     20 The program exits if standard input is closed or if the target window becomes invalid (e.g., the window is closed by the user).
     21 .SH SEE ALSO
     22 .BR xprop (1)