Asciinema is an awesome tool for recording your console sessions. It’s great for documenting processes and, in general, showing people how shit works: one look is worth a thousand words, as they say. Unfortunately, I don’t use asciinema often enough to remember the syntax and so here we are.

I strongly believe that new things are rarely good but are always annoying. In time you will come to the same conclusion. I am still clinging to CentOS/RHEL 6 and, unfortunately, the features of asciinema I find most valuable are only available in version 2+, which requires Python 3. And so I had to jump through a few hoops to install it without screwing up the OS (just remember – yum uses Python and it’s kind’a important).

The “basic” steps are: update system, install the latest version of Python and PIP, install Asciinema:

This is the price one pays for being set in one’s ways. Let’s get to asciinema now. When you record a video, you have an option of storing it locally (self-hosted option) or uploading it to the asciinema.org server. The latter is easier.

The first step is to create your account. Just head over to asciinema.org and create an account. Next, run asciinema auth. You will be give a url. Go there, log in with the account you just created. Then check email and click on the verification link. Fairly thorough and secure process.

Now, let’s make a test recording. The following command will start the recording session and, when you’re done and hit CTRL-D, it will upload the fruits of your labor to asciinema.org server.

Now head over to asciinema.org, log in, and your recordings should be there. You can click on “Share” and select “Embed the Player” code and paste it in your blog. And here it is.

Some additional URL parameters allow you to control appearance and playback. For example, here’s an image link to the same video as above, but using the solarized-dark theme and playing 2.5 times faster.

Leave A Reply

Please enter your comment!
Please enter your name here