WIMENU(1)

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

💅 WIMENU(1) — like, the General Commands Manual edition, bestie 🎀

okay so real talk, this one's a lil chaotic gremlin of a page and I'm obsessed with it. sit down, grab a strawberry drink 🍓, and let's get into it.

✨ NAME ✨

wihack — the wmii window hack. that's it. that's the name. it's giving "we named it honestly" and honestly? iconic.

🦋 SYNOPSIS 🦋

wihack [-transient <window>] [-type <ewmh window type>] [-tags <tags>]
<program>

🌸 DESCRIPTION 🌸

so wihack is a program that alters the windows created by an arbitrary program. like, any program. you point it at stuff and it messes with the windows that pop out. main character energy fr fr.

and yes, it's literally called wihack because it is just that: a hack 💀 no cap, no shade, that's the whole bit.

the way it works? it uses LD_PRELOAD to override certain Xlib calls and slap properties onto newly created windows. sneaky little fairy godmother behavior 🧚✨

💜 ARGUMENTS 💜

  • -transient <window> — marks created windows as transient for a given <window>. what does that mean in practice? the new window opens in the floating layer of the same tags as <window>. cute little buddy system 🫶
  • -type <ewmh window type> — sets the EWMH window type of the created window to the type you give it. wmii understands these types, and I need you to pay attention because they all behave different:
    • dialog — opens in the floating layer. floaty lil thing.
    • dock — (no extra deets on this one, it's just vibing on the list)
    • menu — (same, just a type wmii knows)
    • toolbar — automatically opens in the floating layer. does not have a window border or titlebar. minimal queen 💅
    • splash — automatically floats and does not automatically receive focus. it's shy, leave it alone 🙈
  • -tags <tags> — the created window opens on the given tags. simple as that, periodt.

💀 BUGS 💀

  • it is a hack. (yes that's the entire bug report. I'm screaming 😭)
  • it doesn't work for setuid programs.
  • it doesn't work for non-Xlib programs.
heads up bestie: these are real limitations, not a vibe. if your program is setuid or isn't Xlib-based, this thing is not gonna do the thing. no cap.

🌈 SEE ALSO 🌈

wmii(1) — go read that one too, iykyk ✨

and that's the whole page!! this was the wmii- edition, dated May, 2010 — yeah she's an elder but she still slays. mwah, love u, go hack some windows 💖🦋🎀

📦 where this page comes from