ttygif

The tool reads a ttyrec file—a recording of a terminal session—and produces an animated GIF by capturing each frame of the playback. It operates as a command‑line utility, invoking the ttyrec playback internally and using ImageMagick to assemble the screenshots into a GIF file. Users can run the conversion with a simple command, optionally disabling automatic cropping for non‑full‑screen terminals.

It is intended for developers or anyone who wants to share terminal demos, tutorials, or troubleshooting sessions in a lightweight, viewable format. The program works on Linux distributions such as Debian, Ubuntu, Fedora, CentOS, OpenSUSE, Arch Linux, and is available on macOS via Homebrew. Installation requires standard development tools and the ttyrec recorder, which can be built from source or installed through package managers.

The implementation is a minimal adaptation of the earlier tty2gif project, handling environment variables like WINDOWID and providing a debug mode through TTYGIF_DEBUG. It supports both the default Terminal and iTerm applications on macOS, and can be customized with a flag to skip cropping when needed.