# 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 ```sh sudo av install brew:ttygif ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install ttygif ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install ttygif ``` Evidence: MacPorts ports tree: graphics/ttygif/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Debian apt (92%): ```sh sudo apt install ttygif ``` Evidence: Debian stable package indexes: ttygif from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#ttygif ``` Evidence: nixpkgs package indexes: pkgs/by-name/tt/ttygif/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:ttygif - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.6.0 - **Source summary:** Converts a ttyrec file into gif files - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - ttygif (cli) - ttygif (alias) ## Dependencies - imagemagick - ttyrec ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.6.0 - Local data: ok - Upstream repository: https://github.com/icholy/ttygif - Upstream latest detected: 1.6.0 (current) - info: No package-manager update timestamp was available. ## 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. ### Sources - - official git tags from https://github.com/icholy/ttygif - source_facts.package-manager ## 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:** ttygif - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Debian apt - ttygif - 1.5.0-1: normalized package name match | Debian stable package indexes: ttygif from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | generate gif animations from ttyrec terminal recordings | https://github.com/icholy/ttygif - Nix - ttygif: normalized package name match | nixpkgs package indexes: pkgs/by-name/tt/ttygif/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - ttygif - 1.5.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: ttygif from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | generate gif animations from ttyrec terminal recordings | https://github.com/icholy/ttygif - MacPorts - ttygif: normalized package name match | MacPorts ports tree: graphics/ttygif/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [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. - [imagemagick](https://www.automicvault.com/pkg/brew/imagemagick/) - Runtime dependency declared by Homebrew. - [ttyrec](https://www.automicvault.com/pkg/brew/ttyrec/) - Runtime dependency declared by Homebrew. - [catimg](https://www.automicvault.com/pkg/brew/catimg/) - Shares av.db curated category or tags: cli, image, media, terminal. - [gifcap](https://www.automicvault.com/pkg/brew/gifcap/) - Shares av.db curated category or tags: cli, gif, image, media, screen-capture. - [agg](https://www.automicvault.com/pkg/brew/agg/) - Shares av.db curated category or tags: cli, gif, media, terminal. - [gif2png](https://www.automicvault.com/pkg/brew/gif2png/) - Shares av.db curated category or tags: cli, gif, image, media. - [gifsicle](https://www.automicvault.com/pkg/brew/gifsicle/) - Shares av.db curated category or tags: cli, gif, image, media. - [gifski](https://www.automicvault.com/pkg/brew/gifski/) - Shares av.db curated category or tags: cli, gif, image, media. - [gimme-aws-creds](https://www.automicvault.com/pkg/brew/gimme-aws-creds/) - Shares av.db curated category or tags: cli, gif, image, media. - [aview](https://www.automicvault.com/pkg/brew/aview/) - Shares av.db curated category or tags: cli, media, terminal. - [t-rec](https://www.automicvault.com/pkg/brew/t-rec/) - Local package facts share a topical domain. Shared terms: cli, gif, imagemagick, media, recording. - [lsix](https://www.automicvault.com/pkg/brew/lsix/) - Both packages work with overlapping file formats or content types. Shared terms: cli, image, imagemagick, media, terminal. ## Combined YAML source View the package source record on GitHub. [combined/ttygif.yml](https://github.com/automic-vault/db/blob/main/combined/ttygif.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