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 |
| ttystudio | Excellent terminal-to-gif recorder |
| ffscreencast | Shell wrapper for ffmpeg that allows fool-proof screen recording |
| tty2gif | Record scripts into both binary and gif formats |
| TermRecord | Terminal session recorder with easy-to-share self-contained HTML output |
| IPBT | High-tec terminal player |
| rec | Records terminal sessions and turns them into reusable workflows |
| ttyrec | Terminal recorder, incudes a playback tool |
| termrec | Set of tools for recording and replaying tty sessions |
| screencast | Interface to record a X11 desktop |
| rewindtty | Terminal session recorder and replayer |
| Showterm | Terminal record and upload utility |
| termtosvg | Render SVG animations of shell sessions |
| script | The granddaddy of terminal recorders |
| Shelr | Broadcast plain text screencasts |
Read our verdict in the software roundup.
 Explore our carefully curated directory of recommended free and open source software, covering every major software category.The directory forms part of our extensive collection of articles for Linux enthusiasts. It includes hundreds of detailed reviews, together with free and open source alternatives to proprietary software from companies such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. LinuxLinks also covers interesting projects worth exploring, Linux-compatible hardware, free programming books and tutorials, and much more. Know a useful free and open source Linux application that we haven’t covered? Tell us about it using our submission form. |
Please read our Comment Policy before commenting.