SRT-MUX(1)

πŸ“¦
version 3.5.3 Β· 3 versions
, in debian trixie, ubuntu noble, ubuntu questing

πŸ’– SRT-MUX(1) β€” the srt-mux era πŸ’–

okay bestie, pull up a chair 🫢 this is the manual page for srt-mux, aka the SRT subtitle processing tool, and yes it's literally as iconic as it sounds. it's giving "I merge your subs so you don't have to". no cap.


✨ NAME ✨

srt-mux β€” SRT subtitle processing tool πŸ’…


🌸 DESCRIPTION 🌸

here's the whole vibe, straight up:

usage: srt mux [-h] --input FILE [--output FILE] [--no-strict] [--debug]
               [--ignore-parsing-errors] [--encoding ENCODING] [--ms
               MILLISECONDS] [-w WIDTH] [-t] [--no-time-matching]

so what does it do?? it merges multiple subtitles together into one. that's it. that's the whole thing. multiple sub files walk in, one sub file walks out πŸ‘‘πŸ¦‹


πŸŽ€ options: πŸŽ€

  • -h, --help β€” shows you this help message and then dips. exit stage left. πŸ’¨
  • --input FILE, -i FILE β€” the files to process. yes you can pass it more than once, that's the whole point bestie 🌈
  • --output FILE, -o FILE β€” the file to write to. default? stdout. so if you don't say where, it just screams into your terminal πŸ™ˆ
  • --no-strict β€” allows blank lines in the output. and like… your media player may explode πŸ’€ that's a direct quote, not me being dramatic (okay it's a little me being dramatic, but the manpage said it first)
  • --debug β€” turns on debug logging. for when you need to see everything πŸ‘€
  • --ignore-parsing-errors, -c β€” tries to keep going, even if there are parsing errors. main character energy: refuses to stop βœ‹βœ¨
  • --encoding ENCODING, -e ENCODING β€” the encoding to read/write files in. default: utf8 🌸
  • --ms MILLISECONDS β€” if the subs being muxed are within this number of milliseconds of each other, their times get matched up 🫢 default: 600
  • -w WIDTH, --width WIDTH β€” how many subs to consider for time matching at once. default: 5
  • -t, --top-and-bottom β€” uses SSA-style tags to place the files at the top and the bottom, respectively. this turns off time matching, just so you know πŸ‘‘
  • --no-time-matching β€” don't even try to do time matching for close subtitles (peep --ms if you wanna know the deets) πŸ¦‹

πŸ’œ examples: πŸ’œ

merge English and Chinese subtitles β€” a classic, honestly:

$ srt mux -i eng.srt -i chs.srt -o both.srt

merge subtitles, with one on top and one at the bottom β€” stacking era:

$ srt mux -t -i eng.srt -i chs.srt -o both.srt

lowkey reminder: -t kills time matching. that's not a bug, that's just the deal πŸ’…

and that's the page!! srt-mux 3.5.3, born June 2023, still slaying πŸ’– if you made it this far you're officially a subtitle girlie now, iykyk. mwah πŸŽ€βœ¨πŸ¦‹

πŸ“¦ where this page comes from