ttygif converts a ttyrec file into gif files. It's a stripped down version of ttyplay that captures every frame.
Demo
Setup
Debian/Ubuntu
$ sudo apt-get install imagemagick ttyrec gcc x11-apps
$ 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 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
Additional Notes
If you're getting Error: WINDOWID environment variable was empty.
, then you need to manually set WINDOWID
.
export WINDOWID=23068679
If you're on Ubuntu, you can use xdotool
to find the WINDOWID
$ sudo apt-get install xdotool
$ export WINDOWID=$(xdotool getwindowfocus)
Debugging
If you're having issues, then export the TTYGIF_DEBUG
env variable.
export TTYGIF_DEBUG=1
This will print out all the commands it's trying to run.
Credits
The idea and approach was adapted from tty2gif