EXIF.py
Easy to use Python module to extract Exif metadata from tiff and jpeg files.
Originally written by Gene Cash & Thierry Bousch.
Installation
PyPI
The recommended process is to install the PyPI package, as it allows easily staying up to date:
$ pip install exifread
See the pip documentation for more info.
Archive
Download an archive from the project’s releases page.
Extract and enjoy.
Compatibility
EXIF.py is tested on the following Python versions:
2.6
2.7
3.2
3.3
3.4
Usage
Command line
Some examples:
$ EXIF.py image1.jpg $ EXIF.py image1.jpg image2.tiff $ find ~/Pictures -name "*.jpg" -name "*.tiff" | xargs EXIF.py
Show command line options:
$ EXIF.py
Python Script
import exifread # Open image file for reading (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:
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:
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:
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:
tags = exifread.process_file(f, strict=True)
Metadata
Release files for ExifRead 2.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ExifRead-2.1.2.tar.gz | 33.2 kB | Without provenance | Details for ExifRead-2.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ExifRead-2.1.2-py2-none-any.whl | Python 2 | none | any | Details for ExifRead-2.1.2-py2-none-any.whl |
Total release size: 81.1 kB
Release files / ExifRead-2.1.2.tar.gz
| Download URL | ExifRead-2.1.2.tar.gz |
|---|---|
| Size | 33.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
79e244f2eb466709029e8806fe5e2cdd557870c3db5f68954db0ef548d9320ad
|
|
BLAKE2b-256 checksum How to use checksums |
7bcb92b644626830115910cf2b36d3dfa600adbec86dff3207a7de3bfd6c6a60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / ExifRead-2.1.2-py2-none-any.whl
| Download URL | ExifRead-2.1.2-py2-none-any.whl |
|---|---|
| Size | 47.9 kB |
| Tags | Python 2 |
|
SHA-256 checksum How to use checksums |
4aa9d227db5c4cd65d87520076140a6f84e33363e08e649b87c7afec6bab60ab
|
|
BLAKE2b-256 checksum How to use checksums |
eb7db488697104d411c36fbe19a3b64d1219ef30aa0fa7640bad6381c6b0c4b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for ExifRead 2.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.