Skip to content

Latest commit

 

History

History
80 lines (55 loc) · 1.62 KB

README.md

File metadata and controls

80 lines (55 loc) · 1.62 KB
Raw

TTYGIF

ttygif converts a ttyrec file into gif files. It's a stripped down version of ttyplay which calls xwd on every frame.

Setup

Debian/Ubuntu

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

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

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. Create gif frames

$ ./ttygif myrecording
  • Dumps a bunch of gif images into the current directory.
  • File names have this pattern: <zero_padded_index>_<delay_in_milliseconds>.gif

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

3. Create animated gif

$ ./concat.sh terminal.gif
  • Concatenates all the images in the current directory

On OSX use concat_osx.sh since in OSX version bunch of PNGs are dumped into a folder and used as source (for better image quality).

$ ./concat_osx.sh terminal.gif

Demo:

gif

Credits

The idea and approach was adapted from tty2gif