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_valueswas removed in py3exiv2, use
pyexiv2.preview.Preview.datais not implemented, use
- All the string returned by any
Tag.valueare 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.
- API documentation