dgtlmoon / pyexiv2

Read/Write metadata of digital image, including EXIF, IPTC, XMP.

pyexiv2

Read/Write metadata of digital image, including EXIF, IPTC, XMP.

• install: pip install pyexiv2
• source code on github

Features

• Base on C++ API of Exiv2 and invoke it through pybind11.
• Supports running on Linux, MacOS and Windows, with Python3(64bit, including 3.5 3.6 3.7 3.8 3.9). If you want to run pyexiv2 on another platform, please compile it yourself. See lib
• Supports various metadata
• Supports various image formats
• Supports opening images based on the file path or from bytes data.
• Supports Unicode characters that contained in image path or metadata.

Defects

• Can only read the image less than 2G and modify the image less than 1G.
• Not thread safe.

Usage

• Tutorial
• 中文教程

Tests

There are some test cases in folder pyexiv2/tests.

Other notes

• Does not read/write the "JPEG COM" structure for JPEG Header comments (See https://stackoverflow.com/questions/17447201/how-do-text-comments-in-jpg-files-work )