sub2po(1)

💅 sub2po(1) — the girlies' guide to turning subtitles into PO files 🎀

okay so bestie, welcome to sub2po from the Translate Toolkit (vibes: 3.12.1 ✨), a li'l command that literally takes your subtitle files and turns them into Gettext PO localization files. it's giving pipeline, it's giving localization era, iykyk 🦋

---

✨ NAME ✨

sub2po — convert subtitle files into Gettext PO localization files. that's the whole job. she's focused, she's iconic, she does one thing and she ate 💅

---

🌸 SYNOPSIS 🌸

sub2po [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-t|--template TEMPLATE] [-S|--timestamp]
[-P|--pot] [--duplicates DUPLICATESTYLE]

like, look at her go. so many little flags, all of them important, no cap 🔥

---

🦋 DESCRIPTION 🦋

for examples and usage instructions, go peek at:

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

real talk: that link is the original's own pointer — it's where the examples live, so don't come for me if you want more deets, the manpage said see the docs and I'm just relaying the message 🫶

---

🎀 OPTIONS 🎀

• --version — shows the program's version number and dips. cute, quick, to the point ✨
• -h/--help — shows this help message and exits. your girl is here to help 💖
• --manpage — outputs a manpage based on the help. meta? very. iconic? also very 👑
• --progress — show progress as: dots, none, bar, names, verbose. pick your vibe, bestie 🌈
• --errorlevel — show errorlevel as: none, message, exception, traceback. how much drama do you want when things go sideways 💀
• -i/--input — read from INPUT in ass, srt, ssa, sub formats. all the subtitle girls are welcome here 🍓
• -x/--exclude — exclude names matching EXCLUDE from input paths. boundaries, we love to see them 🙈
• -o/--output — write to OUTPUT in po, pot formats. this is where the magic lands ✨
• -t/--template — read from TEMPLATE in ass, srt, ssa, sub formats. a blueprint, a vision board, a slay 🎀
• -S/--timestamp — skip conversion if the output file has a newer timestamp. if she's already fresher than the source, we simply don't touch her 💅
• -P/--pot — output PO Templates (.pot) rather than PO files (.po). template era 🌸
• --duplicates — what to do with duplicate strings (identical source text): merge, msgctxt (default: 'msgctxt'). twins? we handle them 💜

---

⚠️ heads up bestie: --duplicates defaults to 'msgctxt', so if you don't say anything, that's what you're getting. no surprises, no cap.

---

💖 sign-off 💖

that's the page!! go localize those subtitles, main character 💫 this whole thing is brought to you by Translate Toolkit 3.12.1, dated right there in the sub2po(1) header and footer of the original — mwah, periodt 🫶🎀