Skip to content

agg - asciinema gif generator

agg is a command-line tool for generating animated GIF files from terminal session recordings.

It supports conversion from asciicast v2 files produced by asciinema recorder. It uses Kornel LesiƄski's excellent gifski library to produce optimized, high quality GIF output with accurate frame timing.

Example GIF file generated with agg:

Example GIF file generated with agg

Notable features:

  • creating GIFs from local .cast files as well as from recordings hosted at,
  • multiple built-in color themes, ability to use a custom theme,
  • font family and font size customization,
  • adjustable animation speed,
  • emoji support (mono).

agg is free and open-source software (FOSS). Source code and license available at