Counting 3,663 Big Data & Machine Learning Frameworks, Toolsets, and Examples...
Suggestion? Feedback? Tweet @stkim1

Last Commit
Mar. 17, 2019
Nov. 25, 2012


Travis Build Status AppVeyor Build Status
Gitter Chat Documentation
GitHub Python Package Index Conda Forge

PyAV is a Pythonic binding for the FFmpeg libraries. We aim to provide all of the power and control of the underlying library, but manage the gritty details as much as possible.

PyAV is for direct and precise access to your media via containers, streams, packets, codecs, and frames. It exposes a few transformations of that data, and helps you get your data to/from other packages (e.g. Numpy and Pillow).

This power does come with some responsibility as working with media is horrendously complicated and PyAV can't abstract it away or make all the best decisions for you. If the ffmpeg command does the job without you bending over backwards, PyAV is likely going to be more of a hindrance than a help.

But where you can't work without it, PyAV is a critical tool.


Due to the complexity of the dependencies, PyAV is not always the easiest Python package to install. The most straight-foward install is via conda-forge:

conda install av -c conda-forge

See the Conda quick install docs to get started with (mini)Conda.

If you want to use your existing FFmpeg/Libav, the C-source version of PyAV is on PyPI:

pip install av

And if you want to build from the absolute source (for development or testing):

git clone
cd PyAV
source scripts/activate

Have fun, read the docs, come chat with us, and good luck!

Latest Releases
 Jan. 23 2019
 Nov. 8 2018
 Oct. 17 2018
 Oct. 3 2018
 Sep. 20 2018