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. byzanzrecord 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 loss
- less. 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 multiple formats later. You can use byzanz-playback(1) to convert the file.
SEE ALSO
AUTHOR
Byzanz was written by Benjamin Otte <otte@gnome.org>.
- This manual page was last updated for version 0.2.1.