AOSD(1)

🦋 AOSD(1) 🦋 — the aosd_cat manual, but make it bestie 💖

✨ NAME ✨

okay so aosd_cat is the one that displays text on the screen 🫶 it's literally an OSD (on-screen display) tool that puts your words over whatever you're doing 💅

🌸 SYNOPSIS 🌸

aosd_cat [OPTION...]

🎀 DESCRIPTION 🎀

okay bestie, so this thing shows UTF-8 text inside a see-through OSD frame ✨ it's giving floating-over-your-desktop energy and I'm obsessed 😭

heads up on the numbers 🔢 parameters marked with an asterisk (*) take a valid range of 0-255. the ones with a double asterisk (**) are chill and accept negative values too 🙈 colors can be written as #RGB or pulled by name from rgb.txt 🌈 timing stuff is in milliseconds ⏱️ scrollback limits get cancelled if you pass 0 🚫 and age is measured in seconds 🕰️

🗺️ Geometry Options 🗺️

• -p, --position — this sets where the OSD window sits. more precisely, it picks the spot on the screen that counts as the start of the coordinates (the 0,0 point) AND picks the spot on the OSD window that lines up with it 🎯 valid range is 0-8, where 0 is the top-left corner and 8 is the bottom-right corner 💜 the default is 6.
• -x, --x-offset ** — sets the x-axis offset of the window from the (0,0) point ➡️ default is 50.
• -y, --y-offset ** — sets the y-axis offset of the window from the (0,0) point ⬇️ default is -50.
• -e, --shadow-offset ** — sets the shadow offset 🌑 default is 2.
• -d, --padding * — sets the margin between the edge and the contents 🧸 default is 0.

💅 Appearance Options 💅

• -t, --transparency — sets the transparency mode: 0 = none, 1 = fake, 2 = composite ✨ default is 2.
• -n, --font — sets the OSD font 🔤 there's no default value, so you pick one.
• -w, --width — sets the OSD wrapping width in pixels 📏 if you set it to 0, the text wraps on the screen width, or doesn't wrap at all if other parameters make correct layout impossible 🙃 default is 0.

🌈 Coloring Options 🌈

• -B, --back-color — sets the background color 🎨 no default value.
• -S, --shadow-color — sets the shadow color 🖤 default is black.
• -R, --fore-color — sets the foreground color 💚 default is green.

🫧 Opacity Options 🫧

• -b, --back-opacity * — sets the background opacity 👻 default is 0.
• -s, --shadow-opacity * — sets the shadow opacity 🌘 default is 192.
• -r, --fore-opacity * — sets the foreground opacity 💫 default is 255.

⏰ Timing Options ⏰

• -f, --fade-in — sets the fade-in time ✨ default is 300.
• -u, --fade-full — sets how long it stays at full opacity 💖 default is 3000.
• -o, --fade-out — sets the fade-out time 👋 default is 300.

📜 Scrollback Options 📜

• -a, --age — sets the line age removal limit 🕰️ default is 0.
• -l, --lines — sets the line amount removal limit 📉 default is 1.

🦄 Application Options 🦄

• -i, --input — sets the input text source 📥 default is -.

🙈 BUGS 🙈

⚠️ bestie, this manpage may be out of date! run --help to get the latest options 👀

Thank you for using libaosd! 🫶 please send bug reports to: http://jira.atheme.org/

ok that's the whole tea ☕ aosd_cat · November 2007 · AOSD(1) · stay iconic and keep your OSD slay 💅✨🦋