1BYZANZ-RECORD(1)            General Commands Manual           BYZANZ-RECORD(1)
2
3
4

NAME

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

SYNOPSIS

9       byzanz-record [options] FILENAME
10

DESCRIPTION

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

OPTIONS

18   Application Options:
19       -a, --audio
20              Record audio from the default input device. This only  works  if
21              the output format supports it and will otherwise cause an error.
22
23       -c, --cursor
24              Record mouse cursor
25
26       -d, --duration=SECS
27              Duration of animation (default: 10 seconds)
28
29       --delay=SECS
30              Delay before start (default: 1 second)
31
32       --display=DISPLAY
33              X display to use
34
35       -h, --height=PIXEL
36              Height of recording rectangle
37
38       -v, --verbose
39              be verbose
40
41       -w, --width=PIXEL
42              Width of recording rectangle
43
44       -x, --x=PIXEL
45              X coordinate of rectangle to record
46
47       -y, --y=PIXEL
48              Y coordinate of rectangle to record
49
50   Help Options:
51       -?, --help
52              Show help options
53
54       --help-all
55              Show all help options
56
57       --help-gtk
58              Show GTK+ Options
59

OUTPUT FILE

61       After  byzanz-record is finished, the recording is written to FILENAME.
62       The format is determined by the filename extension. The following  for‐
63       mats are supported:
64
65       byzanz Record  to Byzanz' internal debugging format. This is useful for
66              benchmarking Byzanz or if you want to convert the  recording  to
67              multiple  formats later.  You can use byzanz-playback(1) to con‐
68              vert the file.
69
70       flv    Record to a Flash Screen video. This recording method  is  loss‐
71              less. Use it if you want to postprocess the file in other appli‐
72              cations.
73
74       gif    Record to an animated GIF image. Use this if you want to  record
75              a  mostly static screen with a limited amount of colors, such as
76              using a file manager or an  office  application.   This  is  the
77              default and will be used if an unrecognized extension is used.
78
79       ogg, ogv
80              Record  to  an Ogg Theora video. This format supports audio. Use
81              this if you want to record dynamic contents, such as video play‐
82              back.
83
84       webm   Record  to  a  WebM video. This format consists of VP8 video and
85              Vorbis audio streams. Use this if you  want  to  record  dynamic
86              contents, e.g. for a HTML5 video.
87

SEE ALSO

89       byzanz-playback(1)
90

AUTHOR

92       Byzanz was written by Benjamin Otte <otte@gnome.org>.
93
94       This manual page was last updated for version 0.2.1.
95
96
97
98                                                              BYZANZ-RECORD(1)