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 files (v1, v2, v3) 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:

  • conversion of asciicast recordings (v1, v2, v3) to animated GIF files,
  • input from local files, stdin, or HTTP(S) URLs (e.g. asciinema.org recording links),
  • high-quality, optimized GIF output with accurate frame timing via the gifski encoder,
  • multiple built-in color themes (asciinema, dracula, monokai, github-dark, github-light, kanagawa, nord, solarized-dark, solarized-light, gruvbox-dark, and more),
  • custom ad-hoc themes specified as hex color triplets,
  • automatic use of the recording's embedded theme when present,
  • configurable font families with sensible cross-platform defaults and implicit fallbacks for symbols,
  • configurable font size and line height,
  • additional font directory support via --font-dir for fonts outside standard system locations,
  • color emoji rendering with support for Apple Color Emoji, Noto Color Emoji, and other common emoji fonts,
  • two selectable rendering backends: swash (default) and resvg,
  • adjustable playback speed,
  • idle time limiting to skip periods of inactivity,
  • looped or single-pass playback,
  • configurable FPS cap and last-frame duration,
  • terminal size override (cols/rows) for re-rendering at a different geometry.

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