guacenc(1)

📦
version 1.6.0 · 2 versions
, in alpine 3.24, epel 10, epel 9, fedora 43, fedora 44, nixos 26.05

💖 NAME 💖

guacenc — the Guacamole video encoder, bestie. that's it, that's the name.

✨ SYNOPSIS ✨

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

like, short and sweet but also she's got range 💅

🦋 DESCRIPTION 🦋

okay so listen. guacenc is a video encoder and she eats. she takes Guacamole protocol dumps — you know, the ones you get when screen recording is turned on for a Guacamole connection — and she turns them into actual standard video files as output. no cap.

think of guacenc as, like, basically an implementation of a Guacamole client? except instead of reading her input from a network connection she reads it from files, and instead of rendering to your screen she renders straight to video. main character energy honestly 🌈

Every FILE you give her gets encoded as MPEG-4 video into a brand new file named FILE.m4v, encoded according to whatever other options you passed. by default the output video is 640x480 pixels and gets saved with a bitrate of 2000000 bits per second (that's 2 Mbps for the girlies keeping score). you can override these defaults with the -s and -r options respectively, obviously 💅

⚠️ real talk: existing files will NOT be overwritten. the encoding process for any input file gets aborted if it would result in overwriting an existing file. she is polite, she is not going to bulldoze your stuff.

also — Guacamole acquires a write lock on recordings while they're actively being written. by default guacenc checks whether each input file is locked and will refuse to read and encode an input file if it looks like an in-progress recording. you can override this by specifying the -f option. and ngl, encoding an in-progress recording will still give you a valid video — the video just only covers the user's session up to the current point in time. so it's fine, it's just ✨ truncated vibes ✨

🎀 OPTIONS 🎀

  • -s WIDTHxHEIGHT — changes the resolution of the video that guacenc renders. by default this will be 640x480. go off, pick your dimensions 🫶
  • -r BITRATE — changes the bitrate that guacenc will use for the saved video. it's specified in bits per second. by default this will be 2000000 (2 Mbps). higher values = larger but higher-quality video files. lower values = smaller but lower-quality video files. it's giving tradeoff, it's giving balance 😭
  • -f — overrides the default behavior of guacenc such that input files will be encoded even if they appear to be recordings of in-progress Guacamole sessions. use her wisely bestie 👑

🌸 SEE ALSO 🌸

okay that's the whole page, love u, go encode something gorgeous 💜 this was version 1.6.0, dated 26 Jan 2018, and yeah it's giving vintage but she still slays. bye bestie!! 💖✨🎀🦋

📦 where this page comes from