tlpower / pyexiv2

Read/Write metadata(including EXIF, IPTC, XMP), comment and ICC Profile embedded in digital images.

pyexiv2

Read/Write metadata(including EXIF, IPTC, XMP), comment and ICC Profile embedded in digital images.

• Install: pip install pyexiv2
• Source code on GitHub

Features

• Base on C++ API of Exiv2 and wrapped with pybind11.
• Supports running on 64bit Linux, MacOS and Windows, with CPython(≥3.5) interpreter.
• Supports various image 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't read the image larger than 2G, or modify the image larger than 1G. (related issue)
• Not thread safe, because it uses some global variables in C++.

Docs

• Tutorial

• 中文教程

• Similar projects:

  • pyexiv2: It is a Python 2 binding to exiv2, hasn't been updated since 2011.
  • py3exiv2: It is a Python 3 binding to exiv2, wrapped with Boost.Python.

Tests

There are some test cases in folder pyexiv2/tests.