Documentation: https://cguichard.github.io/pffmpeg
Source Code: https://github.com/CGuichard/pffmpeg
The FFmpeg command line tool is a universal media converter. It can read a wide variety of inputs, filter and transcode them into a plethora of output formats. For new user it can be extremely convoluted to use, and read the output. When converting a video file for the first time, understanding the progress of the current task from the output is quite the confusing task.
This is where PFFmpeg comes in. It's CLI is just on top of FFmpeg's, and delegates everything to it.
The output of the FFmpeg is parsed and "patched" to display a progress bar while running an action
such as a video compression. PFFmpeg philosophy is to alter as little as possible the FFmpeg experience,
and simply add the progress bar when needed, unlike other project who just wrap and hide all of the
output behind a progress bar. In terms of style, the
rich progress bar was chosen.
Install pffmpeg with pip:
pip install pffmpegInstall pffmpeg with pip from source:
pip install git+https://github.com/CGuichard/pffmpeg.git
# pip install git+https://github.com/CGuichard/pffmpeg.git@<tag>You can use any ffmpeg command with pffmpeg:
# Print help
pffmpeg -h
# Print version
pffmpeg -version
# Video processing
pffmpeg -i input.mp4 output.mp4Demo:
If you want to contribute to this project please check CONTRIBUTING.md.
Everyone contributing to this project is expected to treat other people with respect, and more generally to follow the guidelines articulated by our Code of Conduct.
Copyright © 2026, Clément GUICHARD
PFFmpeg is licensed under the MIT license. A copy of this license is provided in the LICENSE file.
This package was created with Cookiecutter from the project template CGuichard/cookiecutter-pypackage.

