Man Linux: Main Page and Category List


       byzanz-record - record your desktop session to an animated GIF


       byzanz-record [options] FILENAME


       Byzanz records your desktop session to an animated GIF.  You can record
       your entire screen, a single window, or an arbitrary  region.   byzanz-
       record  allows you to make recordings from the command line.  Graphical
       users may want to use the panel applet instead.


   Application Options:
       -d, --duration=SECS
              Duration of animation (default: 10 seconds)

              Delay before start (default: 1 second)

       -c, --cursor
              Record mouse cursor

       -a, --audio
              Record audio from the default input device. This only  works  if
              the output format supports it and will otherwise cause an error.

       -x, --x=PIXEL
              X coordinate of rectangle to record

       -y, --y=PIXEL
              Y coordinate of rectangle to record

       -w, --width=PIXEL
              Width of recording rectangle

       -h, --height=PIXEL
              Height of recording rectangle

       -v, --verbose
              Be verbose

              X display to use

   Help Options:
       -?, --help
              Show help options

              Show GTK+ Options

              Show all help options


       After byzanz-record is finished, the recording is written to  FILENAME.
       The  format  is  determined  by  the  filename extension. The following
       formats are supported:

       gif    Record to an animated GIF image. Use this if you want to  record
              a  mostly static screen with a limited amount of colors, such as
              using a file manager or an  office  application.   This  is  the
              default and will be used if an unrecognized extension is used.

       ogg, ogv
              Record  to  an Ogg Theora video. This format supports audio. Use
              this if you want to  record  dynamic  contents,  such  as  video

       flv    Record  to  a  Flash  Screen  video.  This  recording  method is
              lossless. Use it if you want to postprocess the  file  in  other

       byzanz Record  to Byzanz’ internal debugging format. This is useful for
              benchmarking Byzanz or if you want to convert the  recording  to
              multiple  formats  later.   You  can  use  byzanz-playback(1) to
              convert the file.




       Byzanz was written by Benjamin Otte <>.

       This manual page was last updated for version 0.2.1.