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.


  • Supported platforms: Linux 64bit, Windows 64bit
  • Works with Python3 (64bit)
  • Support for image paths and data that contain unicode characters.
  • Not thread-safe, because some global variables have been used in API.


  • 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": ""}  # this will delete the datum in the image
    >>> 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.1.0
Filename, size File type Python version Upload date Hashes
Filename, size pyexiv2-1.1.0-py3-none-any.whl (2.1 MB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size pyexiv2-1.1.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