byzanz-record - record your desktop session to an animated GIF
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.
- -a, --audio
- Record audio from the default input device. This only works
if the output format supports it and will otherwise cause an error.
- -c, --cursor
- Record mouse cursor
- -d, --duration=SECS
- Duration of animation (default: 10 seconds)
- -e, --exec=COMMAND
- Instead of specifying the duration of the animation,
execute the given COMMAND and record until the command exits. This
is useful both for benchmarking and to use more complex ways to stop the
recording, like writing scripts that listen on dbus.
- Delay before start (default: 1 second)
- X display to use
- -h, --height=PIXEL
- Height of recording rectangle
- -v, --verbose
- be verbose
- -w, --width=PIXEL
- Width of recording rectangle
- -x, --x=PIXEL
- X coordinate of rectangle to record
- -y, --y=PIXEL
- Y coordinate of rectangle to record
- -?, --help
- Show help options
- Show all help options
- Show GTK+ Options
is finished, the recording is written to FILENAME.
The format is determined by the filename extension. The following formats are
- 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
- Record to a Flash Screen video. This recording method is
lossless. Use it if you want to postprocess the file in other
- 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
- Record to a WebM video. This format consists of VP8 video
and Vorbis audio streams. Use this if you want to record dynamic contents,
e.g. for a HTML5 video.
Byzanz was written by Benjamin Otte <email@example.com>.
This manual page was last updated for version 0.2.1.