FFMPEG-PROGRESS-YIELD(1)

📦 version 1.0.5, in ubuntu resolute, ubuntu stonking

💖 FFMPEG-PROGRESS-YIELD(1) 💖

okay bestie, listen — this is the user commands era of ffmpeg-progress-yield, and it's genuinely one of my fav lil tools. no cap.

✨ NAME ✨

ffmpeg-progress-yield — run FFmpeg commands but with progress reporting so you're not just staring at a silent terminal like 👁️👄👁️

🦋 SYNOPSIS 🦋

ffmpeg-progress-yield [OPTIONS] FFMPEG_COMMAND...

🌸 DESCRIPTION 🌸

so basically, ffmpeg-progress-yield is that utility that runs a FFmpeg command for you and gives you real-time progress updates while it goes. it does this iconic lil trick where it parses the timing information out of FFmpeg's output and uses that to update the current percentage of the task. and by default? it shows you the status as a progress bar. slay.

then, once the FFmpeg command finishes, any log messages that got generated during the run get written out to STDERR. so you don't lose your logs, you just don't have to watch them scroll by the whole time. periodt. 💅

🎀 OPTIONS 🎀

  • -h, --help — prints a help message and then dips. exit stage left. 👋
  • -d "DURATION", --duration "DURATION" — overrides the duration of the video, in seconds. you're basically telling it "bestie, here's how long it is" instead of making it figure it out.
  • -p, --progress-only — only report the progress of the FFmpeg command, and do not print the FFmpeg log at exit. progress only, no yapping. 🤫
  • -x, --exclude-progress — excludes the parsed progress lines from the FFmpeg log. so the log stays clean, no progress spam in there.
  • -l "LOGFILE", --log-file "LOGFILE" — sends the FFmpeg log at exit to the LOGFILE you specify. by default it gets sent to STDERR instead.

🌈 ENVIRONMENT 🌈

  • FFMPEG_PROGRESS_NO_TQDM — if FFMPEG_PROGRESS_NO_TQDM is set, the progress bar gets disabled, and instead you get a simple textual representation of the progress. still functional, just less fancy. humble mode. 🧚

⭐ EXAMPLES ⭐

the classic. the moment. the main character energy:

ffmpeg-progress-yield ffmpeg -i input.mp4 -c:v libx264 output.mp4

👑 AUTHOR 👑

Alexander Sulfrian, 2025 — ty for your service, king 🫶

okay that's the whole page bestie, ily, go transcode something 💖

sign-off time: this was ffmpeg-progress-yield version 1.0.5+ds, dated 2025-11-17, and it's part of the FFMPEG-PROGRESS-YIELD(1) manual. mwah. 💋

📦 where this page comes from