Skip to content
▶️ Converts an asciinema cast to an animated GIF.
JavaScript CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Initial commit. Aug 7, 2019
LICENSE Initial commit Aug 7, 2019 Add a size option. Aug 11, 2019
core.js Show progress percentage on all browsers. Aug 12, 2019
example.gif Use higher resolution example.gif. Aug 10, 2019
index.html Add note about background tab throttling to <details>. Aug 12, 2019
style.css Show progress percentage on all browsers. Aug 12, 2019


gifcast is a web page that converts asciinema casts to animated GIFs.

The code runs fully in the browser. That is, there are no server-side calls to process the cast and/or convert to animated GIF. The implementation is in JavaScript.

How To Use

gifcast expects the asciinema cast to have a .cast extension. See below for instructions on recording an asciinema cast.

To convert an asciinema cast to an animated GIF, navigate to index.html, load the cast, select a size, and click Render.

gifcast is available at

Recording a Cast

Recording requires the asciinema program, which runs independently of gifcast.

To record an asciinema cast, launch a new recording for your session, and terminate the session with Ctrl-D.

$ asciinema rec PATH/FILENAME.cast


The animated GIF below was generated with gifcast.


The source code has an MIT License.



gifcast depends on code from:

  1. xterm.js
  2. omggif
You can’t perform that action at this time.