better-ffmpeg-progress 2.1.9

Run FFmpeg & see percentage progress + ETA.

Better FFmpeg Progress

Runs an FFmpeg command and uses Rich to show a progress bar.

Example:

⠏ Processing... ━━━━━━━━━╺━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  23% 0:00:04 00:15

Where:

• 23% is the percentage progress.
• 0:00:04 is the time (H:MM:SS) elapsed.
• 00:15 is 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 to subprocess.run().

Simple Example:

from better_ffmpeg_progress import FfmpegProcess
# Pass a list of FFmpeg arguments, like you would if using subprocess.run()
process = FfmpegProcess(["ffmpeg", "-i", "input.mp4", "-c:a", "libmp3lame", "output.mp3"])
# Use the run method to run the FFmpeg command.
process.run()

Advanced Example:

from better_ffmpeg_progress import FfmpegProcess

def handle_progress_info(percentage, speed, eta, estimated_filesize):
    print(f"Estimated Output Filesize: {estimated_filesize / 1_000_000} MB")

def handle_success():
  # Code to run if the FFmpeg process completes successfully.
  pass

def handle_error():
  # Code to run if the FFmpeg process encounters an error.
  pass

# Pass a list of FFmpeg arguments, like you would if using subprocess.run()
process = FfmpegProcess(["ffmpeg", "-i", "input.mp4", "-c:a", "libmp3lame", "output.mp3"])

ffmpeg_output_path = 'ffmpeg_output.txt'

# Use the run method to run the FFmpeg command.
process.run(progress_handler=handle_progress_info, ffmpeg_output_file=ffmpeg_output_path, success_handler=handle_success, error_handler=handle_error)

The run method takes the following optional arguments:

• progress_handler

  • You can create a function if you would like to do something with the following values:

    • Percentage progress. [float]
    • Speed, e.g. 22.3x which means that 22.3 seconds of the input are processed every second. [string]
    • ETA in seconds. [float]
    • Estimated output filesize in bytes. [float]
      • Note: This is not accurate. Please take the value with a grain of salt.

    The values will be None if unknown. The function will receive the aforementioned metrics as arguments, about two times per second.

• ffmpeg_output_file - A string path to define where you want the output of FFmpeg to be saved. By default, this is saved in a folder named "ffmpeg_output", with the filename [<input_filename>].txt.

• success_handler - A function to run if the FFmpeg process completes successfully.

• error_handler - A function to run if the FFmpeg process encounters an error.

Changelog:

[19/09/2022]

• Add the ability to specify a success_handler argument, a function to run if the FFmpeg process completes successfully.
• Add 0.001 to tqdm's total parameter to prevent the chance of getting TqdmWarning: clamping frac to range [0, 1]

[21/12/2022]

• [v2.0.7] Fix 'estimated_size' referenced before assignment error.
• [v2.0.7] The progress bar now uses 1 decimal place for seconds processed and total duration.

[22/12/2022]

• [v2.0.8] Add the ability to specify an error_handler argument, a function to run if the FFmpeg process encounters an error.
• [v2.0.9] Fix a typo (commit da45a84)

[07/02/2022]

• [v2.1.0] Update function name to fix 'process_complete_handler' is not defined error.

[05/11/2023]

• [v2.1.2] Do not exit the Python interpreter after the FFmpeg process is complete

[22/04/2024]

• [v2.1.3] Fix issue #20

[28/04/2024]

• [v2.1.4] Fix issue #21

[02/05/2024]

• [v2.1.5] Fix issue #23 and make an error message more specific. Here is the relevant commit.

[18/10/2024]

• [v2.1.6] Notify the user if the input filepath or filename is incorrect.
• [v2.1.7] Refactor to use threads and queues.

[19/10/2024]

• [v2.1.8] Use Rich instead of tqdm and format code with Ruff.

[20/10/2024]

• [v2.1.9] Do not clear the terminal before showing the progress bar.