WEW(1)

📦 version 1.0-unstable-2024-09, in nixos 26.05, nixpkgs unstable

💅 wew — bestie's window event watcher 💅

okay so real talk, wew(1) is from the wmutils fam and it is literally the nosiest little daemon in your X session, in the best way. 🫶

✨ NAME ✨

wew — window event watcher 👀🌸

🦋 SYNOPSIS 🦋

wew [-l] [-m mask]

🎀 DESCRIPTION 🎀

so wew is a daemon, right? and what it does — no cap — is it prints X events to stdout. That's the whole vibe. It's just sitting there, watching windows, telling you what happened. main character energy fr fr.

Every event it spits out looks like this:

event wid [args]

and if you're like "wait, what can event even be??" — scroll down to EVENT VALUES bestie, I gotchu 💖

the options: 🌈

  • -l — lists out all the event mask values for you. it's giving "show me the menu" ✨
  • -m mask — sets the event mask for new windows to mask. You can register multiple events by doing a bitwise OR of their values together. (iykyk — OR them bits, boo 💅)
if you don't pass -m, it defaults to STRUCTURE_NOTIFY|ENTER_NOTIFY|FOCUS_CHANGE. Also heads up: the events registered on the root window cannot be modified. That's just how it is, periodt. 🙈

🔥 EVENT VALUES 🔥

events get reported under these names, exactly these, no substitutions:

  • CREATE
  • DESTROY
  • BUTTON_PRESS
  • BUTTON_RELEASE
  • MOTION
  • ENTER
  • LEAVE
  • CONFIGURE
  • KEY_PRESS
  • FOCUS_IN
  • FOCUS_OUT
  • KEYMAP
  • EXPOSE
  • GRAPHICS_EXPOSURE
  • NO_EXPOSURE
  • VISIBILITY
  • UNMAP
  • MAP
  • MAP_REQUEST
  • REPARENT
  • CONFIGURE_REQUEST
  • GRAVITY
  • RESIZE_REQUEST
  • CIRCULATE
  • PROPERTY
  • SELECTION_CLEAR
  • SELECTION_REQUEST
  • SELECTION
  • COLORMAP
  • CLIENT_MESSAGE
  • MAPPING

like… the whole alphabet of window drama. obsessed. 👑

🌸 ENVIRONMENT 🌸

wew acts on the X display that the DISPLAY variable points at. That's it. That's the whole environment situation. 🧚

lowkey reminder bestie: this is the manual page for wew(1), and everything above is the actual facts — I just made it cute 💜

mwah, that's the page! 💖 source/version: wmutils, dated December 17, 2014 — she's an icon, she's a legend, and she is the moment. go watch some windows, bestie 🎀✨🦋

📦 where this page comes from