BYZANZ-RECORD(1)					      General Commands Manual						  BYZANZ-RECORD(1)

NAME

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

SYNOPSIS

       byzanz-record [options] FILENAME

DESCRIPTION

       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.

OPTIONS

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

       --delay=SECS
	      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

       --display=DISPLAY
	      X display to use

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

       --help-gtk
	      Show GTK+ Options

       --help-all
	      Show all help options

OUTPUT FILE

       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 playback.

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

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

SEE ALSO

       byzanz-playback(1)

AUTHOR

       Byzanz was written by Benjamin Otte <otte@gnome.org>.

       This manual page was last updated for version 0.2.1.

																  BYZANZ-RECORD(1)