po2sub(1)

📦
version 3.19.5 · 9 versions
, in ubuntu stonking

💅 po2sub — the manual, but make it make sense

okay bestie, so po2sub is a Translate Toolkit era classic — it's the little command that takes your Gettext PO localization files and turns them into subtitle files. yes. subtitles. the glow-up from translation strings to on-screen dialogue. iconic behavior honestly. 💖

✨ NAME ✨

po2sub — Convert Gettext PO localization files to subtitle files.

like. that's it. that's the whole job description and she does it flawlessly. 👑

🦋 SYNOPSIS 🦋

po2sub [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-t|--template TEMPLATE] [-S|--timestamp]
[--threshold PERCENT] [--fuzzy] [--nofuzzy]

look at her. a whole bouquet of flags. we're gonna go through every single one, no skipping, no skimming. periodt. 🌸

🌈 DESCRIPTION 🌈

So here's the tea, and I mean this literally: the actual examples and usage instructions live over at:

http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/sub2po.html

that's the place. go read it. it's giving "the real manual is elsewhere" but we still gotta do our due diligence here, so. 💁

👑 OPTIONS 👑

every flag, every single one, accounted for. no option left behind. 🫶

  • --version — show the program's version number and then dip. exit stage left. byee.
  • -h/--help — show this help message and exit. your classic "help me pls" button.
  • --manpage — output a manpage based on the help. meta. recursive. we love a self-aware queen. 🎀
  • --progress — show progress as: dots, none, bar, names, verbose. pick your vibe — little dots, absolutely nothing, a whole bar, the names of stuff, or the full verbose yap session. 💀
  • --errorlevel — show errorlevel as: none, message, exception, traceback. how dramatic do you want your errors to be? from "pretend nothing happened" to "full traceback theatre."
  • -i/--input — read from INPUT in po, pot formats. this is your source material, bestie.
  • -x/--exclude — exclude names matching EXCLUDE from input paths. we're gatekeeping certain files, respectfully. 🚫
  • -o/--output — write to OUTPUT in ass, srt, ssa, sub formats. four subtitle formats, one slay. 💅
  • -t/--template — read from TEMPLATE in ass, srt, ssa, sub formats. same four formats, but she's the blueprint, not the destination.
  • -S/--timestamp — skip conversion if the output file has newer timestamp. she checks the receipts before doing any work. efficient. 💅
  • --threshold — only convert files where the translation completion is above PERCENT. queen sets a bar and refuses to go below it. 📈
  • --fuzzy — use translations marked fuzzy. yes bestie, the wobbly ones, bring 'em in. 🫧
  • --nofuzzy — don't use translations marked fuzzy (default). and this is the default, so if you didn't say anything, this is what you got. no cap.
lowkey important reminder: --fuzzy and --nofuzzy are two sides of the same coin, and if you pick neither, you're getting --nofuzzy. that's the factory setting. 🌸

💜 SEE ALSO 💜

nope, there isn't one in this one, bestie — this page keeps it minimal. the DESCRIPTION link above is your bestie-in-arms for further reading. 🦋

and that's the whole page!! every flag, every format, every default, all copied over exactly as she came — nothing dropped, nothing invented, nothing "cleaned up." 🔥

this little love letter came to you from Translate Toolkit 3.19.5, so if you're citing her, cite her right. 🎀✨

bye bestie, go subtitle something pretty 💖🌷🦋

📦 where this page comes from