Run FFmpeg & see percentage progress + ETA.
Project description
Better FFmpeg Progress
Runs an FFmpeg command and uses tqdm to show a progress bar. Here's an example:
39%|███████████████████████████████████████████ | 23.581/60.226 [00:19<00:34, 1.07s/s]
Where:
39%
is the percentage progress.23.581
seconds of the input file have been processed.60.226
is the duration of the input file in seconds.00:19
is the time elapsed since the FFmpeg process started.00:34
is the estimated time required for the FFmpeg process to complete.1.07
shows how many seconds of the input file are processed per second.
Installation:
pip3 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()
:
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. The progress information will be printed in the terminal.
process.run()
The run
method takes the following optional arguments:
-
progress_handler
-
You can create a function if you want to retrieve the percentage progress, speed and ETA rather to do something specific with the aforementioned metrics. The function will receive:
- Percentage progress (float)
- Speed (string), e.g.
22.3x
- ETA in seconds (float)
Here's an example of a progress handler that you can create:
def handle_progress_info(percentage, speed, eta): print(f"The FFmpeg process is {percentage}% complete. ETA is {eta} seconds based on the current speed ({speed}).)
Then you simply set the value of the
progress_handler
argument to the name of your function, like so:process.run(progress_handler=handle_progress_info)
-
-
ffmpeg_output_file
- The
ffmpeg_output_file
argument allows you 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
, but you can change this using theffmpeg_output_file
argument.
- The
Here's an example where both the progress_handler
and ffmpeg_output_file
parameters are used:
process.run(progress_handler=handle_progress_info, ffmpeg_output_file="ffmpeg_log.txt")
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for better-ffmpeg-progress-2.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6ee8786ab2f6c536def7f8c7012c8f7fce5d00f21270bd594729087112c83bd8 |
|
MD5 | c4036f3d689f261a0d2b0cee28027b7e |
|
BLAKE2b-256 | 3088acefb091cd6fb82ee91b951778fa8fee8ac9564afbbe71148e1f1c86ea65 |
Hashes for better_ffmpeg_progress-2.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 78ac945eefcc02c27de42f34d190dca27d9357123b14e9297dfcee0ec72f3dd2 |
|
MD5 | 8fc070facd793158df6b6ab054ddcb91 |
|
BLAKE2b-256 | d9a714092d3882b89a82e43f3c7036ce0cd33c59d12142bdc8aa509078b75a40 |