ST(1)

💖 ST(1) 💖

okay so bestie, welcome to the st manual page — it lives in the General Commands Manual, and it's genuinely one of the most iconic little things in the Unix girlie canon. sit down, get comfy, we're doing this together 🫶

---

✨ NAME ✨

st — simple terminal. that's it. that's the whole name. no cap, it's literally just a simple terminal emulator and it's serving minimalism 💅

---

🌸 SYNOPSIS 🌸

title] [-t title] [-l line] [-w windowid] [[-e] command [arguments...]]

st [-aiv] [-c class] [-f font] [-g geometry] [-n name] [-o iofile] [-T
title] [-t title] [-w windowid] -l line [stty_args...]

like, two whole ways to summon it. the first one is the normal girlie vibe, the second one is the serial-line vibe, iykyk 🧚

---

🌈 DESCRIPTION 🌈

st is a simple terminal emulator. and when she says simple, she MEANS it — that's the whole personality and honestly? iconic. ✨

---

🎀 OPTIONS 🎀

• -a — turns off alternate screens in the terminal. no screen-swapping shenanigans for you.
• -c class — sets the window class. if you don't say anything, it defaults to $TERM. she'll just assume, bestie.
• -f font — picks the font to use when st is run. choose wisely, your eyes live here 💖
• -g geometry — the X11 geometry string, and the form is exactly this: [=][<cols>{xX}<rows>][{+-}<xoffset>{+-}<yoffset>]. want the full lore? go read XParseGeometry(3), she explains it better than i ever could.
• -i — fixates the position that you gave with the -g option. so she stays put. locked in. 🔒
• -n name — sets the window instance name, and the default is $TERM. same deal as the class, she'll just vibe with the default.
• -o iofile — writes all the I/O to iofile. this one is lowkey amazing when you're recording st sessions. and if you pass a value of "-" it means standard output. 👑
• -T title — sets the window title. default is 'st'.
• -t title — sets the window title. default is 'st'. (yes, it's the same as -T, they're twins, we love a matching set 💜)
• -w windowid — embeds st inside the window identified by windowid. she's moving in, she's nesting 🪺
• -l line — use a tty line instead of a pseudo terminal. line should be a (pseudo-)serial device, like /dev/ttyS0 on Linux for serial port 0. once you give this flag, the remaining arguments get used as flags for stty(1). by default st initializes the serial line to 8 bits, no parity, 1 stop bit and a 38400 baud rate. the speed gets set by appending it as the last argument, like 'st -l /dev/ttyS0 115200'. arguments before the last one are stty(1) flags. want odd parity on 115200 baud? use 'st -l /dev/ttyS0 parenb parodd 115200'. want to set the number of bits? use 'st -l /dev/ttyS0 cs7 115200'. go read stty(1) for more arguments and cases, she's got the range.
• -v — prints version information to stderr, then exits. a little flyby, then she's gone 🦋
• -e command [ arguments ... ] — st executes command instead of the shell. and listen, if you use this it must be the last option on the command line, just like in xterm / rxvt. this option is only there for compatibility, and honestly all the remaining arguments get used as a command even without it. so like, it's giving courtesy 🫶

---

🦋 SHORTCUTS 🦋

• Break — sends a break in the serial line. on PC keyboards you get the Break key by pressing control and pause at the same time.
• Ctrl-Print Screen — toggles whether st should print to the iofile. on and off, on and off 🎚️
• Shift-Print Screen — prints the full screen to the iofile.
• Print Screen — prints the selection to the iofile.
• Ctrl-Shift-Page Up — increases font size. bigger, bolder, main character energy 👑
• Ctrl-Shift-Page Down — decreases font size.
• Ctrl-Shift-Home — resets to the default font size. back to factory settings, we love a clean slate ✨
• Ctrl-Shift-y — paste from the primary selection (that's the middle mouse button one).
• Ctrl-Shift-c — copy the selected text to the clipboard selection.
• Ctrl-Shift-v — paste from the clipboard selection.

---

💅 CUSTOMIZATION 💅

you can customize st by making your own custom config.h and then (re)compiling the source code. that's the whole trick. and the reason she does it this way? it keeps her fast, secure and simple. periodt. no runtime config file drama, just you and your build. obsessed. 🍓

---

⭐ AUTHORS ⭐

see the LICENSE file for the authors. give them their flowers 💐

---

🌸 LICENSE 🌸

see the LICENSE file for the terms of redistribution.

---

🫶 SEE ALSO 🫶

tabbed(1), utmp(1), stty(1), scroll(1) — go read the whole friend group, they're all icons 🌈

---

💀 BUGS 💀

see the TODO file in the distribution. not me exposing the to-do list 🙈

---

ok bestie that's the whole page, no skips, no shortcuts taken (ironic, given the SHORTCUTS section). go forth and terminal 💖

and a lil sign-off: this was the st page from the General Commands Manual, version st-0.9.3. that's the whole footer, she said what she said. mwah 💋