Automic VaultAutomic Vault

brew

Install ttygif with Homebrew, apt, MacPorts, Nix

Converts a ttyrec file into gif files. Version 1.6.0 via Homebrew; verified from local package data.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install ttygif

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install ttygif

MacPorts ports tree · graphics/ttygif/Portfile · source: api.github.com

Linux

Debian aptverified · 92%
sudo apt install ttygif

Debian stable package indexes · ttygif · source: deb.debian.org

Nixverified · 92%
nix profile install nixpkgs#ttygif

nixpkgs package indexes · pkgs/by-name/tt/ttygif/package.nix · source: api.github.com

overview

Package summary

Converts a ttyrec file into gif files

Commands and aliases

  • ttygif

history

Project history and usage

ttygif is a small converter that turns ttyrec terminal recordings into animated GIF files. Its README describes it as a stripped-down version of ttyplay that screenshots every frame.

Project history

The project builds directly on the older ttyrec format and workflow: users first record a terminal session with `ttyrec`, then run `ttygif` on the recording. The README credits tty2gif as the source of the idea and approach.

Official Git tags show ttygif releases beginning with a 1.0.8 tag in 2013 and continuing through later maintenance releases, including tags in 2016, 2020, and 2022.

Adoption history

The README documents setup paths for Debian/Ubuntu, Fedora/CentOS/RHEL, OpenSUSE, Arch Linux, and macOS through Homebrew. The supplied package facts also show packaging in Homebrew, Debian, MacPorts, Nix, and Ubuntu.

ttygif became useful in the package-nerd niche because it bridges old-school terminal recording and shareable web media: a reproducible terminal transcript could be converted into a GIF for READMEs, bug reports, and demos.

How it is used

The documented workflow is intentionally short: record with `ttyrec myrecording`, finish the shell with Ctrl-D or `exit`, then convert with `ttygif myrecording`. On macOS, the README documents an optional `-f` flag to bypass cropping for terminal apps that are not full screen.

The tool depends on terminal-window capture details: the README documents Terminal and iTerm support on macOS, `WINDOWID` handling on X11, and a `TTYGIF_DEBUG` environment variable for troubleshooting.

Why package nerds care

ttygif is the kind of package that survives because it composes with another tiny Unix tool. It does not replace ttyrec; it gives package maintainers and CLI authors a way to turn ttyrec artifacts into visual documentation.

Its packaging value is mostly archival and demonstrative: it preserves the ttyrec lineage while producing the GIF format that GitHub-era README culture made convenient.

Timeline

  • 2013: Official 1.0.8 tag in the ttygif repository.
  • 2016: 1.4.0 tag published after several 1.x releases.
  • 2022: 1.6.0 tag published.
  • Current README: documents ttyrec-to-GIF workflow, platform setup notes, and tty2gif credit.

Related projects

  • ttyrec is the input recording format and the first step in the documented workflow.
  • tty2gif is credited by the README as the inspiration for ttygif's idea and approach.

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 13 platform targets.
  • Installs with 2 runtime 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

CommandKindExposureNote
ttygifcliglobal 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.6.0
manager updated
local dataok
upstreamcurrent
latest detected1.6.0

https://github.com/icholy/ttygif

  • infoNo package-manager update timestamp was available.low confidence

install metadata

Package metadata

Package keybrew:ttygif
Version1.6.0
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/ttygif
Homepagehttps://github.com/icholy/ttygif
Repositoryhttps://github.com/icholy/ttygif
Upstream docshttps://github.com/icholy/ttygif#readme
LicenseMIT
Source archivehttps://github.com/icholy/ttygif/archive/refs/tags/1.6.0.tar.gz
Dependenciesimagemagick, ttyrec
Bottleavailable (on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namettygif
Version Scheme0
Revision0
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

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%

ttygif 1.5.0-1

generate gif animations from ttyrec terminal recordings

https://github.com/icholy/ttygif

sudo apt install ttygif
  • Section: utils
  • Architecture: amd64
  • 4 dependencies
  • normalized package name match
  • Matched by: Ttygif
Debian stable package indexes · deb.debian.org · Debian stable package indexes: ttygif from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

ttygif

nix profile install nixpkgs#ttygif
  • normalized package name match
  • Matched by: Ttygif
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/tt/ttygif/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

ttygif 1.5.0-1

generate gif animations from ttyrec terminal recordings

https://github.com/icholy/ttygif

sudo apt install ttygif
  • Section: universe/utils
  • Architecture: amd64
  • 4 dependencies
  • normalized package name match
  • Matched by: Ttygif
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: ttygif from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
MacPorts95%

ttygif

sudo port install ttygif
  • normalized package name match
  • Matched by: Ttygif
MacPorts ports tree · api.github.com · MacPorts ports tree: graphics/ttygif/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • imagemagickRuntime dependency declared by Homebrew.
  • ttyrecRuntime dependency declared by Homebrew.

Same workflow

  • catimgShares av.db curated category or tags: cli, image, media, terminal.
  • gifcapShares av.db curated category or tags: cli, gif, image, media, screen-capture.
  • aggShares av.db curated category or tags: cli, gif, media, terminal.
  • gif2pngShares av.db curated category or tags: cli, gif, image, media.
  • gifsicleShares av.db curated category or tags: cli, gif, image, media.
  • gifskiShares av.db curated category or tags: cli, gif, image, media.

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.

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