ASCIINEMA - How to use it!
•
by
Chris Phillips
In a few articles I have used Asciinema. I am not affiliated anyway with this tool just a big fan.
It is the youtube of the command prompt.
The service is free (As far as I have found). It allows you to record a terminal/bash session and upload it to their website. What it uploads is much smaller then a regular video. In addition if you want to copy and paste from the video, you can!
Demo
Installing the Application
It is in all good Package repositories. On a Mac with brew installed I simply ran
brew install asciinema
Recording a session
The most common way method I use is the following.
asciinema rec -t TITLE
This will record the commands and their out put in the termianl session. Then, when you leave the session with exit it gives the option of uploading to their server where you can link to it. TITLE should replaced with the title of the video.
Playing a session
After you have uploaded a video two URLs are provided. The first is a link to the video. The second is a link to take ownership of the video. If the video is not assinged to a user account it is removed after seven days.
If you do not want to watch the video from the website but instead watch it locally in your terminal run the following command.
asciinema play <URL to asci cinema>
Emebedding the videon into markdown
This sample markdown code allows you to embeded a screenshot of the video which is a link to the video on ASCIINEMA. There is no way (as far as i know) to allow it to play on your webpage.
[](https://asciinema.org/a/17648)
Replace 17648 with the unique id given to your video
For detailed information on the instructions and more visit their website and https://asciinema.org