How to screen capture a region to GIF using Byzanz

Byzanz can be used to screen capture and save it to an animated GIF file. To capture a region of the display, you can pass it the XY coordinates of the top-left corner of the region and the width and height of the region. A more intuitive method would have been to draw a region on the display and have Byzanz capture that.

Thanks to Rob W, you can do that using his Bash script byzanz-record-region, which can be found here. Getting this to work takes a few steps:

  • Install Byzanz as described here.

  • We need a tool to mark a region of the display. xrectsel is one such tool and it available with FFcast2. Clone its repository and build the tool:

$ git clone
$ cd FFcast2
$ make

Move the xrectsel binary to location accessible from your PATH.

  • Create a Bash script file from the source code for byzanz-record-region available here.

  • That is it! To record or screen capture a region of the display for 10 seconds, just invoke the script without any parameters:

$ byzanz-record-region

Your mouse cursor turns into a cross-hair. Draw the region on the display. A countdown of 10 seconds is shown followed by a beep. Recording begins and ends after 10 seconds. You can find the resulting animated GIF file in /tmp/recorded.gif.

  • To provide a different duration of recording or filename, you need to provide both parameters (even if you only need to change one of them):
$ byzanz-record-region 30 foobar.gif

Tried with: Ubuntu 12.04

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.