Better FFmpeg Progress
Runs an FFmpeg command and shows a progress bar with percentage progress, elapsed time and ETA.
FFmpeg outputs something like:
frame= 692 fps= 58 q=28.0 size= 5376KiB time=00:00:28.77 bitrate=1530.3kbits/s speed=2.43x
Better FFmpeg Progress outputs something like:
⠏ Processing abc.webm ━━━━━━━━━╺━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 23% 0:00:04 00:15
Where:
Processing abc.webmis the description of the progresss bar.23%is the percentage progress.0:00:04is the time elapsed.00:15is the estimated time until the FFmpeg process completes.
Installation
pip install better-ffmpeg-progress --upgrade
Usage
Create an instance of the FfmpegProcess class and supply a list of arguments like you would when using subprocess.run() or subprocess.Popen(). Example:
from better_ffmpeg_progress import FfmpegProcess, FfmpegProcessError
command = [
"ffmpeg",
"-i",
"https://media.xiph.org/video/derf/y4m/ducks_take_off_1080p50.y4m",
"-map",
"0:V",
"-c:V",
"libx264",
"-preset",
"ultrafast",
"-f",
"null",
"-",
]
try:
process = FfmpegProcess(command)
# Uncomment this line to use tqdm instead of Rich.
# process.use_tqdm = True
process.run()
except FfmpegProcessError as e:
print(
"An error occurred when running Better FFmpeg Progress:\n"
f"{e}"
)
Duration Override
By default, Better FFmpeg Progress detects the duration of the input file and uses it to calculate percentage progress and ETA.
For partial, damaged, streamed or synthetic inputs, FFmpeg may be unable to detect the duration correctly. In these cases, you can provide the duration manually using duration_override.
The value should be the duration of the input file, in seconds:
from better_ffmpeg_progress import FfmpegProcess
command = [
"ffmpeg",
"-i",
"partial-input.flv",
"-c",
"copy",
"recovered-output.mkv",
]
process = FfmpegProcess(
command,
duration_override=1222.64,
print_detected_duration=True,
)
process.run()
Optional Arguments
An instance of FfmpegProcess accepts the following optional arguments:
ffmpeg_log_level— Set a value for FFmpeg's-logleveloption. Default:"verbose".ffmpeg_log_file— Filepath or file-like object to which FFmpeg stderr will be written. Default:<input filename>_ffmpeg_log.txt.print_detected_duration— Print the detected duration. Default:False.duration_override— Specify input file duration in seconds to use for progress calculation, instead of trying to detect this automatically with FFprobe. Default:None.
The run method accepts the following optional argument:
print_command— Print the FFmpeg command being executed. Default:False.
Using tqdm
By default, the Rich library is used to display a progress bar. tqdm can be used instead by setting process.use_tqdm = True:
process = FfmpegProcess(command)
process.use_tqdm = True
process.run()
1 maintainer
Release files for better-ffmpeg-progress 5.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| better_ffmpeg_progress-5.2.0.tar.gz | 11.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| better_ffmpeg_progress-5.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.5 kB
Release files / better_ffmpeg_progress-5.2.0.tar.gz
| Download URL | better_ffmpeg_progress-5.2.0.tar.gz |
|---|---|
| Size | 11.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
28cdda4d1e20dd64f755a92b928efdd5e64d7cf6b38579bcc76d8fb947e3a661
|
|
BLAKE2b-256 checksum How to use checksums |
79695f7740b8b1bb5125a499548702eb075440fc12ff3e445a241e3e0497520a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.13.0
|
Release files / better_ffmpeg_progress-5.2.0-py3-none-any.whl
| Download URL | better_ffmpeg_progress-5.2.0-py3-none-any.whl |
|---|---|
| Size | 12.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0ed2b63a9af5d3b1e8e84438850d52120c1d6215e959f3a50a5881dc98bbb473
|
|
BLAKE2b-256 checksum How to use checksums |
7e9ff17b29b4c75d00e0097dfb4666fe03aa3c397469a00899aecffe2fb1ce41
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.13.0
|
