Welcome to py3exiv2’s documentation!

py3exiv2 is a Python 3 binding to exiv2, the C++ library for manipulation of EXIF, IPTC and XMP image metadata. It is a python 3 module that allows your scripts to read and write metadata (EXIF, IPTC, XMP, thumbnails) embedded in image files (JPEG, TIFF, ...).

It is designed as a high-level interface to the functionalities offered by libexiv2. Using python’s built-in data types and standard modules, it provides easy manipulation of image metadata.

py3exiv2 is distributed under the GPL version 3 license.

The main content of the code was initially written by Olivier Tilloy for Python 2 under the name pyexiv2.

Differences between py3exiv2 (Python 3) and pyexiv2 (Python 2)

The module’s name and the syntax are unchanged, your code written previously for Python 2 may run with py3exiv2, however there’s three thinks that you should be care.

  • The deprecated IptcTag.raw_values was removed in py3exiv2, use IptcTag.raw_value instead.
  • The pyexiv2.preview.Preview.data is not implemented, use pyexiv2.exif.ExifThumbnail.data instead.
  • All the string returned by any Tag.value are unicode, but you don’t need to convert yours strings in bytes to set a value for a tag which only accept ASCII characters, this is the job of py3exiv2.

Contents:

Indices and tables