KATEENC(1)

📦
version 0.4.3 · 2 versions
, in arch rolling, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu stonking

💖 KATEENC(1) 💖

okay bestie, welcome to the kateenc page, straight outta libkate — yes that's the manual name, we're keeping it, it's iconic 💅

✨ NAME ✨

kateenc — create Kate streams from text input 🎀

🌸 SYNOPSIS 🌸

kateenc [-hVM] [-o outfile] [-l language] [-c category] [-s serial] [-C
tag=value] [-R threshold] [-K threshold] -t filetype [ infile ]

🦋 DESCRIPTION 🦋

so basically, kateenc makes Kate streams out of input files — we're talking SubRip SRT subtitles, LRC lyrics, and libkate's own custom description language. it's giving multilingual text-to-stream pipeline ✨

and when you save it to an Ogg stream (which is the default behavior, no cap), your Kate stream can then be merged with other Ogg streams (like, say, a Theora video, bestie) using the oggz tools. periodt 💖

👑 OPTIONS 👑

  • -h — shows the command line help. you know, for when you're lost. 🫶
  • -V — shows version information. slay, know thyself. ⭐
  • -M — allows simple HTML-like markup in SRT files. if you use this, strings like "<i>" get interpreted as italics instead of just… appearing as the literal text <i>. lowkey important caveat though: various players interpret a slightly different set of HTML tags, and some don't interpret them at all. so vibe check your player first 😭
  • -o outfile — writes the output Kate stream to the given file name. if you don't specify it, it writes to stdout. classic. 🌈
  • -l language — sets the language for the stream. the default is whatever language was specified in the input, or none. ✨
  • -c category — sets the category for the stream. default is the category specified in the input, or none. 🎀
  • -s serial — sets the serial number for the output Kate stream. note: this does not apply to raw streams, bestie 💀
  • -C tag=value — adds a comment to encode into the output Kate stream. it has to be of the form tag=value and comply with the Vorbis comment rules (like, tag is composed of a particular subset of ASCII characters, and value is valid UTF-8). heads up: you might have to escape or quote the comment so it's seen as a single command line parameter 🙈
  • -t filetype — specifies the type of the input (srt, lrc, kate) 👑
  • -R threshold — use repeat packets, with the given threshold (in seconds). data packets get repeated at intervals of roughly threshold seconds, while active. 🔥
  • -K threshold — use keepalive packets, with the given threshold (in seconds). keepalive packets get emitted when no other packet has been emitted for roughly threshold seconds. 🧚

🍓 EXAMPLES 🍓

create a Kate stream for Welsh subtitles from a SubRip file:

kateenc -t srt -l cy -c SUB -o output.ogg input.srt

that's it. that's the whole vibe. ate 💅

💜 SEE ALSO 💜

katedec(1), katalyzer(1)

okay that's the whole page bestie, mwah 🫶 this was libkate 0.4.3, dated 13 october 2010 — iconic era, no notes 💖✨🎀

📦 where this page comes from