TERMREC(1)

💖 TERMREC(1) — the tty recorder bestie 💖

okay so picture this: you're in the group chat of your terminal, and you want receipts. that's termrec, and she is serving — she's a tty recorder. ✨

---

🎀 NAME 🎀

termrec — a tty recorder. that's it, that's the whole vibe. no cap.

---

🌸 SYNOPSIS 🌸

termrec [-f format] [-e command] [outfile]

---

🦋 DESCRIPTION 🦋

okay so termrec is a tty recorder, periodt. she can record the output of any text mode program, and then you get to replay it later with termplay, ttyplay, ipbt, ttyplayer, nh-recorder, asciinema or similar. like, your terminal session becomes content. iconic behavior fr fr 💅

if your outfile ends in .gz, .xz, .bz2 or .zst, the data gets appropriately compressed. she's thoughtful like that 🫶

and if you don't give her an outfile at all? no stress, she'll just make up a name for you, something like:

2008-11-27.13-02-42.ttyrec.bz2

you can also write directly to some remote URLs, such as tcp://host:port — but ngl, that's usually of little use. lowkey pointless but she supports it anyway 💀

---

✨ OPTIONS ✨ (the good stuff)

🌈 Options:

• -f format, --format — you can specify a format other than ttyrec. the ones on the menu are:
  • ansi — no timing data. this is same as the output of script(1). giving minimalist 🎀
  • ttyrec — compatible with ttyrec by Satoru Takabayashi. the og, the blueprint 👑
  • nh-recorder — compatible with nh-recorder by Helge Dennhardt.
  • asciicast — compatible with asciinema by Marcin Kulik; format v2.
  • asciicast-v1 — likewise, format v1. yeah she keeps the old one too, she's not a gatekeeper 🫶
• -e command, --exec — runs a command instead of spawning a shell, and records its output. so instead of a whole interactive shell moment, you're like "bestie just run this one thing and film it" 🎬
• -r, --raw — inhibits noting info about your terminal size and UTFness. so real talk: this data is usually a good thing, but it can confuse some programs. also note that none of the formats provides a way to mark which exactly charset you use — only if it's UTF-8 or one of ancient ones. so it's giving we know it's UTF-8 or it's giving ancient, no in-between 😭
• -a, --append — if the output file already exists, it will be appended instead being overwritten. she adds to the lore instead of deleting the lore 📝
• -h, --help — shows a short explanation of parameters. the "hey bestie here's how I work" button 💖

---

💜 ENVIRONMENT 💜

• SHELL — unless -e is given, this will be the shell spawned, falling back to /bin/sh if not set. on Windows, COMSPEC is used instead. so yeah, windows girlies get their own variable, equality 💅

---

👑 SEE ALSO 👑

termplay(1), termtime(1), termcat(1).

---

💀 no warnings here bestie, she's chill. just remember -a appends and everything else overwrites, and -r can confuse some programs — that's the tea.

---

version 0.19 · dated 2024-04-01 · this was the termrec manual page, and she ate, no crumbs left 🌟 mwah, ily, go record something iconic ✨🎀🦋