metadata-extractor is a straightforward Java library for reading metadata from image files.

Metadata metadata = ImageMetadataReader.readMetadata(imagePath);

With that metadata object, you can iterate or query the various tag values that were read from the image.

The library understands several formats of metadata, many of which may be present in a single image:

• Exif
• IPTC
• XMP
• JFIF / JFXX
• ICC Profiles
• Photoshop fields
• PNG properties
• BMP properties
• GIF properties

It will process files of type:

• JPEG
• TIFF
• PSD
• PNG
• BMP
• GIF
• Camera Raw (NEF/CR2/ORF/ARW/RW2/...)

Special camera-specific data is decoded for most cameras manufactured by:

• Agfa
• Canon
• Casio
• Epson
• Fujifilm
• Kodak
• Kyocera
• Leica
• Minolta
• Nikon
• Olympus
• Panasonic
• Pentax
• Sanyo
• Sigma/Foveon
• Sony

Read getting started for an introduction to the basics of using this library.

Three mailing lists exist:

• metadata-extractor-announce for read-only announcements of new releases
• metadata-extractor-dev for discussion about development and notifications of changes to issues and source code
• metadata-extractor-changes for automated emails when code, issues or the wiki are changed

This library is developed by Drew Noakes.

Thanks are due to the many users who sent in suggestions, bug reports, sample images from their cameras as well as encouragement. Wherever possible, they have been credited in the source code and commit logs.

Have questions or ideas? Try the mailing list.

Found a bug or have a patch? Search the issue list and if it isn't already there, create it.

The easiest way to help is to contribute to the sample image file library used for research and testing.

If you want to get your hands dirty, clone this repository, enhance the library and let us know to pull from your clone. Ask around on the mailing list to avoid duplication of work.

Copyright 2002-2014 Drew Noakes

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

More information about this project is available at:

• https://drewnoakes.com/code/exif/
• https://github.com/drewnoakes/metadata-extractor/