agg is a command-line tool for generating animated GIF files from asciicast v2 files produced by asciinema terminal recorder.
agg is a command-line tool designed to generate animated GIF files from terminal session recordings, specifically supporting asciicast v2 files produced by asciinema. It leverages the gifski library to create optimized, high-quality animations with accurate frame timing.
Key Features:
Support for asciicast v2: Converts terminal recording files into engaging GIFs.
Integration with gifski: Ensures output is visually appealing and optimized.
Customizable Output: Users can adjust colors, delays, and other parameters to tailor the animation.
Optimized File Size: Balances quality with minimal file size for efficient sharing.
Ideal for developers, educators, and terminal enthusiasts, agg enables the creation of professional-grade animations from terminal sessions. It offers precise control over timing and visual elements, making it a powerful tool for demonstrating processes or showcasing work efficiently.
README
agg - asciinema gif generator
agg is a command-line tool for generating animated GIF files from terminal
session recordings.
It supports conversion from asciicast
v2
files produced by asciinema recorder.
It uses Kornel Lesiński's excellent
gifski library to produce optimized,
high quality GIF output with accurate frame timing.
Example GIF file generated with agg:
Check out the agg docs for
installation and usage overview.
You need to ensure $HOME/.cargo/bin is in your shell's $PATH.
Alternatively, you can manually download source code and build agg binary with:
git clone https://github.com/asciinema/agg
cd agg
cargo build --release
This produces an executable file in release mode (--release) at
target/release/agg. There are no other build artifacts so you can copy the
binary to a directory in your $PATH.
Building with Docker
Alternatively, if you have Docker, Podman or another Docker-compatible tool
installed you can use it to build agg container image. This doesn't require Rust
toolchain installed on your machine.
