SUBP2PGM(1)

📦 version 1.0.1, in debian trixie, ubuntu jammy, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ SUBP2PGM(1) ✨

okay bestie, welcome to the subp2pgm page from the User Manuals section 💖 this is the one that turns your DVD subtitles into something an OCR can actually chew on. sit down, grab a boba, let's go 🧋

🌸 NAME 🌸

subp2pgm — convert VobSub DVD subtitles into pgm files and xml description, no cap 💅

🎀 SYNOPSIS 🎀

subp2pgm [-hvf] [-o output] [-s sid] vobsub

🦋 DESCRIPTION 🦋

so like. subp2pgm converts DVD subtitles from the VobSub format into an intermediate form suitable for OCR extraction. it's giving ✨middle manager✨ of subtitle formats — not the final boss, but the one who makes the handoff happen 🫶

subp2pgm takes two files as input, and they should be named <vobsub>.idx and <vobsub>.sub, where vobsub is the basename of the files. yes, the basename. like the shared part. iykyk 😌

subp2pgm outputs one .pgm graphics file for each subtitle image, plus a .xml description file with correct timing annotation, where each subtitle entry is replaced by the corresponding graphics file. literally one pic per line of dialogue, iconic 💖

after OCR conversion, such a file can be transformed into a proper srt file by subptools(1). so it's a whole pipeline moment, we're just the first step bestie 🌈

the options are as follows:

💅 OPTIONS 💅

  • -h, --help — display usage and quit. the classic "what does anything do" button 🙈
  • -v, --verbose — increase verbosity level. more yapping, more info 📢
  • -f, --forced — extract forced subtitles only. just the mandatory ones, the ones that were always gonna show up 💀
  • -n, --normalize — normalize the palette. color correction era 🎨
  • -o, --output output — basename for all pgm output files and the xml description. you pick the name, she does the rest 👑
  • -s, --sid sid — selects subtitle id from a vobsub file with several subtitle streams. defaults to 0. so if your file is a whole friend group of subtitle streams, this is how you point at the right one 🫶

⭐ SEE ALSO ⭐

subptools(1) — go look at her next, she finishes the job 💜

🌈 AUTHORS 🌈

manual page by Marc Espie, Olivier Rolland 🎀

ok that's the whole page, you ate it, periodt 💅✨

this was brought to you by the Linux release, dated January 20, 2007 — yes she's an elder but she's still slaying 🦋💖

📦 where this page comes from