Terminal Session Recording

agg – asciinema GIF generator

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

Demo of agg
Click image for full size

agg is written in Rust. Learn Rust with our recommended free books and free tutorials.


Related Software

Console Screencasting Tools / Terminal Session Recording
TerminalizerGenerates animated GIF images of your terminal
VHSWwrite terminal GIFs as code for integration testing and demoing
ttydShares your terminal over the web
asciinemaRecord and share terminal sessions
t-recGenerates animated GIF images for the web
aggasciinema gif generator
ffscreencastShell wrapper for ffmpeg that allows fool-proof screen recording
IPBTHigh-tec terminal player
recRecords terminal sessions and turns them into reusable workflows
TermSVGRecord terminal sessions and export them as animated SVG files
termrecSet of tools for recording and replaying tty sessions
screencastInterface to record a X11 desktop
scriptThe granddaddy of terminal recorders

Read our verdict in the software roundup.


Best Free and Open Source Software 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.
Subscribe

Please read our Comment Policy before commenting.

Notify of
guest
0 Comments
Oldest
Newest Most Voted