agg
Convert terminal recordings to animated GIFs
TLDR
SYNOPSIS
agg [options] input.cast output.gif
DESCRIPTION
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: 16).--font-family name
Comma-separated list of font families to use.--font-dir dir
Additional directory to scan for fonts.--line-height factor
Line height as a multiple of the font size (default: 1.4).--speed factor
Playback speed multiplier (default: 1).--theme name
Color theme (asciinema, dracula, github-dark, github-light, gruvbox-dark, kanagawa, monokai, nord, solarized-dark, solarized-light). Default: dracula.--cols n
Override terminal width in columns (default: from the recording).--rows n
Override terminal height in rows (default: from the recording).--fps-cap n
Maximum frames per second (default: 30).--renderer type
Rendering backend: swash (default) or resvg.--idle-time-limit seconds
Limit idle time between frames to this many seconds (default: 5).--no-loop
Disable looping; play the animation only once.--last-frame-duration seconds
How long to hold the last frame (default: 3).
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.
