agg

Convert terminal recordings to animated GIFs

TLDR

Convert asciinema recording to GIF

$ agg [recording.cast] [output.gif]

Set font size

$ agg --font-size [20] [recording.cast] [output.gif]

Set playback speed

$ agg --speed [2] [recording.cast] [output.gif]

Use custom theme

$ agg --theme [monokai] [recording.cast] [output.gif]

Set output dimensions

$ agg --cols [80] --rows [24] [recording.cast] [output.gif]

SYNOPSIS

agg [options] input.cast output.gif

agg (asciinema gif generator) converts asciinema terminal recordings to animated GIF files. It renders terminal sessions including colors, cursor, and all formatting into a high-quality GIF suitable for documentation or sharing.
The tool is written in Rust and provides options for customizing output appearance including themes, fonts, dimensions, and playback speed.

PARAMETERS

--font-size size

Font size in pixels (default: 14)

--font-family name

Font family name

--speed factor

Playback speed multiplier

--theme name

Color theme (asciinema, dracula, monokai, solarized-dark, solarized-light)

--cols n

Terminal width in columns

--rows n

Terminal height in rows

--fps n

Frames per second (default: variable)

--renderer type

Renderer: fontdue or resvg

--idle-time-limit seconds

Maximum idle time between frames

CAVEATS

Large or long recordings produce large GIF files. Consider adjusting speed or idle-time-limit to reduce file size. Font rendering quality depends on available system fonts.

HISTORY

agg was created as a Rust-based alternative to other asciinema-to-GIF tools, providing better performance and rendering quality. It's maintained as part of the asciinema ecosystem.

agg