1guacenc(1)                     Apache Guacamole                     guacenc(1)
2
3
4

NAME

6       guacenc - Guacamole video encoder
7

SYNOPSIS

9       guacenc [-s WIDTHxHEIGHT] [-r BITRATE] [-f] [FILE]...
10

DESCRIPTION

12       guacenc is a video encoder which accepts Guacamole protocol dumps, such
13       as those saved when screen recording is enabled on a Guacamole  connec‐
14       tion,  writing  standard video files as output.  guacenc is essentially
15       an implementation of a Guacamole client which accepts  its  input  from
16       files  instead  of  a network connection, and renders directly to video
17       instead of to the user's screen.
18
19       Each FILE specified will be encoded as MPEG-4 video to a new file named
20       FILE.m4v, encoded according to the other options specified. By default,
21       the output video will be 640x480 pixels, and will be saved with  a  bi‐
22       trate  of 2000000 bits per second (2 Mbps). These defaults can be over‐
23       ridden with the -s and -r options respectively. Existing files will not
24       be overwritten; the encoding process for any input file will be aborted
25       if it would result in overwriting an existing file.
26
27       Guacamole acquires a write lock on recordings as they are  being  writ‐
28       ten.  By  default,  guacenc  will  check whether the each input file is
29       locked and will refuse to read and encode an input file if  it  appears
30       to  be  an  in-progress  recording.  This behavior can be overridden by
31       specifying the -f option. Encoding an in-progress recording will  still
32       result in a valid video; the video will simply cover the user's session
33       only up to the current point in time.
34

OPTIONS

36       -s WIDTHxHEIGHT
37              Changes the resolution of the video that guacenc renders. By de‐
38              fault, this will be 640x480.
39
40       -r BITRATE
41              Changes  the  bitrate that guacenc will use for the saved video.
42              This is specified in bits per second. By default, this  will  be
43              2000000  (2  Mbps).  Higher  values  will  result  in larger but
44              higher-quality video files. Lower values will result in  smaller
45              but lower-quality video files.
46
47       -f     Overrides  the default behavior of guacenc such that input files
48              will be encoded even if they appear  to  be  recordings  of  in-
49              progress Guacamole sessions.
50

SEE ALSO

52       guaclog(1)
53
54
55
56version 1.5.4                     26 Jan 2018                       guacenc(1)
Impressum