Skip to main content

Pythonic bindings for FFmpeg's libraries.

Project description

PyAV

GitHub Test 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.

Installation

Due to the complexity of the dependencies, PyAV is not always the easiest Python package to install from source. Since release 8.0.0 binary wheels are provided on PyPI for Linux, Mac and Windows linked against a modern FFmpeg. You can install these wheels by running:

pip install av

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

pip install av --no-binary av

Alternative installation methods

Another way of installing PyAV is via conda-forge:

conda install av -c conda-forge

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

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

git clone git@github.com:mikeboers/PyAV
cd PyAV
source scripts/activate.sh

# Either install the testing dependencies:
pip install --upgrade -r tests/requirements.txt
# or have it all, including FFmpeg, built/installed for you:
./scripts/build-deps

# Build PyAV.
make

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

av-8.0.0.tar.gz (2.3 MB view details)

Uploaded Source

File details

Details for the file av-8.0.0.tar.gz.

File metadata

  • Download URL: av-8.0.0.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.7

File hashes

Hashes for av-8.0.0.tar.gz
Algorithm Hash digest
SHA256 f2bcc5b3538e479df80a9cfc7edba681e6927cd89fef236b49da4e883c7e4d24
MD5 3193a8db5f1e6735e3ee703e3b7dea11
BLAKE2b-256 aa2f6a4b1916d4ebeb02307ae7b03d55d6ef5f027541bd8bb54f91955bea070a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page