Asciinema Instructions

Click the GIF image below to see an asciinema demo!

asciinema test


A demonstration of the asciinema terminal recording tool


2' 25" : The timeline indicates 4' 49" but in fact the recording is fast forwarded 2x with the "speed: 2" option put in the html template.




Terminal recording tool
Preferred recording method: Captured from Alexandre Racine's computer


A demonstration of the commands needed to install it on Mac OS X and Linux Ubuntu

CERN video content owner

Maria Dimou

Other information:

Full asciinema installation and usage instructions are attached to this twiki.

One expects 4 files to be created at the end of a terminal session recorded with asciinema: .js, .json, .css, .html. We make the .html by copy/pasting in a file of our own the

<HEAD> and <BODY>
etc wrapping tags offered to us by the asciinema site to encapsulate the links to the other 3 outputs .js, .json and .cssconstructed by the product. Hence, these files must live on the web. This is why we have attached these actual files to this page.

One can convert asciinema casts to animated GIFs using this tool: but the copy/paste possibility is lost.
If you face an SSL error during this conversion, such as:

ERROR: Couldn't open
ERROR: SSL handshake failed

Please refer to this issue on Github and replace the content in line 113 in the asciinema2gif script:
phantomjs "${rundir}/render.js" "${asciinema_url}"
phantomjs --ssl-protocol=any "${rundir}/render.js" "${asciinema_url}"

The reply obtained by the developers on Github indicates that a new release should be done soon and the problem corrected.
The GIF image generated and placed at the top of this page is a link to the real video (attached to this twiki) which allows to copy / paste the text.

In order to show a video made with asciinema in the twiki Video Library, we attach the gif generated from the conversion to the same Video Library page and use these tags at the beginning of the twiki page source:

<a href="%ATTACHURL%/index.html">
<img src="%PUBURL%/cern/asciicast.gif" alt="Play Video">
The GIF image generated and placed at the top of this page is a link to the real video (attached to this twiki) which allows to copy / paste the text.

On how to register in CDS videos made with asciinema, pending answer from the CDS experts.

Related Videos

Create a new video under this topic

New Topic Create a new Video: (Use a topic name in WikiNotation)

Video Discussion

No audio possible when using asciinema, for now.

-- Maria Dimou - 2016-09-07

We are making progress in registering an animated gif in CDS generated from a terminal recording with asciinema. Follow if you have a CERN login.

-- Maria Dimou - 2016-09-07

use the attach button below to upload the video to this page. Then copy/paste the %ATTACHURL% url the video tag above

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatjson asciicast-82223.json r1 manage 31.3 K 2016-08-10 - 10:29 UnknownUser asciinema recording (named asciicast) in .json format
GIFgif asciicast.gif r1 manage 495.5 K 2016-08-10 - 10:30 UnknownUser  
Cascading Style Sheet filecss asciinema-player.css r1 manage 50.1 K 2016-08-03 - 10:19 UnknownUser CSS template for the javascript player
JavaScriptjs asciinema-player.js r1 manage 500.9 K 2016-08-03 - 10:19 UnknownUser Script for the .js player
PDFpdf asciinema_installation_instructions.pdf r1 manage 144.2 K 2016-08-03 - 10:19 MariaDimou Terminal recording tool asciinema - installation instructions by Alexandre Racine
HTMLhtml index.html r5 r4 r3 r2 r1 manage 0.3 K 2016-08-10 - 10:29 UnknownUser html template to play the asciicast. Links in it to the three other files must be set with the right paths depending on where you store the files. The name does not need to be index.html, you can name your recording as you want.
Edit | Attach | Watch | Print version | History: r19 < r18 < r17 < r16 < r15 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r19 - 2017-03-02 - MariaDimou
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    Edutech All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2023 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback