av

Pythonic bindings for FFmpeg's libraries.

av Permissive license BSD-3-Clause Active ★ 3,265 v18.1.0 released 2026-08-12

Install

av on PyPI

pip

pip install av

uv

uv add av

poetry

poetry add av

Package facts

License	BSD-3-Clause (permissive)
Python support	supports the current Python release (>=3.11)
Install friction	medium — platform-specific wheel
Runtime dependencies	none
Maintenance	actively maintained — 1 days since the last release
Last repo commit	2026-08-12
First released	2013-11-11
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: av-18.1.0-cp311-abi3-macosx_11_0_x86_64.whl; av-18.1.0-cp311-abi3-macosx_14_0_arm64.whl; av-18.1.0-cp311-abi3-manylinux_2_28_aarch64.whl; av-18.1.0-cp311-abi3-manylinux_2_28_x86_64.whl; av-18.1.0-cp311-abi3-manylinux_2_31_armv7l.whl; av-18.1.0-cp311-abi3-musllinux_1_2_aarch64.whl; av-18.1.0-cp311-abi3-musllinux_1_2_x86_64.whl; av-18.1.0-cp311-abi3-win_amd64.whl; av-18.1.0-cp311-abi3-win_arm64.whl; av-18.1.0-cp314-cp314t-macosx_11_0_x86_64.whl; av-18.1.0-cp314-cp314t-macosx_14_0_arm64.whl; av-18.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl; av-18.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl; av-18.1.0-cp314-cp314t-manylinux_2_31_armv7l.whl; av-18.1.0-cp314-cp314t-musllinux_1_2_aarch64.whl; av-18.1.0-cp314-cp314t-musllinux_1_2_x86_64.whl; av-18.1.0-cp314-cp314t-win_amd64.whl; av-18.1.0-cp314-cp314t-win_arm64.whl

Development Status :: 5 - Production/StableIntended Audience :: DevelopersNatural Language :: EnglishOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXOperating System :: UnixProgramming Language :: CythonProgramming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Multimedia :: Sound/AudioTopic :: Multimedia :: Sound/Audio :: ConversionTopic :: Multimedia :: VideoTopic :: Multimedia :: Video :: ConversionTopic :: Software Development :: Libraries :: Python Modules

About av

from the package's own PyPI description — quoted content, verbatim

PyAV

PyAV is a Pythonic binding for the [FFmpeg][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][github-tests-badge]][github-tests] [![Documentation][docs-badge]][docs] [![Python Package Index][pypi-badge]][pypi] [![Conda Forge][conda-badge]][conda]

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][pypi] for Linux, macOS, and Windows with FFmpeg bundled. You can install these wheels by running:

```bash pip install...

Read as markdown · JSON record · Source repository