ESCROTUM(1)

ESCROTUM(1) 💅

okay so this is a User Commands manual page, bestie — buckle up 🎀

✨ NAME ✨

escrotum — a minimalist screenshot capture and screen recording program, inspired by scrot. yes. that's the whole vibe. minimalist. iconic. 🦋

🌸 DESCRIPTION 🌸

okay so here's the usage, literally exactly as it appears, no cap:

usage: escrotum [-h] [-v] [-s] [-x XID] [-d DELAY]
              [--selection-delay SELECTION_DELAY] [-c] [-C] [-e COMMAND] [-r]
              [FILENAME]

Minimalist screenshot capture and screen recording program inspired by scrot. that's the whole pitch and honestly? it ate. 🔥

🎀 positional arguments 🎀

• FILENAME — the image filename, bestie. and if you don't give one, it defaults to %Y-%m-%d-%H%M%S_$wx$h_escrotum.png — which lowkey looks like a keyboard smash but trust, it makes sense once you read the special strings section below 👑

💖 optional arguments 💖

• -h, --help — shows this help message and then dips. exit stage left. 🫶
• -v, --version — spits out the version info and leaves. ✨
• -s, --select — interactively pick a window or draw a rectangle with your mouse. and if you change your mind? cancel with Esc or right click. no drama 🖱️
• -x XID, --xid XID — takes a screenshot of the window with that specific xid. targeting, but make it X11 💅
• -d DELAY, --delay DELAY — waits DELAY seconds before taking the shot. gives you time to fix your hair 💁‍♀️
• --selection-delay SELECTION_DELAY — the delay in milliseconds between the selection and the screenshot. tiny pause, big difference ⏱️
• -c, --countdown — shows a countdown before the shot. requires delay — so don't come at it with no -d, it will not work, iykyk 🙈
• -C, --clipboard — stores the image on the clipboard. paste-ready, main character energy 📋
• -e COMMAND, --exec COMMAND — runs your command after the image is taken. automation slay 🤖
• -r, --record — screen recording mode!! and Alt+Ctrl+s stops the recording, write that down 📝

🦋 SPECIAL STRINGS 🦋

okay bestie this part is actually so cool. both the --exec parameter and the filename parameter can take format specifiers, and escrotum expands them when it encounters them. 🧚

there are two kinds of format specifier:

1. characters preceded by a % get interpreted by strftime(2). go see man strftime for examples. these ones can refer to the current date and time. ⭐
2. the second kind is internal to escrotum and prefixed by $. the following specifiers are recognised:

• $f — image path/filename (ignored when used in the filename)
• $w — image width
• $h — image height

Example:

escrotum '%Y-%m-%d-%H%M%S_$wx$h_escrotum.png'

creates a file called something like 2013-06-17-082335_263x738_escrotum.png. see?? it all comes together 💜

💀 EXIT STATUS CODES 💀

so if something goes sideways, here's what the numbers mean:

• 1 — can't get the window by xid
• 2 — invalid pixbuf
• 3 — can't save the image
• 4 — user canceled selection
• 5 — can't grab the mouse
• 6 — error with ffmpeg

👑 SEE ALSO 👑

The full documentation for escrotum is maintained as a Texinfo manual. If the info and escrotum programs are properly installed at your site, the command

info escrotum

should give you access to the complete manual. 🌈

fr fr, that's the whole page — every flag, every specifier, every exit code, nothing skipped 💖

signing off: this was escrotum 0.2.1, dated January 2020, from the User Commands section — stay slay, take screenshots 🎀✨🦋