Skip to content
/ avif Public
forked from Julian/avif

Python (CFFI) bindings for libavif

License

Notifications You must be signed in to change notification settings

olokelo/avif

 
 

Repository files navigation

avif

PyPI version Supported Python versions Build status

Python bindings for libavif (via CFFI)

Installation from PyPI

avif is available via PyPI, with wheels built for many common platforms. It can be installed via your favorite Python package manager, e.g.:

$ pip install avif

Installation from source

To install this module from source you will need to compile libavif yourself. If you want to make use of the decoder you will also need to compile one (decoders/encoders can be compiled from libavif).

List of available AV1 decoders:

If you compile avif without an AV1 decoder you will get AVIFError: No codec available raised when you try to get a result, but you will still be able to import python module.

The installation steps below show how to compile libavif with the aom decoder.

Platform-Specific Steps

Examples

Examples can be found under examples directory.

You can use sample.avif if you don't have any avif encoded image for testing. Sample is 128x128 pixels in size and it's all white (RGBA: 255, 255, 255, 255).

To test if library works properly you can run:

python3 examples/avif_example_decode_file.py examples/sample.avif

Correct output:

Parsed AVIF: 128x128 (8bpc)
* First pixel: RGBA(255, 255, 255, 255)

About

Python (CFFI) bindings for libavif

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%