WISTRUT(1)

📦 version 0-unstable-2023-09, in nixos 26.05, nixpkgs unstable

💖 NAME 💖

Okay bestie, meet wistrut — the wmii EWMH strut manager. This is the WISTRUT(1) page from the General Commands Manual, and it's here to make your utility windows behave. ✨

🌈 SYNOPSIS 🌈

wistrut [-HV] <window|class>...

wistrut -v

🦋 DESCRIPTION 🦋

So wistrut is out here doing the most for programs that don't provide EWMH strut functionality themselves: it automatically sets EWMH struts on windows. That means you can leave utility windows onscreen without obscuring managed clients, bestie. Instead, whatever part of the screen is occupied by the window will be left free by wmii, provided it is less than half of the screen width or height. 👑

Struts are automatically updated when the managed windows are moved or resized, and they're only applied if the window is touching an edge of the screen. That's the vibe check. ✨

wistrut may be used with any EWMH compatible window manager. No gatekeeping. 💅

🎀 ARGUMENTS 🎀

All non-option arguments constitute window IDs or regular expressions. In the latter case, any window whose <name>:<class>:<title> (as used in wmii's colrules and tagrules) will be managed. 🫶

  • -H — only set horizontal struts. Normally, wistrut locates struts in the direction of the narrowest dimension of the window, provided it is touching a screen edge. With this option set, they will always be allocated on either the left or right of the screen. Never the top or bottom. ⬅️➡️
  • -V — only set vertical struts. See -H. ⬆️⬇️
  • -v — display version information. 💬

💀 BUGS 💀

There is no way to remove struts from a window other than to move it away from the edge of the screen and kill wistrut. That's the bug, bestie, and it's giving "no undo button" energy. 😭

🔥 SEE ALSO 🔥

wmii(1)

💌 cute sign-off: this page comes from wmii-, dated May, 2010, and it's the WISTRUT(1) manual page. mwah 💋

📦 where this page comes from