MP4TRACK(1)

MP4TRACK 💖

okay bestie, welcome to mp4track, aka the manual page for mp4track trunk-r507 — and no, that's not a typo, it's literally the trunk build number, slay. This is one of the MP4v2 Utilities and she is so capable it's giving main character energy. Let's get into it 🎀

---

✨ SYNOPSIS ✨

mp4track [OPTION]... [PARAMETERS]... ACTION file...

---

🦋 DESCRIPTION 🦋

So here's the vibe: for each mp4 file you hand over, she performs the ACTION you picked. And like — you have to pick an action, bestie, there's no default, she's not gonna guess. Also heads up: some options simply don't apply to some actions. It's giving "read the room", not "read the whole flag list and assume". 🙈

---

💅 ACTIONS

• --list — list every track in the mp4. The receipts. The full roster. 👑
• --enabled BOOL — sets trak.tkhd.flags (the enabled bit).
• --inmovie BOOL — sets trak.tkhd.flags (the inMovie bit).
• --inpreview BOOL — sets trak.tkhd.flags (the inPreview bit).
• --layer NUM — sets trak.tkhd.layer.
• --altgroup NUM — sets trak.tkhd.alternate_group.
• --volume FLOAT — sets trak.tkhd.volume.
• --width FLOAT — sets trak.tkhd.width.
• --height FLOAT — sets trak.tkhd.height.
• --language CODE — sets trak.mdia.mdhd.language.
• --hdlrname STR — sets trak.mdia.hdlr.name.
• --udtaname STR — sets trak.udta.name.value.
• --udtaname-remove — removes the trak.udta.name atom. bye babe 💀
• --colr-list — lists all colr-boxes in the mp4.
• --colr-add — adds a colr-box to a video track.
• --colr-set — sets colr-box parms.
• --colr-remove — removes the colr-box from the track.
• --pasp-list — lists all pasp-boxes in the mp4.
• --pasp-add — adds a pasp-box to a video track.
• --pasp-set — sets pasp-box parms.
• --pasp-remove — removes the pasp-box from the track.

---

🌸 PARAMETERS

• --track-any — act on any/all tracks. she's not picky, she's generous 💖
• --track-index IDX — act on track index IDX.
• --track-id ID — act on track id ID.
• --colr-parms CSV — where CSV is IDX1,IDX2,IDX3.
• --colr-parm-hd — equivalent to --colr-parms=1,1,1.
• --colr-parm-sd — equivalent to --colr-parms=6,1,6.
• --pasp-parms CSV — where CSV is hSPACING,vSPACING.

---

🌈 OPTIONS 🌈

• -z, --optimize — optimize the mp4 file after modification. glow-up, but for bytes ✨
• -y, --dryrun — do not actually create or modify any files. window shopping only, no cap.
• -k, --keepgoing — continue batch processing even after errors. she does NOT quit mid-setlist 🔥
• -o, --overwrite — overwrite existing files when creating.
• -f, --force — force overwrite even if the file is read-only. unhinged? maybe. iconic? absolutely 💅
• -q, --quiet — equivalent to --verbose 0.
• -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 brief help, or use the long-option for extended help.
• --version — print version information and exit.

---

🧚 DEBUG LEVELS 🧚

(for raw mp4 file I/O — yes, the actual guts, we love a behind-the-scenes moment)

• 0 — supressed
• 1 — add warnings and errors (default)
• 2 — add table details
• 3 — add implicits
• 4 — everything

---

⭐ VERBOSE LEVELS ⭐

• 0 — warnings and errors
• 1 — normal informative messages (default)
• 2 — more informative messages
• 3 — everything

---

bestie reminder 🫶: -y/--dryrun is your bestie when you're not sure, and -f/--force will genuinely write over read-only files, so know what you're doing before you commit, fr fr.

---

that's the whole page, no notes 💜 this was mp4track from the MP4v2 crew, version trunk-r507, dated July 2025 — periodt, go make some tracks do what you want 🎀🌸