Skip to content

CGuichard/pffmpeg

PFFmpeg

PFFmpeg logo

Progress bar for FFmpeg

Language License Documentation Style Lint Security PyPI - Version Tests Coverage

Pull Request · Bug Report · Feature Request


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.

Table of Contents

Getting started

Installation

Install pffmpeg with pip:

pip install pffmpeg

Install pffmpeg with pip from source:

pip install git+https://github.com/CGuichard/pffmpeg.git
# pip install git+https://github.com/CGuichard/pffmpeg.git@<tag>

Usage

You can use any ffmpeg command with pffmpeg:

# Print help
pffmpeg -h

# Print version
pffmpeg -version

# Video processing
pffmpeg -i input.mp4 output.mp4

Demo:

Demo pffmpeg

Contributing

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.

License

Copyright © 2026, Clément GUICHARD

PFFmpeg is licensed under the MIT license. A copy of this license is provided in the LICENSE file.

Acknowledgements

This package was created with Cookiecutter from the project template CGuichard/cookiecutter-pypackage.

About

Progress bar for ffmpeg

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors