# scriptlive

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


## 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/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) 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 man-pages@man7.org
    
    util-linux 2.42-start-521-ec46  2025-08-09                  _SCRIPTLIVE_(1)
    


* * *