sub2po(1)

🌸 sub2po(1) — the translate-toolkit glow-up for your subtitles

okay bestie, gather round 💖 this is sub2po, part of the Translate Toolkit (we're on version 3.19.5, if you were wondering, and you were).

✨ NAME ✨

sub2po — the way you turn subtitle files into Gettext PO localization files. literally that's the whole job and she does it flawlessly 💅

---

🌈 SYNOPSIS 🌈

mkay here's the shape of the whole thing, copied exactly so you can't mess it up:

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]

🦋 DESCRIPTION 🦋

so basically, like, there's a whole page of examples and usage instructions waiting for you over here:

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

go look, fr fr, it's giving documentation 🎀

👑 OPTIONS 👑

here's every single one, no gatekeeping, periodt:

• --version — shows you the program's version number and then dips out. bye! 👋
• -h, --help — prints this help message and exits. the classic "hello, what is this" move 🙈
• --manpage — spits out a manpage based on the help. meta, iconic, we love her ⭐
• --progress — shows progress as one of: dots, none, bar, names, verbose. pick your vibe 🔥
• --errorlevel — shows errorlevel as one of: none, message, exception, traceback. how loud do you want the drama, bestie 😭
• -i, --input — reads from INPUT, and INPUT can be in ass, srt, ssa, sub formats 💖
• -x, --exclude — excludes names matching EXCLUDE from the input paths. not today, thank you 💅
• -o, --output — writes to OUTPUT in po, pot formats ✨
• -t, --template — reads from TEMPLATE in ass, srt, ssa, sub formats. yes same formats, she's consistent 🌸
• -S, --timestamp — skips the conversion if the output file already has a newer timestamp. she knows when to mind her business 🫶
• -P, --pot — outputs PO Templates (.pot) rather than PO files (.po). template girlies rise 🎀
• --duplicates — what to do with duplicate strings (identical source text): merge, msgctxt (default: 'msgctxt') 🧚

lowkey important: that --duplicates default is 'msgctxt', so if you don't say anything she's already picked for you 💜

---

okay that's the whole page, you're so welcome 💖 this was sub2po from Translate Toolkit 3.19.5 — go convert something and slay ✨👑