STW(1)

STW(1) — simple X text window ✨

okay so bestie, welcome to the General Commands Manual page for stw, aka STW(1) — the tiny X text window that is literally main character energy 💅🫶

---

🌸 NAME 🌸

stw — simple X text window

✨ SYNOPSIS ✨

stw [-t] [-x pos] [-y pos] [-X pos] [-Y pos] [-a align] [-f foreground]
[-b background] [-F font] [-B borderpx] [-p period] [-A alpha] command
[arg...]

💖 DESCRIPTION 💖

stw is a simple X text window. That’s the whole plot, bestie — it runs your command and displays the output in a window. Iconic. ✨

🎀 OPTIONS 🎀

• -t — place window on top 👑
• -x pos — window x position
• -y pos — window y position
• -X pos — window X position
• -Y pos — window Y position
• -a align — text alignment. Must be one of {lrc} for left, right and centered
• -f foreground — foreground window color in hex or as a color name
• -b background — background window color in hex or as a color name
• -F font — text font in format, supported by fontconfig
• -B borderpx — gap between window border and text in pixels
• -p period — period between command runs in seconds. 0 will completely disable subcommand restarts and -1 will make them instant. In any case a click on a window will still immediately restart subcommand
• -A alpha — window background alpha value
• command [arg...] — command will be started with provided arguments and it’s output will be displayed in the window

🦋 POSITION 🦋

Use -x, -y options to position stw window corner. Use -X, -Y options to position window relative to width and height. For example you can use

-x 50% -y 50% -X -50% -Y -50%

to position stw in the center of the screen. Slay 💅

🌈 EXAMPLES 🌈

Show current date in the center of the screen:

$ stw -p 1 -x 50% -y 50% -X -50% -Y -50% -F monospace:size=20 date

Show updated packages:

$ stw -p 0 sh -c 'xbps-install -nSu | cut -d" " -f1 | head -n 20'

👑 AUTHORS 👑

See the LICENSE file for the authors.

🧚 LICENSE 🧚

See the LICENSE file for the terms of redistribution.

⭐ SEE ALSO ⭐

watch(1)

---

cute footer sign-off, bestie: source/version stw, manual STW(1), and the date was not shown in the original footer — so we’re not inventing one, periodt 😭💅🫶