# scriptreplay

## NAME



           scriptreplay - play back typescripts, using timing information
    


## SYNOPSIS



           **scriptreplay**[options] _timingfile_ [_typescript_ [_divisor_]]
    


## DESCRIPTION



           This program replays a typescript, using timing information to
           ensure that output happens in the same rhythm as it originally
           appeared when the script was recorded.
    
           The replay simply displays the information again; the programs
           that were run when the typescript was being recorded are **not run**
           **again**. Since the same information is simply being displayed,
           **scriptreplay** is only guaranteed to work properly if run on the
           same type of terminal the typescript was recorded on. Otherwise,
           any escape characters in the typescript may be interpreted
           differently by the terminal to which **scriptreplay** is sending its
           output.
    
           The timing information is what script(1) outputs to file specified
           by **--log-timing**.
    
           By default, the _typescript_ to display is assumed to be named
           **typescript** , but other filenames may be specified, as the second
           parameter or with option **--log-out**.
    
           If the third parameter or **--divisor** is specified, it is used as a
           speed-up multiplier. For example, a speed-up of 2 makes
           **scriptreplay** go twice as fast, and a speed-down of 0.1 makes it go
           ten times slower than the original session.
    
           During the replay, you can interactively speed up, slow down, or
           pause the playback using the Up, Down, and Space keys.
    


## OPTIONS



           **-I** , **--log-in** _file_
               File containing **script** 's terminal input.
    
           **-O** , **--log-out** _file_
               File containing **script** 's terminal output.
    
           **-B** , **--log-io** _file_
               File containing **script** 's terminal output and input.
    
           **-t** , **--timing** _file_
               File containing **script** 's timing output. This option replaces
               the _timingfile_ positional argument.
    
           **-T** , **--log-timing** _file_
               This is an alias for **-t** , maintained for compatibility with
               script(1) command-line options.
    
           **-s** , **--typescript** _file_
               Deprecated alias of **--log-out**.
    
           **-c** , **--cr-mode** _mode_
               Specifies how to handle the CR (carriage return, 0x0D)
               character from log files. The default mode is **auto** , in which
               case CR is replaced with a line break for the stdin log,
               because otherwise **scriptreplay** would overwrite the same line.
               The other modes are **never** and **always**.
    
           **-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.
    
           **--summary**
               Display details about the session recorded in the specified
               timing file and exit. The session must have been recorded
               using the **advanced** format (see script(1) option
               **--logging-format** for more details).
    
           **-x** , **--stream** _type_
               Forces **scriptreplay** to print only the specified stream. The
               supported stream types are **in** , **out** , **signal** , and **info**. This
               option is recommended for multi-stream logs (created with
               **--log-io**) in order to print only the desired data.
    
           **-h** , **--help**
               Display help text and exit.
    
           **-V** , **--version**
               Display version and exit.
    


## EXAMPLES



               % script --log-timing file.tm --log-out script.out
               Script started, file is script.out
               % ls
               <etc, etc>
               % exit
               Script done, file is script.out
               % scriptreplay --log-timing file.tm --log-out script.out
    


## KEY BINDINGS



           The following keys control the playback of the script:
    
           •   **Space** : Toggles pause and unpause. Press this key to pause the
               playback, and press it again to resume.
    
           •   **Up Arrow** : Increases the playback speed. Each press of this key
               will make the script replay faster by x0.1.
    
           •   **Down Arrow** : Decreases the playback speed. Each press of this
               key will slow down the script replay by x0.1.
    


## AVAILABILITY



           The **scriptreplay** 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                _SCRIPTREPLAY_(1)
    


* * *