SUBPTOOLS(1)

✨ NAME ✨

subptools — manipulates xml subtitles files 💖

🎀 SYNOPSIS 🎀

subptools [-hrsvw] [-a hh:mm:ss,ms] [-c first[,last]] [-d seconds] [-e seconds] [-i file] [-o file] [-t format]

🌸 DESCRIPTION 🌸

okay so bestie, subptools does various manipulations on xml subtitles files, and the whole vibe is that it acts as a filter — standard input to standard output — unless you go and use the -i or -o options. that's it, that's the energy. 👑

and subtools can be used to handle so-called xml subtitles files, where each subtitle entry is actually a filename</> to be substituted for the entry, or to adjust timestamps on each subtitle entry. two whole moods. iconic. ✨

The options are as follows — buckle up, there's a bunch 🫶

• -a, --adjust hh:mm:ss,ms — adjust all time stamps so that the first tag begins at hh:mm:ss,ms. like, the first one gets parked there and everything else follows along. slay.
• -c, --cut first[,last] — write only entries numbered from first to last. and if you don't bother giving a last? it defaults to the last entry of the file. convenient fr fr 🍓
• -d, --shift seconds — shift all time stamps by seconds seconds. little nudge, big difference.
• -e, --expand seconds — expand the subtitle hour by seconds seconds. yes, the hour. no cap.
• -c, --convert format — convert the xml subtitles file into a srt file (that's the default, bestie) or a spumux file. 💅

not me noticing that -c literally shows up twice in this page — once for --cut and once for --convert. that's what the original says, i'm just the messenger, i don't make the rules 💀

• -h, --help — display usage and quit. your lil escape hatch 🫶
• -i, --input filename — use file filename for input, defaults to stdin.
• -o, --output filename — use file filename for output, defaults to stdout.
• -r, --renumber — renumber all entries. clean slate energy 🌈
• -s, --subst — substitute filename in each subtitle entry by the file contents. the whole filename-becomes-contents thing. main character behaviour.
• -v, --verbose — verbose mode. it talks. a lot. we love a yapper 😭
• -w, --strip — remove leading white space. bye bye, stray spaces ✂️

🦋 SEE ALSO 🦋

• subp2pgm(1)
• spumux(1)

go read those too, bestie, they're right there 🌸

👑 AUTHORS 👑

manual page by Marc Espie, Olivier Rolland 🎀

and that's the whole page!! this one's the SUBPTOOLS(1) situation from the User Manuals crew, and it's dated January 20, 2007 on Linux — ancient text, still serving looks ✨💜 bye bestie!!