## Recording Shell Output the Right Way ## written by Abdus on 10 July, 2020

Table of Contents

TL,DR; go and install asciinema from asciinema.org and start recording your terminal sessions.

We, the terminal geeks often need to record our shell in-order to explain something to our geek friends; or even just to showcase a new CLI tool we built yesterday night.

Recording Screen …

Sucks! Yes, it sucks. Why? couple of good reasons:

… and many other things.

… the Right Way!

asciinema is here to rescue. ASCIINema is a command-line tool to record a shell session. It is not just another recorder. It records ASCII characters from stdin, stdout and stderr devices. And presents the output in a way that is playable right inside the terminal.


Here, I am listing the most popular and commonly used features from asciinema. For a detailed list, visit asciinema official website.

Guess that much of features are enough to convince you :)


Loads of ways. Using:

more ways on installation page.

How to use

To start recording, type asciinema rec and hit enter. This will spwan a new shell window(which will obviously be recorded).

On recording finish, asciinema would ask whether you want to upload it to ASCIINema website. If not, it will be saved locally.

asciinema play is capable of playing a local asciicast as well as a remote asciicast from a URL.

asciinema cat spits out text available from a cast. output can be copied to system clipboard.


Far better than old-school screen-recording tools when it comes to terminal session recording.