# Install agg with Homebrew, MacPorts, Nix, apt, scoop, winget

Asciicast to GIF converter. Version 1.9.0 via Homebrew; verified 2026-07-10. Also installable with debian: sudo apt install libagg-dev.

## 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

- 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

- 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

### 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
- **Version:** 1.9.0
- **Source summary:** Asciicast to GIF converter
- **Homepage:** <https://docs.asciinema.org/manual/agg/>
- **Repository:** <https://github.com/asciinema/agg>
- **Last updated:** 2026-07-10T16:49:54-04:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- agg (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.9.0
## 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

## 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


## Combined YAML source

View the package source record on GitHub. [combined/agg.yml](https://github.com/mxcl/pkgdb/blob/main/combined/agg.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph