Skip to main content

Recording Terminal Sessions

There are a couple of techniques that can be useful to record terminal sessions. The first is the asciinema too. The second is the script and scriptreplay commands, which can be used to record the actual keystrokes typed and then replay them.


The asciinema tool can record the output of terminal sessions. You can see the results in action in pages like Chapter 33 - Master the Multiplexer.

Some tips for working with asciinema:

To record a Tmux session, you will need to start detached from Tmux and then attach. You can do this by hand, simply using tmux attach, but this adds some noise to the beginning of the recording. A better way is to use the command below:

asciinema rec --command "tmux attach [-t session-name]"

Script Recording

Record a shell session by running:

# Start recording...
script recording.txt

# your commands...

# Finish the recording.

Once you have this recording, you can use it to rapidly record an asciinema file:

asciinema rec --command "tmux attach [-t session-name] && scriptreplay recording.txt"

It can be helpful to not record a timing file for the keystrokes. If your typing is slow or irregular, or you have to look something up halfway through a script, then having a consistent typing speed provided via a script is better. One way to do this is with the scriptreplay_ng tool.