GAVF-ENCODE(1)

💖 GAVF-ENCODE(1) 💖

okay so bestie, welcome to gavf-encode, straight outta the User Manuals section, section 1, the one and only. it's a Gavf stream encoder and it's literally here to serve. grab a snack, we're doing this 🍓

---

✨ NAME ✨

gavf-encode — the Gavf stream encoder, aka your new bestie for turning stuff into gavf streams 🦋

---

🎀 SYNOPSIS 🎀

gavf-encode [options]

---

🌸 DESCRIPTION 🌸

gavf encoder. that's it, that's the vibe. it encodes, it's gavf, it slays 💅

---

👑 OPTIONS 👑

• -i <input_file> — your input file or location. the source of the whole situation 🫶
• -iopt param1=val1[&param2=val2...] — input options, and there's a whole little family of them:
  • dh=[1|0] (default: 0) — dump gavf headers. use this for debugging 👀
  • dp=[1|0] (default: 0) — dump gavf packets. use this for debugging 👀
  • dm=[1|0] (default: 0) — dump inline metadata. use this for debugging 👀
  • to=<number> (500..100000, default: 5000) — timeout, in milliseconds ⏱️
  • nomsg=[1|0] (default: 0) — no messages. don't even try to make a back-channel for messages. forward messages might still be sent though, so, y'know, no cap.
• -as <stream_selector> — comma separated list of characters: d (decode), m (mute) or c (read compressed) 🎧
• -vs <stream_selector> — comma separated list of characters: d (decode), m (mute) or c (read compressed) 📹
• -ts <stream_selector> — comma separated list of characters: m (mute) or c (read) 💬
• -os <stream_selector> — comma separated list of characters: d (decode), m (mute) or c (read compressed) 🌈
• -enc param1=val1[&param2=val2...] — encoding options, and ooooh she's got layers:
  • ae=option[{suboptions}] — audio.
    • Supported options: $to_video
    • Default: (null)
  • te=option[{suboptions}] — text subtitles.
    • Supported options: $to_video
    • Default: (null)
  • oe=option[{suboptions}] — overlay subtitles.
    • Supported options: $to_video e_ovl2text
    • Default: e_ovl2text
  • Suboptions for oe=e_ovl2text:
    • background_color=<r>,<g>,<b> (default: 0.000,0.000,0.000) — background color. <r>, <g> and <b> are in the range 0.0..1.0. this is the background color to use, when converting formats with transparency to grayscale 🎨
    • tmpdir=<string> (Default: /tmp) — temporary directory. temporary directory for image files 📁
    • plugin=option[{suboptions}] — plugin. plugin for writing the text subtitles.
      • Supported options: (none listed)
      • Default: (null)
  • ve=option[{suboptions}] — video.
    • Supported options: (none listed)
    • Default: (null)
• -ac <options> — audio compression options 🎵
• -vc <options> — video compression options 🎬
• -tc <options> — text compression options 📝
• -oc <options> — overlay compression options 🖼️
• -o <output> — output file (without extension) or location. note the without extension part bestie, it's giving important ✨

---

💜 GENERIC OPTIONS 💜

these ones are the universal besties — available for all gmerlin applications, no matter which one you're running 💫

• -help — print this help message and exit
• -help-man — print this help message as a manual page and exit
• -help-texi — print this help message in texinfo format and exit
• -version — print version info and exit
• -v level — set verbosity level (0..4) 🔉
• -syslog name — log to syslog the specified name
• -stderr — always log to stderr

---

🧚 FILES 🧚

• ~/.gmerlin/plugins.xml — cache of the plugin registry (shared by all applications). it's communal, it's giving community chest 🫶
• ~/.gmerlin/generic/cfg.xml — default plugin parameters are read from there. use gmerlin_plugincfg to change them. yes, that tool, go use it 💅

---

and that's the whole page bestie, no notes, ate and left no crumbs 👑

Gmerlin · 2025-09-26 — that's the source, the version and the date, so like, this page is stamped and dated and fully iconic. mwah 💖🌸🦋