Extracts Exif, IPTC, XMP, ICC and other metadata from image and movie files
Clone or download
Permalink
Failed to load latest commit information.
MetadataExtractor.Benchmarks Update BenchmarkDotNet packages Feb 8, 2018
MetadataExtractor.PowerShell Update JetBrains.Annotations package Feb 8, 2018
MetadataExtractor.Samples Disable warning in sample code Feb 8, 2018
MetadataExtractor.Tests Address xUnit compiler warnings Feb 8, 2018
MetadataExtractor.Tools.FileProcessor Log sum of stream positions after extraction Feb 8, 2018
MetadataExtractor.Tools.JpegSegmentExtractor Update JetBrains.Annotations package Feb 8, 2018
MetadataExtractor Add GPS Horizontal Positioning Error tag (#133) Aug 4, 2018
docs Add and use SVG version of project logo. Nov 25, 2015
wiki @ 4fb4bdd Bump wiki pointer Dec 14, 2017
wiki-images @ 637fc76 Add wikis as submodules and solution items Jun 20, 2017
.gitattributes Add .gitattributes. Sanitise EOL whitespace and line endings. Jun 8, 2015
.gitignore No longer ignore old project.lock.json files Mar 17, 2017
.gitmodules Add wikis as submodules and solution items Jun 20, 2017
Build.ps1 Formatting May 13, 2017
CONTRIBUTING.md Update CONTRIBUTING.md Feb 17, 2018
LICENSE Bump copyright year. Jan 7, 2017
MetadataExtractor.sln Nothing is changed. Just open the project in MS VS 2017. Dec 25, 2017
MetadataExtractor.sln.DotSettings Update DotSettings Feb 7, 2018
MetadataExtractor.snk Add signed version that use conditional compilation. Mar 17, 2017
README.md Add DJI makernote and netstandard2.0 to README Feb 8, 2018
appveyor.yml Upgrade to VS2017 Mar 17, 2017

README.md

metadata-extractor logo

Build status MetadataExtractor NuGet version MetadataExtractor NuGet pre-release version

MetadataExtractor is a straightforward .NET library for reading metadata from image and movie files.

Installation

The easiest way to use this library is via its NuGet package:

PM> Install-Package MetadataExtractor

Alternatively, search for MetadataExtractor in the Visual Studio NuGet Package Manager.

Usage

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);

Features

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

It will process files of type:

  • JPEG
  • TIFF
  • WebP
  • PSD
  • PNG
  • BMP
  • GIF
  • ICO
  • PCX
  • Netpbm
  • 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
  • DJI
  • Epson
  • Fujifilm
  • Kodak
  • Kyocera
  • Leica
  • Minolta
  • Nikon
  • Olympus
  • Panasonic
  • Pentax
  • Reconyx
  • Sanyo
  • Sigma/Foveon
  • Sony

Supported Frameworks

This library targets:

  • .NET Framework 3.5 (net35)
  • .NET Framework 4.5 (net45)
  • .NET Standard 1.3 (netstandard1.3)
  • .NET Standard 2.0 (netstandard2.0)

All target frameworks are provided via the one NuGet package.

net35 and net45 target the full .NET Framework. net45 uses the newer IReadOnlyList<> on some public APIs where net35 uses IList<>. Internally net45 also uses some newer library features for slightly improved performance.

netstandard1.3 implements version 1.3 of the .NET Standard which covers .NET Core, Mono, Xamarin platforms, UWP, and future platforms.

A PCL build was supported until version 1.5.3 which supported Silverlight 5.0, Windows 8.0, Windows Phone 8.1 and Windows Phone Silverlight 8.0. PCL versions did not support file-system metadata due to restricted IO APIs.

Questions & Feedback

The quickest way to have your questions answered is via Stack Overflow. Check whether your question has already been asked, and if not, ask a new one tagged with both metadata-extractor and .net.

Bugs and feature requests should be provided via the project's issue tracker. Please attach sample images where possible as most issues cannot be investigated without an image.

Contributing

If you want to get your hands dirty, making a pull request is a great way to enhance the library. In general it's best to create an issue first that captures the problem you want to address. You can discuss your proposed solution in that issue. This gives others a chance to provide feedback before you spend your valuable time working on it.

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

Credits

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. The code has subsequently been edited to provide a more idiomatic .NET API. Both projects are now developed in unison and aim to be functionally equivalent.

Other languages

  • Java metadata-extractor is the original implementation of this project, from which this .NET version was ported
  • PHP php-metadata-extractor wraps the Java project, making it available to users of PHP

More information about this project is available at: