agg 1.9.0

agg is a command-line tool for generating animated GIF files from asciicast v2 files produced by asciinema terminal recorder.

  • By asciinema
  • Open Source
  • Updated May 29, 2026
Download for Windows

About agg

agg is a command-line tool for generating animated GIF files from asciicast v2 files produced by asciinema terminal recorder.

What's new in 1.9.0

This release improves the rendering quality of certain glyph sets and adds the ability to select which frames to render:
- improved box drawing glyphs (light/heavy lines, half-lines, corners, junctions) by using font metric-based strokes
- improved rendering of Powerline symbols in the default (swash) renderer
- fixed the kanagawa-light theme
- added the --select option for frame selection (see below)
Example of box drawing, Powerline, and emoji rendering in 1.9.0:
Frame selection
The new --select <SELECTOR> option allows choosing which part of a recording to render.
It supports both animated excerpts and discrete/slideshow-style selections:
agg --select 5..30 demo.cast clip.gif
agg --select 12.5 demo.cast frame.gif
agg --select marker:build..marker:test demo.cast build.gif
agg --select markers demo.cast markers.gif
A selector can be:
- .. (default), POS.., ..POS, or POS..POS for time ranges
- POS or POS,POS,... for discrete positions
- markers for all marker positions
POS can be a time (12.5, 1m20s, 1:20), a percentage (50%), a marker (marker:build, marker:3), or an event index (event:100). Selection is resolved on the adjusted output timeline, after idle-time limiting and speed adjustment.
Range selections use the normal animated GIF path: visual deduplication, timestamp normalization, and FPS capping. Discrete selections keep every resolved selected position and assign sequential output timestamps using --last-frame-duration.
Example of a "slideshow" GIF generated from demo.cast (from this repo) using the following command:
agg --font-size 20 --select 20%,40%,63%,94% --last-frame-duration 2 demo.cast demo-select.gif

Full release notes »

Technical details

Publisherasciinema
Version1.9.0
Release date2026-05-29
LicenseGPL-3.0
Installer typeportable
Architecturex64
Package IDasciinema.agg

Install agg from the command line

Install with Windows Package Manager
winget install --id=asciinema.agg -e
Update to the latest version
winget upgrade --id=asciinema.agg -e
Uninstall
winget uninstall --id=asciinema.agg -e

asciicastasciicast2gifasciinemacligifgifskipowersessionrust

agg version history

  • 1.8.1
  • 1.8.0
  • 1.7.0
  • 1.6.0
  • 1.5.0
  • 1.4.3
  • 1.4.2
  • 1.4.1
  • 1.3.0

Frequently asked questions

Is agg free?

Yes. agg is free and open-source software released under the GPL-3.0 license.

What is the latest version of agg?

The latest version is 1.9.0, released on May 29, 2026.

Is it safe to download agg?

The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with 810baf5506e74ca65d8ed85be3db58791086c8b7b0a17c9018d7fede473f0055.

Which Windows versions does agg support?

agg runs on Windows and is available for 64-bit (x64) systems.

How do I uninstall agg?

Open Settings › Apps › Installed apps, find agg and select Uninstall. From the command line, run winget uninstall --id=asciinema.agg -e.