Arrange(1x)

✨ Arrange(1x) ✨

okay bestie, so this is Arrange, and it lives in the AfterStep X11 window manager manual, section 1x. It's a module. It arranges your windows. That's the whole gig. 💅

---

🎀 CONFIGURATION OPTIONS 🎀

(yeah this heading is just… here up top by itself, no cap. it's giving "placeholder". the actual config stuff is further down, keep scrolling bestie 🫶)

---

🌸 DESCRIPTION 🌸

so here's the lore 👑 — Arrange was made to replace Tile and Cascade, the two OGs from AfterStep 1.8 that straight-up stopped working when AfterStep 2.0 dropped. 💀 They did not survive the update, bestie.

Like Tile and Cascade, Arrange can be used to tile or cascade windows — but subject to certain constraints, okay? It's got rules.

By default, Arrange will cascade windows located on the current screen. That's the no-extra-args vibe. ✨

---

💖 OPTIONS 💖

one bullet per flag because we're thorough and we're not skipping a single one, periodt.

• -a — makes all window styles get affected, even the ones rocking the WindowListSkip style. nobody gets left out. 🙈
• -alldesks — affects windows on all desks. every single one. 🌈
• -desk — cascades all windows on the desk instead of just the current screen. bigger scope, bigger energy. 🦋
• -H — tiles windows horizontaly. heads up though: this only does anything if you also pass -tile. it's a duo, they come as a set. 💅
• -incx arg — sets a horizontal increment that gets successively added to the arranged windows. arg is a percentage of screen width, or a pixel value if you suffix it with a p. Default is 20p. ⭐
• -incy arg — same deal but vertical: a vertical increment successively added to arranged windows. arg is a percentage of screen height, or a pixel value with a p suffix. Default is 20p. ⭐
• -m — maximized windows get affected too. (implied by -all btw, so if you already passed that, this is redundant — but cute!) 😭
• -mn arg — tiles up to arg windows in the tile direction. if there are more windows than that, a new direction row or column gets created — so in effect, a matrix is born. 🔥
• -noraise — inhibits window raising, leaving the depth ordering intact. don't touch the stack bestie, it's fine where it is. 🙏
• -nostretch — inhibits window expansion when you're using the -resize option. windows will only shrink to fit the maximal width and height (if given). no growing. shrinking only. 📉
• -pattern arg — only arrange windows that match the supplied pattern. selective. exclusive. iconic. ✨
• -r — reverses the window sequence. backwards but make it fashion. 🔄
• -resize — forces all windows to resize to the constrained width and height (if given). 😤
• -s — sticky windows get affected too. (implied by -all) 🍓
• -t — transient windows get affected too. (implied by -all) 🧚
• -tile — tiles windows instead of cascading them. the classic switcheroo. 💜
• -u — untitled windows get affected too. (implied by -all) 🌸

---

🦋 INVOCATION 🦋

You can invoke Arrange from the autoexec file, or by binding the action "Module Arrange [args]" to a key-stroke in a feel file. two options, both slay. ✨

---

🎀 CONFIGURATION OPTIONS 🎀

(the real one this time, we made it 💖)

Command-line arguments you pass to Arrange are described up in the OPTIONS section. go look, i'll wait. 💅

Now here's the fun part: you can put up to four numbers on the command line that aren't switches.

1. The first pair specifies an x and y offset to start the first window. (default is 0, 0)
2. The second pair specifies an absolute coordinate reference denoting the lower right bounding box for tiling.

And the units tea 🫖: if any number has the letter p suffixed, it's taken as a pixel value. Otherwise it's interpreted as a screen percentage. Also — specifying zero for any parameter is equivalent to just not specifying it. same thing, no difference. 😌

So this invocation right here horizontally tiles windows with a bounding box that starts at 10 by 10 percent into and down the screen, and ends at 90 by 90 percent into and down the screen:

Arrange 10 10 90 90 -tile -H

⚠️ also, real talk: it is probably not a good idea to delete windows while windows are being arranged. just… don't. wait your turn bestie 😭💀

---

okay that's the whole page! 🎉 this little treasure came to you from the 3rd Berkeley Distribution, running AfterStep v.2.2.12, and it's filed under Arrange(1x). go arrange something cute, bestie. periodt. 💖✨👑