MetadataExtractor is a straightforward .NET library for reading metadata from image and movie files.
The easiest way to use this library is via its NuGet package:
PM> Install-Package MetadataExtractor
IEnumerable<Directory> directories = ImageMetadataReader.ReadMetadata(imagePath);The resulting directories sequence holds potentially many different directories of metadata, depending upon the input image.
To print out all values from all directories:
foreach (var directory in directories)
foreach (var tag in directory.Tags)
Console.WriteLine($"{directory.Name} - {tag.Name} = {tag.Description}");Producing:
Exif SubIFD - Exposure Time = 1/60 sec
Exif SubIFD - F-Number = f/8.0
...
Exif IFD0 - Make = NIKON CORPORATION
Exif IFD0 - Model = NIKON D70
...
IPTC - Credit = Drew Noakes
IPTC - City = London
...
Access a specific value, in this case the Exif DateTime tag:
var subIfdDirectory = directories.OfType<ExifSubIfdDirectory>().FirstOrDefault();
var dateTime = subIfdDirectory?.GetDescription(ExifDirectoryBase.TagDateTime);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
- WebP properties
- PNG properties
- BMP properties
- GIF properties
- ICO properties
- PCX properties
It will process files of type:
- JPEG
- TIFF
- WebP
- PSD
- PNG
- BMP
- GIF
- ICO
- PCX
- Camera Raw
- NEF (Nikon)
- CR2 (Canon)
- ORF (Olympus)
- ARW (Sony)
- RW2 (Panasonic)
- RWL (Leica)
- SRW (Samsung)
Camera-specific "makernote" data is decoded for cameras manufactured by:
- Agfa
- Apple
- Canon
- Casio
- Epson
- Fujifilm
- Kodak
- Kyocera
- Leica
- Minolta
- Nikon
- Olympus
- Panasonic
- Pentax
- Sanyo
- Sigma/Foveon
- Sony
Multiple target frameworks are supported via the single NuGet package. This allows supports Xamarin for Android and iOS, as well as:
- .NET Framework 3.5
- .NET Framework 4.5
- .NET Framework 4.5 (Portable)
- Silverlight 5.0
- Windows 8.0
- Windows Phone 8.1
- Windows Phone Silverlight 8.0
Note that the PCL version does not support file-system metadata due to restricted IO APIs.
The metadata-extractor-dev Google Group is for discussion about the development of the library and questions about its usage.
Have questions or ideas? Try the mailing list or open an issue. GitHub's issue tracker accepts attachments, and sample images are often crucial in debugging problems.
If you want to get your hands dirty, clone this repository, enhance the library and submit a pull request. Review the issue list and ask around on the mailing list to avoid duplication of work.
An easier way to help is to contribute to the sample image file library used for research and testing.
This library is developed by Drew Noakes and contributors.
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.
This library was originally written in Java in 2002. In 2014, Yakov Danilov (for Imazen LLC) converted the code to C# using Sharpen. Both projects are now developed in unison and aim to be functionally equivalent.
Copyright 2002-2016 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.0Unless 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: