Manual: scriptlive

SCRIPTLIVE(1)					User Commands				       SCRIPTLIVE(1)

NAME
       scriptlive - re-run session typescripts, using timing information

SYNOPSIS
       scriptlive [options] timingfile typescript

DESCRIPTION
       This program re-runs a typescript, using stdin typescript and timing information to ensure that input
       happens in the same rhythm as it originally appeared when the script was recorded.

       The session is executed in a newly created pseudoterminal with the user’s $SHELL (or defaults to
       /bin/bash).

       Be careful! The typescript may contain arbitrary commands. It is recommended to 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.

       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.

OPTIONS
       -I, --log-in file
	   File containing script's terminal input.

       -B, --log-io file
	   File containing script's terminal output and input.

       -E, --echo when
	   This option 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.

       -T, --log-timing file
	   An alias for -t; maintained for compatibility with the script(1) command-line options.

       -d, --divisor number
	   Speed up the replay displaying this number of 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.

       -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.

       -h, --help
	   Display help text and exit.

       -V, --version
	   Display version and exit.

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

AUTHORS
       Karel Zak 

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.

SEE ALSO
       script(1), scriptreplay(1)

REPORTING BUGS
       For bug reports, use the issue tracker .

AVAILABILITY
       The scriptlive command is part of the util-linux package which can be downloaded from Linux Kernel
       Archive .

util-linux 2.41.3				 2025-12-15				       SCRIPTLIVE(1)