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.
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.12 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:
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.12 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!
4 maintainers
Metadata
4 maintainers
Release files for av 19.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| av-19.0.0.tar.gz | 4.3 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| av-19.0.0-cp314-cp314t-win_arm64.whl | CPython 3.14 | CPython 3.14 free-threading | Windows ARM64 | Details |
| av-19.0.0-cp314-cp314t-win_amd64.whl | CPython 3.14 | CPython 3.14 free-threading | Windows x86-64 | Details |
| av-19.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux musl 1.2+ x86-64 | Details |
| av-19.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux musl 1.2+ ARM64 | Details |
| av-19.0.0-cp314-cp314t-manylinux_2_31_armv7l.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.31+ ARMv7l | Details |
| av-19.0.0-cp314-cp314t-manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.28+ x86-64 | Details |
| av-19.0.0-cp314-cp314t-manylinux_2_28_aarch64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.28+ ARM64 | Details |
| av-19.0.0-cp314-cp314t-macosx_14_0_arm64.whl | CPython 3.14 | CPython 3.14 free-threading | macOS 14.0+ ARM64 | Details |
| av-19.0.0-cp314-cp314t-macosx_11_0_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | macOS 11.0+ x86-64 | Details |
| av-19.0.0-cp312-abi3-win_arm64.whl | CPython 3.12 | abi3 | Windows ARM64 | Details |
| av-19.0.0-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details |
| av-19.0.0-cp312-abi3-musllinux_1_2_x86_64.whl | CPython 3.12 | abi3 | Linux musl 1.2+ x86-64 | Details |
| av-19.0.0-cp312-abi3-musllinux_1_2_aarch64.whl | CPython 3.12 | abi3 | Linux musl 1.2+ ARM64 | Details |
| av-19.0.0-cp312-abi3-manylinux_2_31_armv7l.whl | CPython 3.12 | abi3 | Linux glibc 2.31+ ARMv7l | Details |
| av-19.0.0-cp312-abi3-manylinux_2_28_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| av-19.0.0-cp312-abi3-manylinux_2_28_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| av-19.0.0-cp312-abi3-macosx_14_0_arm64.whl | CPython 3.12 | abi3 | macOS 14.0+ ARM64 | Details |
| av-19.0.0-cp312-abi3-macosx_11_0_x86_64.whl | CPython 3.12 | abi3 | macOS 11.0+ x86-64 | Details |
Total release size: 561.6 MB
Release files / av-19.0.0.tar.gz
| Download URL | av-19.0.0.tar.gz |
|---|---|
| Size | 4.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f04d31a42570cb8ec8216569b94491e91848cdac2ac8e7591c6141fda6cc86ee
|
|
BLAKE2b-256 checksum How to use checksums |
cddf0a05835bf588932b7c87ad13ac8ffc781215a3071c755edf084a67331923
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp314-cp314t-win_arm64.whl
| Download URL | av-19.0.0-cp314-cp314t-win_arm64.whl |
|---|---|
| Size | 21.9 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows ARM64 |
|
SHA-256 checksum How to use checksums |
4ae39a96b26b20b74e4a34e75b3fd94be8db02501f1641318763365f8b5a877d
|
|
BLAKE2b-256 checksum How to use checksums |
26b73eff82912fa1c97336b6770b14cce0e97d8602720770f6a9815867909e59
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp314-cp314t-win_amd64.whl
| Download URL | av-19.0.0-cp314-cp314t-win_amd64.whl |
|---|---|
| Size | 29.1 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows x86-64 |
|
SHA-256 checksum How to use checksums |
66cb6adc7b6d29a44330f31a33fea7a6d4694e10a674d319a10aba383861b5cf
|
|
BLAKE2b-256 checksum How to use checksums |
6091cc5a14489fa0ea59f3a7698cfcc653b834e4539d4b9fc4167ffadc9092d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl
| Download URL | av-19.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 39.5 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
2a8a7cea7f7abe4b942c89453aaddf6f35b2ec53dd555e466837076749513260
|
|
BLAKE2b-256 checksum How to use checksums |
d03143f91bcceb9b92b79c3fb5b5338c8ed2c7b150d94aec6cb1fd32a7b93d24
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl
| Download URL | av-19.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 37.4 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux musl 1.2+ ARM64 |
|
SHA-256 checksum How to use checksums |
4ed23a335b3074b938b6be0914854abdf7c74af61d659b3014d9f611c2a07691
|
|
BLAKE2b-256 checksum How to use checksums |
554e7d5af6943f58a384b43afcda6950d3a1d74ff682d46302a154daef90ce42
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp314-cp314t-manylinux_2_31_armv7l.whl
| Download URL | av-19.0.0-cp314-cp314t-manylinux_2_31_armv7l.whl |
|---|---|
| Size | 43.5 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.31+ ARMv7l |
|
SHA-256 checksum How to use checksums |
1a85336ed906cea1011aadd0b47bbce9499ace07553794251a9408b748703949
|
|
BLAKE2b-256 checksum How to use checksums |
c5fba24aa1ea6881ac57c579e1ec7d933913fa216e46c017963b92d299621a86
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp314-cp314t-manylinux_2_28_x86_64.whl
| Download URL | av-19.0.0-cp314-cp314t-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 38.5 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
806c8b5a94c002ba761e9b6efcf8052c2ec35c14485461f3092cd07098e16c32
|
|
BLAKE2b-256 checksum How to use checksums |
612c5c209bc24ef6ef68e61daade23ea64ee15a442bcbd2d981b657c4edc74dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp314-cp314t-manylinux_2_28_aarch64.whl
| Download URL | av-19.0.0-cp314-cp314t-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 36.5 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
a19f1e126d3bd30f1a14bf7770db56db77081283d9c5e24ade660680e5f89c6c
|
|
BLAKE2b-256 checksum How to use checksums |
de3349e0443507bcbf84fcf9f3396d143bd263d22ab190ac7b9ebc7da5ecf9d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp314-cp314t-macosx_14_0_arm64.whl
| Download URL | av-19.0.0-cp314-cp314t-macosx_14_0_arm64.whl |
|---|---|
| Size | 18.7 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
53637e493c46bc81b9828a89370905bdf01f01586099cb4304cd417e7ab890ce
|
|
BLAKE2b-256 checksum How to use checksums |
a3a8fe2844707508cfbc4a5e5195683251995a5b6b20f73ed8334f7cb0eec9ad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp314-cp314t-macosx_11_0_x86_64.whl
| Download URL | av-19.0.0-cp314-cp314t-macosx_11_0_x86_64.whl |
|---|---|
| Size | 22.9 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
35baec96c0a217c6a31683c019d12b4e0e301001d4fa34d6a1af628b9a6d1968
|
|
BLAKE2b-256 checksum How to use checksums |
cc0eed0cfb0fe0608ab2e4ea97359d3883f2b36800c37df72353f4b0fe18db29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp312-abi3-win_arm64.whl
| Download URL | av-19.0.0-cp312-abi3-win_arm64.whl |
|---|---|
| Size | 20.7 MB |
| Tags | CPython 3.12 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
4a47943e9de8f918fe6033a6d8a84b69f7e2068e21efe533b9381745d78646b3
|
|
BLAKE2b-256 checksum How to use checksums |
b54a5320ccae913cea0335f8e327ead232621bd249b75349bbcc6df331cbb3e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp312-abi3-win_amd64.whl
| Download URL | av-19.0.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 28.2 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
96e4c0981ec21cadfef4c0b840d04a5e3c3be821894aa6a7d7a8ee870ba6b727
|
|
BLAKE2b-256 checksum How to use checksums |
382181eefc2224ce5e44131552333a703346f55f0e23cae7db20961931b9d298
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp312-abi3-musllinux_1_2_x86_64.whl
| Download URL | av-19.0.0-cp312-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 36.1 MB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
08bed1abdfa9842de06f4a6097ca833c6ddda806828e5338182a6d2ad0b93eb2
|
|
BLAKE2b-256 checksum How to use checksums |
5d8f6678c8b2e6a076cffdb90da38358ff89b0a4929d70619ac8ede0dc752f84
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp312-abi3-musllinux_1_2_aarch64.whl
| Download URL | av-19.0.0-cp312-abi3-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 33.8 MB |
| Tags | CPython 3.12 Linux musl 1.2+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
81e5238a5453e713666f85c43feebff212a7f22043869ebe15a39ab439088801
|
|
BLAKE2b-256 checksum How to use checksums |
6add0db9cc6c1ce67400ea645a489908c5a670333ce34e9fd351b82036ad99a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp312-abi3-manylinux_2_31_armv7l.whl
| Download URL | av-19.0.0-cp312-abi3-manylinux_2_31_armv7l.whl |
|---|---|
| Size | 41.7 MB |
| Tags | CPython 3.12 Linux glibc 2.31+ ARMv7l abi3 |
|
SHA-256 checksum How to use checksums |
75f2377c274cdb7add045f235e4f65aa4b8ac8380593a36966eabc2d50623d0b
|
|
BLAKE2b-256 checksum How to use checksums |
a014cc6a83019d1725e4b1bb89962755f0f6c307f882a1e2f68942192ac7db9a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp312-abi3-manylinux_2_28_x86_64.whl
| Download URL | av-19.0.0-cp312-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 35.0 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
9cd9f692c28990ee234ddde69f72725bbff93831ffa6d2492518d4b193dda0c8
|
|
BLAKE2b-256 checksum How to use checksums |
fe6e4531007ff65d2ee36883e20546d9c82f9df84b99434846074a4b7c7b72db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp312-abi3-manylinux_2_28_aarch64.whl
| Download URL | av-19.0.0-cp312-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 32.7 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
07f81500bda7636798dfaae26e5fe8a426b1b6ef1affbbef9f688e16149a7409
|
|
BLAKE2b-256 checksum How to use checksums |
392425b5e1edd5075591b0b13b4d84b76f0d86c654f1e5d62d5e7083d2e59db4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp312-abi3-macosx_14_0_arm64.whl
| Download URL | av-19.0.0-cp312-abi3-macosx_14_0_arm64.whl |
|---|---|
| Size | 18.4 MB |
| Tags | CPython 3.12 abi3 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
353378a1e5659817fb3bc5bbbd678e61cf68deb9b13d65eadc34d664ebd27192
|
|
BLAKE2b-256 checksum How to use checksums |
da219cda63812650bcffaffeff106ee918e750cb8a13f6d922ee02c945f60292
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / av-19.0.0-cp312-abi3-macosx_11_0_x86_64.whl
| Download URL | av-19.0.0-cp312-abi3-macosx_11_0_x86_64.whl |
|---|---|
| Size | 22.6 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
4e135cdb49dddcb988af9d2c597c9a60b6bd74669c16e9866cb4275b567a4eb5
|
|
BLAKE2b-256 checksum How to use checksums |
2aa4bfe5895c8d2af94300939b115a18f5f00e1162837082115a38089df757ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
