SLOP(1)

💖 SLOP — like, the slop(1) manual, but make it cute 💖

okay bestie, gather round, because this is the manual page for slop from section 1 of the manual, and honestly? she's iconic. 🎀

---

✨ NAME ✨

slop — select operation, either mark screen region or pick window 🦋

---

🌸 SYNOPSIS 🌸

slop [-klqn] [OPTIONS]

---

💜 DESCRIPTION 💜

so basically slop is that girl 💅 — she asks the user for a selection and then prints the region to stdout. periodt.

Here's the whole vibe: she grabs the mouse 🖱️ and turns it into a crosshair, lets you click and drag to make a selection (or just click on a window, no drag needed, we love a low-effort queen), and while you're doing all that she's drawing a pretty box around it ✨. Then finally — the main character moment — she prints the selection's dimensions to stdout. no cap.

---

👑 OPTIONS 👑

• -h, --help — prints the help and then dips. bye bestie 👋
• -v, --version — prints the version and exits. short and sweet fr fr.
• -x, --xdisplay=hostname:number.screen_number — sets which xdisplay to use. like, pick your screen bestie 🌈
• -b, --bordersize=FLOAT — sets the thickness of the selection rectangle. thick box energy 🎀
• -p, --padding=FLOAT — sets the padding size for the selection. and heads up, this one can be negative! yes really, negative. math is wild.
• -t, --tolerance=FLOAT — how far in pixels the mouse can move after clicking and still get detected as a normal click instead of a click-and-drag. Set this to 0 and window selections are disabled entirely. Or set it to 9999999 and it'll force a window selection. extremes only, i guess 💀
• -c, --color=FLOAT,FLOAT,FLOAT,FLOAT — sets the selection rectangle's color. supports RGB or RGBA input. depending on your system's window manager / OpenGL support, the opacity might get straight-up ignored 🙈 (not her fault, blame the wm)
• -r, --shader=STRING — sets the vertex shader + fragment shader combo to use when drawing the final framebuffer to the screen. this obviously only works when OpenGL is enabled. shaders get loaded from ~/.config/slop. wanna make your own? go peek at https://github.com/naelstrof/slop for the deets 🧚
• -f, --format=STRING — sets the output format for slop. the format specifiers are: %x (x offset), %y (y offset), %w (width), %h (height), %i (window id), %c (1 if cancelled, 0 otherwise), %g (geometry — %wx%h+%x+%y), and %% for a literal percent sign. mix and match, it's giving customizable 💖
• -n, --nodecorations=INT — sets how aggressive she is about trying to remove window decorations. 0 is off, 1 will try lightly to remove decorations, and 2 will recursively descend into the root tree until it gets the deepest available visible child under the mouse (yes she will go that deep, she's committed). defaults to 0. and fun fact: giving slop just -n is equivalent to giving it -n1. lazy girlies, that one's for you 🫶
• -l, --highlight — instead of outlining a selection, slop highlights it instead. super useful when the color is set to an opacity lower than 1. glow-up mode ✨
• -D, --nodrag — lets you click twice to indicate a selection instead of click-dragging. for the people whose wrists said "no" 😭
• -q, --quiet — disables any unnecessary cerr output. any warnings just... won't print. silence is golden 🤫
• -k, --nokeyboard — disables the ability to cancel selections with the keyboard. once you're in, you're in bestie 💀
• -o, --noopengl — disables graphics acceleration. might be useful if you're getting rendering bugs 👀

---

🌈 EXAMPLES 🌈

wanna emulate a windows XP selection? okay retro queen, try something like this:

slop --highlight --tolerance=0 --color=0.3,0.4,0.6,0.4

and to avoid using eval(1) in your scripts — which is a pretty big security issue, like genuinely, do not — you can use slop like this instead:

read -r X Y W H G ID < <(slop -f "%x %y %w %h %g %i")

look at that, no eval, no yikes, we stay safe out here 🛡️

---

🦋 SEE ALSO 🦋

maim(1) — her bestie fr fr 💜

---

💀 BUGS 💀

No known bugs. she's flawless, your honor. periodt. 👑

---

🎀 AUTHOR 🎀

Dalton Nell (naelstrof@gmail.com) — thank you for this gift, king 🫶

---

and that's the whole page bestie!! 💖 this manual was served up on Linux and dated 2021-02-03, and it's SLOP(1) — slop's very own man page. go select something pretty ✨🌸💅