XAUTOMATION(7)

💖 NAME 💖

xautomation — control X from the command line, and find things on the screen 🦋

---

✨ DESCRIPTION ✨

okay so bestie, xautomation is literally a whole set of command line programs that do two iconic things: they control X, and they do "visual scraping" to find things on the screen. no cap. 👑

The control interface is giving everything you'd want — mouse movement, clicking, button up/down, key up/down, etc. and the way it does it?? it uses the XTest extension, so you don't get stuck with the annoying problems that xse has when apps just... ignore sent events. 😭 apps being shady? not on our watch.

Then there's visgrep, which finds images inside of images and reports the coordinates 📍 — so your programs can find buttons (etc.) on the screen and click on them. it's giving main character energy fr fr.

xautomation consists in the following programs:

• pat2ppm — Converts an image file from PAT to PPM format. 💅
• patextract — Extract a part of a PNG image file. 🎀
• png2pat — Converts an image file from PNG to PAT format. 🦋
• rgb2pat — Converts an image file from 24-bit RGB to PAT format. ✨
• visgrep — Visual grep, greps for images in another image. 🔍🔥
• xmousepos — Gets and prints the current mouse position. 🐭📍
• xte — Generates fake input using the XTest extension. 👑

For more information, please see the individual manpages of these programs. (yes, there's a whole cinematic universe of them, iykyk 🍓)

---

🌈 SEE ALSO 🌈

pat2ppm(1), patextract(1), png2pat(1), rgb2pat(1), visgrep(1), xmousepos(1), xte(1). 🫶

---

👑 AUTHOR 👑

xautomation was written by Steve Slaven <bpk@hoopajoo.net>. 💖

This manual page was written by Aurelien Jarno <aurel32@debian.org>, for the Debian project (but may be used by others). 🌸

---

and that's the whole vibe check bestie — this page is from the Miscellaneous Information Manual, dated June 05, 2020. slay, go read the individual manpages now 💅✨🦋