Currently, it includes the basics for reading/writing audio and video. We aim to provide all of the power and control of the underlying library, but manage the gritty details for you as much as possible.
import av container = av.open('/path/to/video.mp4') for packet in container.demux(): for frame in packet.decode(): if frame.type == 'video': frame.to_image().save('/path/to/frame-%04d.jpg' % frame.index)
PyAV depends upon the following components of the underlying libraries:
On Ubuntu 14.04 LTS everything can come from the default sources:
sudo apt-get install -y \ libavformat-dev libavcodec-dev libavdevice-dev \ libavutil-dev libswscale-dev libavresample-dev \
On Ubuntu 12.04 LTS you will be unable to satisfy these requirements with the default package sources. We recomment compiling and installing FFmpeg or Libav from source. For FFmpeg:
wget http://ffmpeg.org/releases/ffmpeg-1.2.2.tar.bz2 tar -xjf ffmpeg-1.2.2.tar.bz2 cd ffmpeg-1.2.2 ./configure --disable-static --enable-shared --disable-doc make sudo make install
See this script for a very detailed installation of all dependencies.
$ pip install av
$ git clone firstname.lastname@example.org:mikeboers/PyAV.git $ cd PyAV $ virtualenv venv $ . venv/bin/activate $ pip install cython pil $ make $ python setup.py build_ext --inplace
On Mac OS X you may have issues with regards to Python expecting gcc but finding clang. Try to export the following before installation:
We are attempting to write this wrapper to work with either FFmpeg or Libav. We are using ctypes to detect the differences that we have discerned exist as this wrapper is being developed. This is a fairly trial-and-error process, so please let us know if there are any odd compiler errors or something won’t link due to missing functions.
Additionally, we are far from wrapping the full extents of the libraries. Notable omissions include device and filter support, but there are many C struct members which are currently unexposed.