kortatu / ttygif

Convert terminal recordings to animated gifs

TTYGIF

ttygif converts a ttyrec file into gif files. It's a stripped down version of ttyplay that captures every frame.

Setup

Debian/Ubuntu

$ sudo apt-get install imagemagick ttyrec gcc
$ git clone https://github.com/icholy/ttygif.git
$ cd ttygif
$ make
$ sudo make install

Fedora/Redhat

$ sudo yum install ImageMagick gcc
$ # install ttyrec from source ~> https://github.com/mjording/ttyrec
$ git clone https://github.com/icholy/ttygif.git
$ cd ttygif
$ make
$ sudo make install

OSX

$ brew install imagemagick ttyrec
$ brew install https://raw.githubusercontent.com/icholy/ttygif/master/ttygif.rb

Usage:

1. Create ttyrec recording

$ ttyrec myrecording

• Hit CTRL-D or type exit when done recording.

2. Convert to gif

$ ttygif myrecording

On OSX optionally you can set a -f flag which will bypass cropping which is needed for terminal apps which aren't full screen. Both standard Terminal and iTerm apps are supported.

$ ttygif myrecording -f

Demo:

Credits

The idea and approach was adapted from tty2gif