# Install agg with Homebrew, apt, MacPorts, Nix, scoop, winget Asciicast to GIF converter. Version 1.9.0 via Homebrew; verified 2026-06-15. ## Install ```sh sudo av install brew:agg ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install agg ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install agg ``` Evidence: MacPorts ports tree: graphics/agg/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Debian apt (92%): ```sh sudo apt install libagg-dev ``` Evidence: Debian stable package indexes: libagg-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#agg ``` Evidence: nixpkgs package indexes: pkgs/by-name/ag/agg/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - Scoop (92%): ```sh scoop install main/agg ``` Evidence: Scoop official bucket manifest trees: bucket/agg.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id asciinema.agg -e ``` Evidence: Windows Package Manager source index: asciinema.agg from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:agg - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.9.0 - **Source summary:** Asciicast to GIF converter - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-or-later - **Source archive:** - **Last updated:** 2026-06-15T10:20:09-04:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - agg (cli) - agg (alias) ## Build dependencies - rust ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.9.0 - Package-manager updated: 2026-06-15 - Local data: ok - Upstream repository: https://github.com/asciinema/agg - Upstream latest detected: v1.9.0 (current) ## 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 Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## 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:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - libagg-dev - 1:2.7.0.r145+dfsg-2: normalized package name match | Debian stable package indexes: libagg-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | AntiGrain Geometry graphical toolkit (static development files) | http://www.antigrain.com - Debian apt - libagg2-dev - 1:2.7.0.r145+dfsg-2: normalized package name match | Debian stable package indexes: libagg2-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | AntiGrain Geometry graphical toolkit (static and shared development files) | http://www.antigrain.com - Debian apt - libagg2t64 - 1:2.7.0.r145+dfsg-2: normalized package name match | Debian stable package indexes: libagg2t64 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | AntiGrain Geometry graphical toolkit (runtime files) | http://www.antigrain.com - Nix - agg: normalized package name match | nixpkgs package indexes: pkgs/by-name/ag/agg/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - libagg-dev - 1:2.6.1-r134+dfsg1-2.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libagg-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | AntiGrain Geometry graphical toolkit (static development files) | http://www.antigrain.com - Ubuntu apt - libagg2-dev - 1:2.6.1-r134+dfsg1-2.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libagg2-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | AntiGrain Geometry graphical toolkit (static and shared development files) | http://www.antigrain.com - Ubuntu apt - libagg2t64 - 1:2.6.1-r134+dfsg1-2.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libagg2t64 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | AntiGrain Geometry graphical toolkit (runtime files) | http://www.antigrain.com - MacPorts - agg: normalized package name match | MacPorts ports tree: graphics/agg/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/agg: normalized package name match | Scoop official bucket manifest trees: bucket/agg.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - asciinema.agg: normalized package name match | Windows Package Manager source index: asciinema.agg from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata. - [Documentation packages](https://www.automicvault.com/pkg/documentation-tools/) - Matched documentation, manual, or publishing metadata. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [aview](https://www.automicvault.com/pkg/brew/aview/) - Shares av.db curated category or tags: cli, media, terminal. - [catimg](https://www.automicvault.com/pkg/brew/catimg/) - Shares av.db curated category or tags: cli, media, terminal. - [tpix](https://www.automicvault.com/pkg/brew/tpix/) - Shares av.db curated category or tags: cli, media, terminal. - [ttygif](https://www.automicvault.com/pkg/brew/ttygif/) - Shares av.db curated category or tags: cli, gif, media, terminal. - [chafa](https://www.automicvault.com/pkg/brew/chafa/) - Shares av.db curated category or tags: cli, media, terminal. - [libsixel](https://www.automicvault.com/pkg/brew/libsixel/) - Shares av.db curated category or tags: cli, media, terminal. - [termusic](https://www.automicvault.com/pkg/brew/termusic/) - Shares av.db curated category or tags: cli, media, terminal. - [aalib](https://www.automicvault.com/pkg/brew/aalib/) - Shares av.db curated category or tags: cli, media, terminal. ## Combined YAML source View the package source record on GitHub. [combined/agg.yml](https://github.com/automic-vault/db/blob/main/combined/agg.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph