po2sub(1)

✨ po2sub(1) — the girlies' guide to converting PO files into subtitles ✨

okay so bestie, welcome to po2sub 💅 this is the po2sub(1) manual page, part of Translate Toolkit 3.12.1, and it's literally the tool that takes your Gettext PO localization files and turns them into subtitle files. yes. subtitles. for film and tv. we love a crossover episode 🎬✨

---

🌸 NAME 🌸

po2sub — convert Gettext PO localization files to subtitle files 🫶

Like, that's the whole vibe. PO in, subs out. no cap.

---

🦋 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]

copy that exactly, okay? character for character. the terminal is not a vibe-check-optional zone 😭

---

🎀 DESCRIPTION 🎀

So the manpage itself lowkey just points you elsewhere — and honestly, that's main character energy. It says:

See: http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/sub2po.html for examples and usage instructions.

yep, that's the sub2po page, not po2sub — that's what the original says, and I'm not about to gaslight you and pretend otherwise 🙈 go read it, the examples are iconic. ⭐

---

💖 OPTIONS 💖

okay this is the part you actually came for. every single flag, no skips, no "you'll figure it out" energy. let's go 🔥

• --version — show program's version number and exit. one line, in and out, like a queen 👑
• -h/--help — show this help message and exit. the classic. the icon. always there for you 🫶
• --manpage — output a manpage based on the help. yes it prints a manpage. meta? maybe. slay? absolutely 💅
• --progress — show progress as: dots, none, bar, names, verbose. pick your aesthetic, bestie ✨
• --errorlevel — show errorlevel as: none, message, exception, traceback. how much do you want to know when things go sideways? your call 😭
• -i/--input — read from INPUT in po, pot formats. this is the source material, the origin story 🌱
• -x/--exclude — exclude names matching EXCLUDE from input paths. not me filtering out the files I don't want 🙈
• -o/--output — write to OUTPUT in ass, srt, ssa, sub formats. four formats, one legend 🎀
• -t/--template — read from TEMPLATE in ass, srt, ssa, sub formats. same four formats, now on the read side 🦋
• -S/--timestamp — skip conversion if the output file has newer timestamp. it checks the vibes (and the mtime) before doing work 💀 efficient queen behavior
• --threshold — only convert files where the translation completion is above PERCENT. like a bouncer at the club, but for half-finished translations 🚪✨
• --fuzzy — use translations marked fuzzy. yes, the fuzzy ones. bring them in, they're trying their best 🥺
• --nofuzzy — don't use translations marked fuzzy (default). this is the default, so if you don't say anything, fuzzy gets left outside. sorry bestie 💔

---

quick vibe check: --fuzzy and --nofuzzy are opposites, and --nofuzzy is the one that's on unless you say otherwise. don't let anyone tell you different 💅

---

🌈 that's the whole page, bestie 🌈

every option, every format (po, pot on the way in — ass, srt, ssa, sub on the way out), every default, every word. no details were harmed in the making of this rewrite 💖

this has been po2sub(1) from Translate Toolkit 3.12.1 — mwah, go convert some subtitles, you're gonna eat 🍓👑