A simple wrapper around exiv2
Ruby C++
Failed to load latest commit information.
ext/exiv2 Allow compilation with Clang Dec 8, 2015
lib VERSION = "0.0.9" Dec 9, 2015
.gitignore Ignore vendor/ Dec 8, 2015
.rspec Output rspec in colour Feb 23, 2012
.travis.yml Test against 2.0 and 2.1 series Nov 19, 2014
Gemfile Use bundled environment in specs Feb 23, 2012
Gemfile.lock VERSION = "0.0.9" Dec 9, 2015
LICENSE Readme and license. Jan 24, 2011



Build Status

A simple wrapper around the C++ Exiv2 libary for reading and writing image metadata.

See http://www.exiv2.org/

Requires that the exiv2 C++ library is installed.


gem install exiv2

if you get errors with header could not be found below:

exiv2.cpp:1:10: fatal error: 'exiv2/image.hpp' file not found
#include "exiv2/image.hpp"

please explicitly declare the header path

gem install exiv2 -- --with-exiv2-include="${EXIV2_PREFIX}/include" --with-exiv2-lib="${EXIV2_PREFIX}/lib"

on OSX with Homebrew's exiv2, the EXIV2_PREFIX can be set:

export EXIV2_PREFIX=$(brew --prefix exiv2)

If you get this error while trying to install as part of a bundle install, you can set these paths using:

bundle config build.exiv2 --with-exiv2-include="${EXIV2_PREFIX}/include" --with-exiv2-lib="${EXIV2_PREFIX}/lib"

If you are on new version of Command Line Tool (that is newer than 6.2, and bump into following error:

/Library/Developer/CommandLineTools/usr/bin/../include/c++/v1/iterator:341:10: fatal error: '__debug' file not found
#include <__debug>

You can follow the quick hack by touching a new file /Library/Developer/CommandLineTools/usr/include/c++/v1/__debug with content:

#define _LIBCPP_ASSERT(...) ((void)0)

Once everything is successfully installed, you can give it a go:

require 'exiv2'
image = Exiv2::ImageFactory.open("image.jpg")
image.iptc_data.each do |key, value|
  puts "#{key} = #{value}\n"
image.exif_data.each { ... }
image.xmp_data.each { ... }

iptc_data_hash  = image.iptc_data.to_hash
xmp_data_hash   = image.xmp_data.to_hash


image.iptc_data["Iptc.Application2.Caption"] = "A New Caption"
image.iptc_data.add("Iptc.Application2.Keywords", "fishy")



None of the existing Ruby libraries for reading and writing image metadata did quite what we wanted, so we figured it wouldn't be too hard to wrap enough of Exiv2 to meet our needs.

The intention is to just mirror the Exiv2 API in Ruby, so the path to extending this to support more of Exiv2's functionality should be straightforward. Patches are welcome.


Tested on 1.9.3, 2.0.x and 2.1.x with Exiv2 0.24


  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.


In early development. Very little of Exiv2's API is supported, and it hasn't been heavily tested.


Pete Yandell, Mark Turnley, Lucas Parry, Norbert Wojtwoicz, Jan Graichen, John Barton


Copyright (c) 2014 Envato & Pete Yandell. See LICENSE for details.