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
       -c, --command command
           Execute command instead of an interactive shell. The command is
           passed as argument to the -c option of the execution shell. The
           used shell is either $SHELL, the shell defined in the user's
           passwd(5) database or _PATH_BSHELL, selected in respective order.

       -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
           <etc, etc>
           % exit
           Script done, file is script.out
           % scriptlive --log-timing file.tm --log-in script.in

AUTHORS
       Karel Zak <kzak@redhat.com>

COPYRIGHT
       Copyright (C) 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
       <https://github.com/util-linux/util-linux/issues>.

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

util-linux 2.42                   2026-04-01                     SCRIPTLIVE(1)