Skip to main content
https://pypip.in/v/ExifRead/badge.png https://pypip.in/d/ExifRead/badge.png https://travis-ci.org/ianare/exif-py.png

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)

Source distribution for ExifRead 2.1.2
File Size Uploaded
ExifRead-2.1.2.tar.gz 33.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ExifRead 2.1.2
File Interpreter ABI Platform
ExifRead-2.1.2-py2-none-any.whl Python 2 none any Details

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

Release history Release notifications | RSS feed

3.5.1

2 release files

3.5.0

2 release files

3.4.0

2 release files

3.3.2

2 release files

3.3.1

2 release files

3.3.0

2 release files

3.2.0

2 release files

3.1.0

2 release files

3.0.0

2 release files

2.3.2

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.1

2 release files

This release

2.1.2 This release

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.4.2

1 release file

1.4.1

1 release file

1.4.0

1 release file

1.3.3

1 release file

1.3.2

1 release file

1.3.1

1 release file

1.3.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page