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       -d, --duration=SECS
20              Duration of animation (default: 10 seconds)
21
22       --delay=SECS
23              Delay before start (default: 1 second)
24
25       -c, --cursor
26              Record mouse cursor
27
28       -a, --audio
29              Record audio from the default input device. This only  works  if
30              the output format supports it and will otherwise cause an error.
31
32       -x, --x=PIXEL
33              X coordinate of rectangle to record
34
35       -y, --y=PIXEL
36              Y coordinate of rectangle to record
37
38       -w, --width=PIXEL
39              Width of recording rectangle
40
41       -h, --height=PIXEL
42              Height of recording rectangle
43
44       -v, --verbose
45              Be verbose
46
47       --display=DISPLAY
48              X display to use
49
50   Help Options:
51       -?, --help
52              Show help options
53
54       --help-gtk
55              Show GTK+ Options
56
57       --help-all
58              Show all help 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       gif    Record  to an animated GIF image. Use this if you want to record
66              a mostly static screen with a limited amount of colors, such  as
67              using  a  file  manager  or  an office application.  This is the
68              default and will be used if an unrecognized extension is used.
69
70       ogg, ogv
71              Record to an Ogg Theora video. This format supports  audio.  Use
72              this if you want to record dynamic contents, such as video play‐
73              back.
74
75       flv    Record to a Flash Screen video. This recording method  is  loss‐
76              less. Use it if you want to postprocess the file in other appli‐
77              cations.
78
79       byzanz Record to Byzanz' internal debugging format. This is useful  for
80              benchmarking  Byzanz  or if you want to convert the recording to
81              multiple formats later.  You can use byzanz-playback(1) to  con‐
82              vert the file.
83

SEE ALSO

85       byzanz-playback(1)
86

AUTHOR

88       Byzanz was written by Benjamin Otte <otte@gnome.org>.
89
90       This manual page was last updated for version 0.2.1.
91
92
93
94                                                              BYZANZ-RECORD(1)