macOS
Homebrewverified · 100%
brew install agglocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install aggMacPorts ports tree · graphics/agg/Portfile · source: api.github.com
brew
Install agg with Homebrew, apt, MacPorts, Nix, scoop, winget
Asciicast to GIF converter. Version 1.9.0 via Homebrew; verified 2026-06-15.
install
Additional install commands
Linux
Debian aptverified · 92%
sudo apt install libagg-devDebian stable package indexes · libagg-dev · source: deb.debian.org
Nixverified · 92%
nix profile install nixpkgs#aggnixpkgs package indexes · pkgs/by-name/ag/agg/package.nix · source: api.github.com
Windows
Scoopverified · 92%
scoop install main/aggScoop official bucket manifest trees · bucket/agg.json · source: api.github.com
Windows Package Managerverified · 92%
winget install --id asciinema.agg -eWindows Package Manager source index · asciinema.agg · source: cdn.winget.microsoft.com
overview
Package summary
Asciicast to GIF converter
Project links
Commands and aliases
- agg
history
Project history and usage
agg, the asciinema gif generator, is a command-line tool for rendering terminal session recordings in asciicast format to animated GIF files.
Project history
The agg repository was created under the asciinema organization in July 2022, and v1.0.0, named Hello, World!, was released in August 2022. The README describes it as a command-line generator for animated GIF files from terminal session recordings.
agg belongs to the broader asciinema ecosystem created by Marcin Kulik. Whereas asciinema records, streams, and plays terminal sessions, agg focuses on producing portable GIF artifacts from asciicast files. Later releases through 2026 continued the 1.x line.
Adoption history
The upstream README documents building and installing with Cargo from the GitHub repository, manual source builds, and Docker/Podman image builds. The supplied package metadata shows Homebrew, MacPorts, Nix, Scoop, and winget packaging for agg; Debian and Ubuntu entries in the supplied facts refer to `libagg-dev`, so they should not be treated as upstream asciinema agg adoption without separate confirmation.
How it is used
agg converts asciicast recordings produced by asciinema into GIF output. The README highlights support for asciicast v1, v2, and v3, input from local files, stdin, or HTTP(S) URLs, optimized GIF output through gifski, built-in and custom themes, font controls, emoji rendering, multiple rendering backends, playback speed, idle-time limiting, frame selection, looping, FPS caps, and terminal-size overrides.
Its usual package-manager value is pragmatic: a user records a terminal session with asciinema, then ships a GIF for documentation, READMEs, release notes, issue reports, or places where embedded asciinema playback is not available.
Why package nerds care
agg sits at a fun packaging intersection: terminal recording culture, Rust command-line distribution, font rendering, GIF encoding, and documentation workflows. It is the package you reach for when a terminal cast needs to become a boring old image file that every platform can show.
It also demonstrates how ecosystem packages grow around a file format. asciicast is the format; asciinema is the recorder/player; agg is the renderer/exporter.
Timeline
- 2022: GitHub repository created.
- 2022: v1.0.0 released.
- 2023: v1.4.x releases published.
- 2024: v1.5.0 released.
- 2025: v1.6.0 and v1.7.0 released.
- 2026: v1.8.x and v1.9.0 released.
Related projects
- asciinema is the terminal session recorder, streamer, and player that produces asciicast recordings.
- asciicast is the recording file format agg consumes.
- gifski is the GIF encoder library named by the README as the basis for optimized output.
Sources
- official GitHub releases API
- official GitHub repository metadata
- official asciinema docs
- source_facts.package-manager with Debian/Ubuntu caveat
- upstream README
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Build metadata lists 1 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
agg | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version1.9.0
manager updated2026-06-15
local dataok
upstreamcurrent
latest detectedv1.9.0
https://github.com/asciinema/agg
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:agg |
|---|---|
| Version | 1.9.0 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/agg |
| Homepage | https://docs.asciinema.org/manual/agg/ |
| Repository | https://github.com/asciinema/agg |
| Upstream docs | https://docs.asciinema.org/manual/agg |
| License | GPL-3.0-or-later |
| Source archive | https://github.com/asciinema/agg/archive/refs/tags/v1.9.0.tar.gz |
| Last updated | 2026-06-15T10:20:09-04:00 |
| Pulse | updated |
| Build dependencies | rust |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | agg |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Debian apt95%
libagg-dev 1:2.7.0.r145+dfsg-2
AntiGrain Geometry graphical toolkit (static development files)
sudo apt install libagg-dev- Section: libdevel
- Architecture: amd64
- Source Package: agg
- normalized package name match
- Matched by: Agg
Debian apt95%
libagg2-dev 1:2.7.0.r145+dfsg-2
AntiGrain Geometry graphical toolkit (static and shared development files)
sudo apt install libagg2-dev- Section: libdevel
- Architecture: amd64
- Source Package: agg
- 1 dependencies
- normalized package name match
- Matched by: Agg
Debian apt95%
libagg2t64 1:2.7.0.r145+dfsg-2
AntiGrain Geometry graphical toolkit (runtime files)
sudo apt install libagg2t64- Section: libs
- Architecture: amd64
- Source Package: agg
- 3 dependencies
- 1 provides
- normalized package name match
- Matched by: Agg
Nix95%
agg
nix profile install nixpkgs#agg- normalized package name match
- Matched by: Agg
Ubuntu apt95%
libagg-dev 1:2.6.1-r134+dfsg1-2.1build1
AntiGrain Geometry graphical toolkit (static development files)
sudo apt install libagg-dev- Section: universe/libdevel
- Architecture: amd64
- Source Package: agg
- normalized package name match
- Matched by: Agg
Ubuntu apt95%
libagg2-dev 1:2.6.1-r134+dfsg1-2.1build1
AntiGrain Geometry graphical toolkit (static and shared development files)
sudo apt install libagg2-dev- Section: universe/libdevel
- Architecture: amd64
- Source Package: agg
- 1 dependencies
- normalized package name match
- Matched by: Agg
Ubuntu apt95%
libagg2t64 1:2.6.1-r134+dfsg1-2.1build1
AntiGrain Geometry graphical toolkit (runtime files)
sudo apt install libagg2t64- Section: universe/libs
- Architecture: amd64
- Source Package: agg
- 3 dependencies
- 1 provides
- normalized package name match
- Matched by: Agg
MacPorts95%
agg
sudo port install agg- normalized package name match
- Matched by: Agg
Scoop95%
main/agg
scoop install main/agg- normalized package name match
- Matched by: Agg
winget95%
asciinema.agg
winget install --id asciinema.agg -e- normalized package name match
- Matched by: Agg
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment