MP4SUBTITLE(1)

📦
version 2.1.0 · 2 versions
, in fedora 43

💖 MP4SUBTITLE 💖

okay bestie, welcome to mp4subtitle — that's the manual page for mp4subtitle trunk-r507, part of the MP4v2 Utilities squad. she's giving subtitle-wrangling main character energy and honestly? she ate. 🎀

✨ SYNOPSIS ✨

mp4subtitle [OPTION]... ACTION file...

so like… options first, then you tell her what action to do, then the files. that's the whole vibe. 🌸

🦋 DESCRIPTION 🦋

for each mp4 file you list, she's gonna perform the ACTION you picked. and no cap — you must specify an action, she will not guess, she is not psychic. some options just don't apply to some actions either, so don't be weird about it. 💅

🌈 ACTIONS 🌈

  • --list — list all the available subtitles. window shopping, but for subs. ✨
  • --export TXT — export those subtitles out to TXT. yeet them into a text file. 💌
  • --import TXT — import subtitles from TXT. bring them home. 🫶
  • --remove — remove all the subtitles. every single one. gone. bye bestie 😭

👑 OPTIONS 👑

  • -z, --optimize — optimize the mp4 file after modifying it. glow-up post-edit, we love to see it. ✨
  • -y, --dryrun — do not actually create or modify any files. just pretend. a rehearsal, a dress rehearsal, nothing more. 🙈
  • -k, --keepgoing — keep batch processing even after errors happen. she does not fold under pressure. 💪
  • -o, --overwrite — overwrite existing files when creating. no hesitation. 🔥
  • -f, --force — force overwrite even if the file is read-only. she said what she said. 💅
  • -q, --quiet — literally the same thing as --verbose 0. same energy, shorter name. 🤫
  • -d, --debug NUM — increase debug, or use the long-option to set NUM directly. 🔍
  • -v, --verbose NUM — increase verbosity, or use the long-option to set NUM directly. 🗣️
  • -h, --help — print the brief help, or use the long-option for extended help. she's happy to explain herself. 💖
  • --version — print version info and exit. her whole résumé. ⭐

💀 DEBUG LEVELS 💀

(these are for raw mp4 file I/O, so like… the deep lore)

  1. supressed 🫥
  2. add warnings and errors — (default)
  3. add table details
  4. add implicits
  5. everything — the full unhinged data dump, no crumbs left 🌈

🌸 VERBOSE LEVELS 🌸

  1. warnings and errors
  2. normal informative messages — (default)
  3. more informative messages
  4. everything ⭐
lowkey a reminder: -q is just --verbose 0 wearing a little disguise. iykyk. 💅

and that's the whole page bestie!! this was MP4v2 trunk-r507, dated July 2025, and she's an absolute icon, periodt. now go forth and subtitle. 🎀✨💖

📦 where this page comes from