SCRIPTLIVE(1)

💖 SCRIPTLIVE(1) — bestie edition 💖

okay so. manual name is scriptlive, section 1, and it is literally about re-running session typescripts with timing info. buckle up, this one's a bop 🎀

---

✨ NAME ✨

scriptlive — re-run session typescripts, using timing information

---

🌸 SYNOPSIS 🌸

scriptlive [options] timingfile typescript

---

🦋 DESCRIPTION 🦋

So here's the vibe: this program re-runs a typescript, using stdin typescript and timing information to make sure the input happens in the exact same rhythm as it originally appeared when the script was recorded. it's giving "playback but make it authentic" 💅

The session runs in a newly created pseudoterminal with your $SHELL (or it defaults to /bin/bash if that's not a thing).

⚠️ bestie be careful!! the typescript may contain arbitrary commands. like, anything. it is genuinely recommended that you use "scriptreplay --stream in --log-in typescript" (or with --log-io instead of --log-in) to verify the typescript before it is executed with scriptlive. do the vibe check first, fr fr 🙈

The timing information is what script(1) outputs to the file specified by --log-timing. The typescript has to contain stdin information, and is what script(1) outputs to the file specified by --log-in or --log-io. iykyk ✨

---

👑 OPTIONS 👑

• -c, --command command — execute command instead of an interactive shell. The command gets passed as an argument to the -c option of the execution shell. The shell used is either $SHELL, the shell defined in the user's passwd(5) database, or _PATH_BSHELL — selected in respective order, no cap.
• -I, --log-in file — file containing script's terminal input. 📥
• -B, --log-io file — file containing script's terminal output and input. both!! 🤝
• -E, --echo when — this one controls the ECHO flag for the slave end of the session's pseudoterminal. The supported modes are always, never, and auto. The default is auto — in which case ECHO is enabled. This default behavior is subject to change. 👀
• -t, --timing file — file containing script's timing output. This option replaces the timingfile positional argument. bye positional arg, hello flag 🫶
• -T, --log-timing file — an alias for -t; maintained for compatibility with the script(1) command-line options. legacy but cute 💜
• -d, --divisor number — speed up the replay by displaying it this many times. The argument is a floating-point number. It's called divisor because it divides the timings by this factor. This option overrides old-style arguments. math girlies rise 🔥
• -m, --maxdelay number — set the maximum delay between updates to number of seconds. The argument is a floating-point number. This can be used to avoid long pauses in the typescript replay. no more awkward silences 😭
• -h, --help — display help text and exit.
• -V, --version — display version and exit.

---

🎀 EXAMPLES 🎀

okay watch this, it's iconic:

% script --log-timing file.tm --log-in script.in
Script started, file is script.out
% date
<etc, etc>
% exit
Script done, file is script.out
% scriptlive --log-timing file.tm --log-in script.in

---

🌈 AUTHORS 🌈

Karel Zak <kzak@redhat.com> — king behavior, honestly 👑

---

💜 COPYRIGHT 💜

Copyright © 2019 Karel Zak

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Released under the GNU General Public License version 2 or later. slay 📜

---

⭐ SEE ALSO ⭐

script(1), scriptreplay(1)

---

🐛 REPORTING BUGS 🐛

For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>. tell them everything, bestie 💌

---

🌟 AVAILABILITY 🌟

The scriptlive command is part of the util-linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.

---

and that's the whole page, periodt 💅 this was util-linux 2.42.4, dated 2026-09-21, and yes it's SCRIPTLIVE(1) — go forth and replay responsibly, my love 🦋✨