PyAV

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

GitHub Test Status Documentation Python Package Index Conda Forge

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

PyAV requires Python 3.11 or later. Binary wheels are provided on PyPI for Linux, macOS, and Windows with FFmpeg bundled. You can install these wheels by running:

pip install av

Another way of installing PyAV is via conda-forge:

conda install av -c conda-forge

See the Conda install docs to get started with Miniconda.

Alternative installation methods

Due to the complexity of the dependencies, PyAV is not always the easiest Python package to install from source. This release supports FFmpeg 8.x. To build the source distribution against an existing FFmpeg installation on Linux or macOS, run:

[!WARNING] FFmpeg's development files and pkg-config must be available on your system.

pip install av --no-binary av

Installing from source

On Linux or macOS, build PyAV from a Git checkout with:

git clone https://github.com/PyAV-Org/PyAV.git
cd PyAV
source scripts/activate.sh

# Build ffmpeg from source. You can skip this step if ffmpeg 8.x is already installed.
./scripts/build-deps

# Build PyAV
make

# Testing
make test

# Install globally
deactivate
pip install .

On Windows, use a Conda environment and the FFmpeg development files maintained by the PyAV project:

git clone https://github.com/PyAV-Org/PyAV.git
cd PyAV
conda create --name pyav-dev --channel conda-forge python=3.11 cython setuptools numpy pillow pytest
conda activate pyav-dev
$ffmpegDir = Join-Path $env:CONDA_PREFIX "Library"
python scripts\fetch-vendor.py --config-file scripts\ffmpeg-latest.json $ffmpegDir
python setup.py build_ext --inplace --ffmpeg-dir=$ffmpegDir
python -m pytest

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

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

4 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for mikeboers from gravatar.com mikeboers Avatar for pyav-pypi-ci from gravatar.com pyav-pypi-ci Avatar for sharky from gravatar.com sharky
+1 more Avatar for WyattBlue from gravatar.com WyattBlue

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: WyattBlue

License expression

BSD-3-Clause
View SPDX License List

Requires

Python >=3.11

Classifiers

Report project as malware

Download files

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

Source Distribution

