1BYZANZ-RECORD(1) General Commands Manual BYZANZ-RECORD(1)
2
3
4
6 byzanz-record - record your desktop session to an animated GIF
7
9 byzanz-record [options] FILENAME
10
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
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
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
85 byzanz-playback(1)
86
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)