Read and modify metadata of digital image, including EXIF, IPTC, XMP.
Reason this release was yanked:
Hide the old version on pypi. If you insist, download it from https://github.com/LeoHsiao1/pyexiv2/releases
Project description
pyexiv2
Read and modify metadata of digital image, including EXIF, IPTC, XMP. It runs on C++ API of exiv2.
- install:
pip install pyexiv2
- source code on github
Features
- Supports running on Linux 64bit, with GLIBC_2.27.
- Supports running on Windows 64bit, with Python3(64bit).
- Supports various formats
- Supports Unicode characters that contained in image paths and data.
- Not thread-safe, because some global variables have been used in api.cpp.
Usage
-
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: https://www.exiv2.org/metadata.html
-
You may be interested in these metadata on Windows:
{'Xmp.dc.title': 'lang="x-default" I am title', 'Xmp.dc.subject': 'label1; label2; label3', 'Xmp.MicrosoftPhoto.Rating':'75'}
Tests
There are some test cases in folder "pyexiv2/tests". Run them by pytest:
pip install pytest psutil
pytest -v
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pyexiv2-1.2.1.tar.gz
.
File metadata
- Download URL: pyexiv2-1.2.1.tar.gz
- Upload date:
- Size: 2.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
c068049a0cdccfa2e77acc41184c4d53c1675dfdfbd6bf13c419e72d9b0dc8b9
|
|
MD5 |
3eac53df858fdb96e634bf16e7dda83c
|
|
BLAKE2b-256 |
c6fae3a5f74c2294cf90c808935886c659564d72dcf8c73b1294ead897d497be
|
File details
Details for the file pyexiv2-1.2.1-py3-none-any.whl
.
File metadata
- Download URL: pyexiv2-1.2.1-py3-none-any.whl
- Upload date:
- Size: 2.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
de3270a61a8a5ddf46bfae6f379f7a6aba19a257625feaadd614729104b174a7
|
|
MD5 |
93ab2d56716a56de9aeee4e4652f219b
|
|
BLAKE2b-256 |
60d38f6f6b4670ba79e37cd5afbee702f581a335bf383ac1d9a466c2f5a7479f
|