Skip to main content

Read and modify metadata of digital image, including EXIF, IPTC, XMP.

Project description


Read and modify metadata of digital image, including EXIF, IPTC, XMP. It runs on C++ API of exiv2.


  • Supports running on Linux 64bit, with GLIBC_2.27(required by
  • Supports running on Windows 64bit, with Python3(64bit).
  • Supports Unicode characters that can be used in image paths and data.
  • Not thread-safe, because some global variables have been used in api.cpp.


  • read metadata

    >>> from pyexiv2 import Image
    >>> i = Image("tests/1.jpg")
    >>> i.read_exif()
    {'Exif.Image.DateTime': '2019:06:23 19:45:17', 'Exif.Image.Artist': 'TEST', 'Exif.Image.Rating': '4', ...}
    >>> i.read_iptc()
    {'Iptc.Envelope.CharacterSet': '\x1b%G', 'Iptc.Application2.ObjectName': 'TEST', 'Iptc.Application2.Keywords': 'TEST', ...}
    >>> i.read_xmp()
    {'Xmp.dc.format': 'image/jpeg', 'Xmp.dc.rights': 'lang="x-default" TEST', 'Xmp.dc.subject': 'TEST', ...}
  • modify metadata

    >>> # prepare the XMP data you want to modify
    >>> _dict = {"Xmp.xmp.CreateDate": "2019-06-23T19:45:17.834",   # this will overwrite its original value, or add it if it doesn't exist
    ...          "Xmp.xmp.Rating": ""}  # set an empty str explicitly to delete the datum
    >>> i.modify_xmp(_dict)
    >>> xmp_dict = i.read_xmp()         # read it again
    >>> xmp_dict["Xmp.xmp.CreateDate"]
    '2019-06-23T19:45:17.834'           # it has been set
    >>> xmp_dict["Xmp.xmp.Rating"]
    KeyError: 'Xmp.xmp.Rating'          # it has been deleted
    # use i.modify_exif() and i.modify_iptc() in the same way
  • Metadata reference tables:

  • You may be interested in these metadata on Windows:

    {'Xmp.dc.title': 'lang="x-default" I am title',
    'Xmp.dc.subject': 'label1; label2; label3',


There are some test cases in folder "pyexiv2/tests". Run them by pytest:

pip install pytest psutil
pytest -v

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyexiv2, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pyexiv2-1.2.0-py3-none-any.whl (2.1 MB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size pyexiv2-1.2.0.tar.gz (2.1 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page