av-18.1.0.tar.gz (4.5 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

av-18.1.0-cp314-cp314t-win_arm64.whl (21.4 MB view details)

Uploaded CPython 3.14tWindows ARM64

av-18.1.0-cp314-cp314t-win_amd64.whl (28.5 MB view details)

Uploaded CPython 3.14tWindows x86-64

av-18.1.0-cp314-cp314t-musllinux_1_2_x86_64.whl (40.0 MB view details)

Uploaded CPython 3.14tmusllinux: musl 1.2+ x86-64

av-18.1.0-cp314-cp314t-musllinux_1_2_aarch64.whl (37.9 MB view details)

Uploaded CPython 3.14tmusllinux: musl 1.2+ ARM64

av-18.1.0-cp314-cp314t-manylinux_2_31_armv7l.whl (40.9 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.31+ ARMv7l

av-18.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl (39.0 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.28+ x86-64

av-18.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl (37.1 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.28+ ARM64

av-18.1.0-cp314-cp314t-macosx_14_0_arm64.whl (18.4 MB view details)

Uploaded CPython 3.14tmacOS 14.0+ ARM64

av-18.1.0-cp314-cp314t-macosx_11_0_x86_64.whl (22.8 MB view details)

Uploaded CPython 3.14tmacOS 11.0+ x86-64

av-18.1.0-cp311-abi3-win_arm64.whl (20.3 MB view details)

Uploaded CPython 3.11+Windows ARM64

av-18.1.0-cp311-abi3-win_amd64.whl (27.6 MB view details)

Uploaded CPython 3.11+Windows x86-64

av-18.1.0-cp311-abi3-musllinux_1_2_x86_64.whl (36.9 MB view details)

Uploaded CPython 3.11+musllinux: musl 1.2+ x86-64

av-18.1.0-cp311-abi3-musllinux_1_2_aarch64.whl (34.7 MB view details)

Uploaded CPython 3.11+musllinux: musl 1.2+ ARM64

av-18.1.0-cp311-abi3-manylinux_2_31_armv7l.whl (39.4 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.31+ ARMv7l

av-18.1.0-cp311-abi3-manylinux_2_28_x86_64.whl (35.8 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ x86-64

av-18.1.0-cp311-abi3-manylinux_2_28_aarch64.whl (33.6 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ ARM64

av-18.1.0-cp311-abi3-macosx_14_0_arm64.whl (18.2 MB view details)

Uploaded CPython 3.11+macOS 14.0+ ARM64

av-18.1.0-cp311-abi3-macosx_11_0_x86_64.whl (22.5 MB view details)

Uploaded CPython 3.11+macOS 11.0+ x86-64

File details

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

File metadata

  • Download URL: av-18.1.0.tar.gz
  • Upload date:
  • Size: 4.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0.tar.gz
Algorithm Hash digest
SHA256 47bfc286e1bc9de7ab4681fc2b575cd2460a66919d31ffe1bd5aa54fae531a28
MD5 27cb67e41a5ac5bbce8bada2bd2f829b
BLAKE2b-256 8df4f22114d30d3435e38c6af2b4870f37b864403dca6ae7af747a289ce0a18e

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp314-cp314t-win_arm64.whl.

File metadata

  • Download URL: av-18.1.0-cp314-cp314t-win_arm64.whl
  • Upload date:
  • Size: 21.4 MB
  • Tags: CPython 3.14t, Windows ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp314-cp314t-win_arm64.whl
Algorithm Hash digest
SHA256 5cd9085028902c9880622bd37a12fd4b33060f06a52311f6f4867ca9f29a2c3b
MD5 d584c783ee32f3ef5b784618b3f2a516
BLAKE2b-256 c1d20c277a46f12647c1833f40496e132fb6001e0d19e6144b5ea30896461feb

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp314-cp314t-win_amd64.whl.

File metadata

  • Download URL: av-18.1.0-cp314-cp314t-win_amd64.whl
  • Upload date:
  • Size: 28.5 MB
  • Tags: CPython 3.14t, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp314-cp314t-win_amd64.whl
Algorithm Hash digest
SHA256 e4d48b9f12cad009cc72fe4f4099107de5e819c95f82767f4fd01a01481c0661
MD5 44e2c59598d44865ac02c9477e1bb6b0
BLAKE2b-256 d6d6bc4b95bea9c2353a7e4d62a3fcfad9adcf0f881741c6ce01ee179d539ce3

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp314-cp314t-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for av-18.1.0-cp314-cp314t-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 e7ea063f6690193ea335a1d592d6e0274350d45e2ed6af83ee107cb90cbfd84f
MD5 2faa118105bd76b965995470b0441caa
BLAKE2b-256 e9d804507c57249b399c3e4f23f01d221532f357338b5316fd2858fbd343127d

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp314-cp314t-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for av-18.1.0-cp314-cp314t-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 5548b79e2bf1f59b3e9aedc918a72d9dc45b9adaac10ff9470d5dbdda0002e47
MD5 cca89ba20ef42c4b9fd17545989e5a9d
BLAKE2b-256 6b9f2ab7fa292a947ad3466ed8e655eefa3b82f535d7ea598c297b4471a937c4

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp314-cp314t-manylinux_2_31_armv7l.whl.

File metadata

File hashes

Hashes for av-18.1.0-cp314-cp314t-manylinux_2_31_armv7l.whl
Algorithm Hash digest
SHA256 d49a5c542dfdc00f43c6cdb6cc41dac1781ee206fe180b56aa7433dfa816dfae
MD5 4c2a73066a8a2cac8d41a9c8c08cc5cb
BLAKE2b-256 c363b271473b24e806062d31191e40c6d65545e9cf59f80f044eba56dcbba0f4

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for av-18.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 cf8a17466bef07765dbdecc9e66ed9b25d20b4e14f654fbf35345a58ac45fa0c
MD5 f25312f56b08c68bd9adf654e201c226
BLAKE2b-256 5cf711e7f6d848d3690c31ca4f8578167393e619177f1493ccc93b9400852d4e

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for av-18.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 08a9ae288299cfcbf739dba4ad0c53b9b71f45184303dd45947920d022fed695
MD5 cbb814dccaa08f9c6c29aa31659ebc5d
BLAKE2b-256 b820005500ed17a2e62a5e4bb94aa3786942560ec2f55ec1895ebf174c87abef

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp314-cp314t-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for av-18.1.0-cp314-cp314t-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 025f84494cb23278498f03b0d8117d3e47a1cbc9c44b97eb31875cf02251e46b
MD5 a3ebfeaa9208d75d2a393767e2392b42
BLAKE2b-256 d5cc1bc841462114a1adf4f7d87456ab78a6972e23271e71865fcd2bbd0e7360

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp314-cp314t-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for av-18.1.0-cp314-cp314t-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 b36b0bae9e4c62f9487c99481ec15e4e3870fcc868522cd6d18fc2d6bfa04f01
MD5 340d446b039d602fe9336d4182d60f17
BLAKE2b-256 4f5b4a756265d7fb164336c8d377bca21c39cfa2c178be23cedee840a69b59c5

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp311-abi3-win_arm64.whl.

File metadata

  • Download URL: av-18.1.0-cp311-abi3-win_arm64.whl
  • Upload date:
  • Size: 20.3 MB
  • Tags: CPython 3.11+, Windows ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp311-abi3-win_arm64.whl
Algorithm Hash digest
SHA256 5509ec12aaa19fd6601de13cfa6f4cdad450da07982118510592875d970454d6
MD5 981be252805255093b7614a77de54c9f
BLAKE2b-256 4fada3135884c5753b09773176b97201ae602f67ad14206c395ff838d66bf9b0

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp311-abi3-win_amd64.whl.

File metadata

  • Download URL: av-18.1.0-cp311-abi3-win_amd64.whl
  • Upload date:
  • Size: 27.6 MB
  • Tags: CPython 3.11+, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 ea1480b7a8d5405cb5f382b344731bf125fd2c1c6fae3964f6c48595628387ff
MD5 38c5dfe76137c49763b95d27cb62b609
BLAKE2b-256 33b476ba21e46704f632004276b85289a1582e95f5eff760436d6149875a1881

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp311-abi3-musllinux_1_2_x86_64.whl.

File metadata

  • Download URL: av-18.1.0-cp311-abi3-musllinux_1_2_x86_64.whl
  • Upload date:
  • Size: 36.9 MB
  • Tags: CPython 3.11+, musllinux: musl 1.2+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp311-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 191224788d87af06c31784a395bb73f14b72f33d7f4871ace0157de2abdc6276
MD5 1aff27022263faa2dd2d3182063d25a3
BLAKE2b-256 dc94836fa987e3084d11a21489f11357fb24843ef3aa8faf74ddddfc603d5062

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp311-abi3-musllinux_1_2_aarch64.whl.

File metadata

  • Download URL: av-18.1.0-cp311-abi3-musllinux_1_2_aarch64.whl
  • Upload date:
  • Size: 34.7 MB
  • Tags: CPython 3.11+, musllinux: musl 1.2+ ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp311-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 ab5ac081bc9eaf54109120d4e56284674fecfbe520d9aa1707c7fa911ec5f4d2
MD5 7abe239d4e6fec432487a05fe40192cf
BLAKE2b-256 56b1e00d4feae59160149df6126585e726fdc6300798fd40c5dd324879e81f68

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp311-abi3-manylinux_2_31_armv7l.whl.

File metadata

  • Download URL: av-18.1.0-cp311-abi3-manylinux_2_31_armv7l.whl
  • Upload date:
  • Size: 39.4 MB
  • Tags: CPython 3.11+, manylinux: glibc 2.31+ ARMv7l
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp311-abi3-manylinux_2_31_armv7l.whl
Algorithm Hash digest
SHA256 3c8b1f8b46f99d52e2d8b0ed5d0cdadf172d24794d46e2077b16e44ed08e26ff
MD5 707550580ec32736cd2a2ff0ed652a52
BLAKE2b-256 e199b0d04ec553ff9a7e00455458dfa3a39c8a8f627b273056b4e5fe57d590de

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp311-abi3-manylinux_2_28_x86_64.whl.

File metadata

  • Download URL: av-18.1.0-cp311-abi3-manylinux_2_28_x86_64.whl
  • Upload date:
  • Size: 35.8 MB
  • Tags: CPython 3.11+, manylinux: glibc 2.28+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8a032e8d8ebc73dec079364b9b4a6837638a2d106e8472314e685ffbf163e700
MD5 5c62c9fb04a591da93de9025771a444a
BLAKE2b-256 273a204dbfc3e08eb4cdc6e6ff57be02150bc44523ebdb50182d10025792ebd9

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp311-abi3-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for av-18.1.0-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 6fc837cc51adf80331ac850779cd53b5d4c4460b0ebe9057a02a921c6736f19d
MD5 18f43e5497770f960428e66633ae5191
BLAKE2b-256 d9842464ffb64c08c5ce8b522c8e74594714414e3b0575267652c5c51c0574b9

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp311-abi3-macosx_14_0_arm64.whl.

File metadata

  • Download URL: av-18.1.0-cp311-abi3-macosx_14_0_arm64.whl
  • Upload date:
  • Size: 18.2 MB
  • Tags: CPython 3.11+, macOS 14.0+ ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp311-abi3-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 b30a4e8d934558e19602b68998a4d9ac9f250fa0dacef216f7e8e40153b13316
MD5 2864d145588403962a7da47f7234773b
BLAKE2b-256 3fc937a619297492256b77d5ed906e7d8166c10a26ed251dccf1ae03ab19bff6

See more details on using hashes here.

File details

Details for the file av-18.1.0-cp311-abi3-macosx_11_0_x86_64.whl.

File metadata

  • Download URL: av-18.1.0-cp311-abi3-macosx_11_0_x86_64.whl
  • Upload date:
  • Size: 22.5 MB
  • Tags: CPython 3.11+, macOS 11.0+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for av-18.1.0-cp311-abi3-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 ae75d8bb6467895ed1f8572ededf7ffa49eac07f6e483222f5d7d62a41d12f04
MD5 6c94b7ceded16e695c3f509e88103140
BLAKE2b-256 05d4d7cdc8bff143c17a6d35924375ae28dd692cacde38700a7d419fde54f44a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page