scriptlive(1) — Linux manual page


SCRIPTLIVE(1)                   User Commands                  SCRIPTLIVE(1)

NAME         top

       scriptlive - re-run session typescripts, using timing information

SYNOPSIS         top

       scriptlive [options] [-t] timingfile [-I|-B] typescript

DESCRIPTION         top

       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!  Do not forget that the typescript may contains 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 by scriptlive(1).

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

OPTIONS         top

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

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

       -t, --timing file
              File containing script's timing output.  This option overrides
              old-style arguments.

       -T, --log-timing file
              Aliased to -t, maintained for compatibility with 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.

       -V, --version
              Display version information and exit.

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

EXAMPLES         top

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

AUTHORS         top

       Karel Zak ⟨⟩.

COPYRIGHT         top

       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

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

SEE ALSO         top

       script(1), scriptreplay(1)

AVAILABILITY         top

       The scriptlive command is part of the util-linux package and is
       available from Linux Kernel Archive 

COLOPHON         top

       This page is part of the util-linux (a random collection of Linux
       utilities) project.  Information about the project can be found at 
       ⟨⟩.  If you have a
       bug report for this manual page, send it to  This page was obtained from the
       project's upstream Git repository
       ⟨git://⟩ on
       2020-08-13.  (At that time, the date of the most recent commit that
       was found in the repository was 2020-08-12.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

util-linux                      October 2019                   SCRIPTLIVE(1)

Pages that refer to this page: script(1)scriptlive(1)scriptreplay(1)