agg is a command-line tool for converting terminal session recordings in the asciicast format into animated GIF files. It complements asciinema by providing a local rendering workflow for recordings that need to be included in websites, documentation, README files or presentations.
The program renders terminal content rather than taking screenshots of an existing terminal window. This gives agg substantial control over fonts, themes, dimensions and timing when producing the finished animation. Input can come from a file on disk, standard input or a remote recording URL.
GIF encoding uses gifski to generate high-quality output with accurate frame timing.
This is free and open source software.
Key Features
- Converts asciicast recordings from all three generations of the recording format.
- Accepts recordings from local files, standard input and HTTP or HTTPS URLs.
- Uses gifski for optimised GIF output and accurate animation timing.
- Includes a wide selection of built-in terminal colour themes.
- Supports custom colour themes supplied directly on the command line.
- Automatically uses a colour theme embedded in a recording when available.
- Configurable font families, font size and line height.
- Supports additional font directories outside normal system font locations.
- Provides fallback handling for symbols, including Nerd Font symbols.
- Supports colour emoji fonts.
- Offers alternative rendering backends.
- Adjust playback speed and limit long periods of terminal inactivity.
- Select sections of a recording by time range, position, marker, percentage or event index.
- Produce looping animations or GIFs which play only once.
- Control the maximum frame rate and duration of the final frame.
- Override terminal rows and columns to render a recording at different dimensions.
Website: github.com/asciinema/agg
Support:
Developer: Marcin Kulik
License: GNU General Public License v3.0

agg is written in Rust. Learn Rust with our recommended free books and free tutorials.
Related Software
| Console Screencasting Tools / Terminal Session Recording | |
|---|---|
| Terminalizer | Generates animated GIF images of your terminal |
| VHS | Wwrite terminal GIFs as code for integration testing and demoing |
| ttyd | Shares your terminal over the web |
| asciinema | Record and share terminal sessions |
| t-rec | Generates animated GIF images for the web |
| agg | asciinema gif generator |
| ffscreencast | Shell wrapper for ffmpeg that allows fool-proof screen recording |
| IPBT | High-tec terminal player |
| rec | Records terminal sessions and turns them into reusable workflows |
| TermSVG | Record terminal sessions and export them as animated SVG files |
| termrec | Set of tools for recording and replaying tty sessions |
| screencast | Interface to record a X11 desktop |
| script | The granddaddy of terminal recorders |
Read our verdict in the software roundup.
LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |


Please read our Comment Policy before commenting.