1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
*******
EXIF.py
*******
Easy to use Python module to extract Exif metadata from digital image files.
Supported formats: TIFF, JPEG, PNG, Webp, HEIC
Compatibility
*************
EXIF.py is tested and officially supported on Python 3.5 to 3.10
Starting with version ``3.0.0``, Python2 compatibility is dropped *completely* (syntax errors due to type hinting).
https://pythonclock.org/
Installation
************
Stable Version
==============
The recommended process is to install the `PyPI package <https://pypi.python.org/pypi/ExifRead>`_,
as it allows easily staying up to date::
$ pip install exifread
See the `pip documentation <https://pip.pypa.io/en/latest/user_guide.html>`_ for more info.
EXIF.py is mature software and strives for stability.
Development Version
===================
After cloning the repo, use the provided Makefile::
make venv reqs-install
Which will install a virtual environment and install development dependencies.
Usage
*****
Command line
============
Some examples::
EXIF.py image1.jpg
EXIF.py -dc image1.jpg image2.tiff
find ~/Pictures -name "*.jpg" -o -name "*.tiff" | xargs EXIF.py
Show command line options::
EXIF.py -h
Python Script
=============
.. code-block:: python
import exifread
# Open image file for reading (must be in binary mode)
f = open(path_name, 'rb')
# Return Exif tags
tags = exifread.process_file(f)
*Note:* To use this library in your project as a Git submodule, you should::
from <submodule_folder> import exifread
Returned tags will be a dictionary mapping names of Exif tags to their
values in the file named by path_name.
You can process the tags as you wish. In particular, you can iterate through all the tags with:
.. code-block:: python
for tag in tags.keys():
if tag not in ('JPEGThumbnail', 'TIFFThumbnail', 'Filename', 'EXIF MakerNote'):
print "Key: %s, value %s" % (tag, tags[tag])
An ``if`` statement is used to avoid printing out a few of the tags that tend to be long or boring.
The tags dictionary will include keys for all of the usual Exif tags, and will also include keys for
Makernotes used by some cameras, for which we have a good specification.
Note that the dictionary keys are the IFD name followed by the tag name. For example::
'EXIF DateTimeOriginal', 'Image Orientation', 'MakerNote FocusMode'
Tag Descriptions
****************
Tags are divided into these main categories:
- ``Image``: information related to the main image (IFD0 of the Exif data).
- ``Thumbnail``: information related to the thumbnail image, if present (IFD1 of the Exif data).
- ``EXIF``: Exif information (sub-IFD).
- ``GPS``: GPS information (sub-IFD).
- ``Interoperability``: Interoperability information (sub-IFD).
- ``MakerNote``: Manufacturer specific information. There are no official published references for these tags.
Processing Options
******************
These options can be used both in command line mode and within a script.
Faster Processing
=================
Don't process makernote tags, don't extract the thumbnail image (if any).
Pass the ``-q`` or ``--quick`` command line arguments, or as:
.. code-block:: python
tags = exifread.process_file(f, details=False)
Stop at a Given Tag
===================
To stop processing the file after a specified tag is retrieved.
Pass the ``-t TAG`` or ``--stop-tag TAG`` argument, or as:
.. code-block:: python
tags = exifread.process_file(f, stop_tag='TAG')
where ``TAG`` is a valid tag name, ex ``'DateTimeOriginal'``.
*The two above options are useful to speed up processing of large numbers of files.*
Strict Processing
=================
Return an error on invalid tags instead of silently ignoring.
Pass the ``-s`` or ``--strict`` argument, or as:
.. code-block:: python
tags = exifread.process_file(f, strict=True)
Usage Example
=============
This example shows how to use the library to correct the orientation of an image
(using Pillow for the transformation) before e.g. displaying it.
.. code-block:: python
import exifread
from PIL import Image
import logging
def _read_img_and_correct_exif_orientation(path):
im = Image.open(path)
tags = {}
with open(path, 'rb') as f:
tags = exifread.process_file(f, details=False)
if "Image Orientation" in tags.keys():
orientation = tags["Image Orientation"]
logging.basicConfig(level=logging.DEBUG)
logging.debug("Orientation: %s (%s)", orientation, orientation.values)
val = orientation.values
if 2 in val:
val += [4, 3]
if 5 in val:
val += [4, 6]
if 7 in val:
val += [4, 8]
if 3 in val:
logging.debug("Rotating by 180 degrees.")
im = im.transpose(Image.ROTATE_180)
if 4 in val:
logging.debug("Mirroring horizontally.")
im = im.transpose(Image.FLIP_TOP_BOTTOM)
if 6 in val:
logging.debug("Rotating by 270 degrees.")
im = im.transpose(Image.ROTATE_270)
if 8 in val:
logging.debug("Rotating by 90 degrees.")
im = im.transpose(Image.ROTATE_90)
return im
Credit
******
A huge thanks to all the contributors over the years!
Originally written by Gene Cash & Thierry Bousch.
|
