Exiv2 is a native C++ extension for node.js that provides support for reading and writing image metadata via the Exiv2 library.
It was created by Damian Beresford
To build this addon you'll need the Exiv2 library and headers so if you're using a package manager you might need to install an additional "-dev" packages.
apt-get install pkg-config exiv2 libexiv2-dev
You'll also need to install pkg-config to help locate the library and headers.
port install pkgconfig exiv2
brew install pkg-config exiv2
pkg install pkgconf exiv2
pacman -S exiv2 pkgconf
Install pkg-config using Chocolatey:
choco install pkgconfiglite
Download latest msvc64 exiv2 build from the Exiv2 download page and extract to a folder of your choice.
Add a system variable named PKG_CONFIG_PATH and set it's value to EXIV2ROOTDIR\lib\pkgconfig replacing EXIV2ROOTDIR with the path where you extracted exiv2 from the step before (e.g. D:\src\exiv2msvs\lib\pkgconfig).
You'll also need windows-build-tools to compile this package.
For Electron apps, you'll want to copy exiv2.dll to the root directory of your Electron Windows build. You can automated this using the extraFiles option.
See the Exiv2 download page for more information.
- Node.js 18 or later
- Exiv2 library and development headers (see Dependencies above)
- pkg-config
Once the dependencies are in place, you can build and install the module using npm:
npm install @11ways/exiv2
You can verify that everything is installed and operating correctly by running the tests:
npm test
var ex = require('@11ways/exiv2');
ex.getImageTags('./photo.jpg', function(err, tags) {
console.log("DateTime: " + tags["Exif.Image.DateTime"]);
console.log("DateTimeOriginal: " + tags["Exif.Photo.DateTimeOriginal"]);
});
var fs = require('fs');
ex.getImageTags(fs.readFileSync('./photo.jpg'), function(err, tags) {
console.log("DateTime: " + tags["Exif.Image.DateTime"]);
console.log("DateTimeOriginal: " + tags["Exif.Photo.DateTimeOriginal"]);
});
var ex = require('@11ways/exiv2')
, fs = require('fs');
ex.getImagePreviews('./photo.jpg', function(err, previews) {
// Display information about the previews.
console.log(previews);
// Or you can save them--though you'll probably want to check the MIME
// type before picking an extension.
fs.writeFile('preview.jpg', previews[0].data);
});
var ex = require('@11ways/exiv2')
var newTags = {
"Exif.Photo.UserComment" : "Some Comment..",
"Exif.Canon.OwnerName" : "My Camera"
};
ex.setImageTags('./photo.jpg', newTags, function(err){
if (err) {
console.error(err);
} else {
console.log("setImageTags complete..");
}
});
var ex = require('@11ways/exiv2')
var tagsToDelete = ["Exif.Photo.UserComment", "Exif.Canon.OwnerName"];
ex.deleteImageTags('./photo.jpg', tagsToDelete, function(err){
if (err) {
console.error(err);
} else {
console.log("deleteImageTags complete..");
}
});
Take a look at the examples/ and test/ directories for more.
- Damian Beresford - Original creator
- Jelle De Loecker - Follow me on Github (
@skerit) and on Mastodon (🐦@skerit@elevenways.be)
See also the list of contributors who participated in this project.
@11ways/exiv2node is developed at Eleven Ways, a team of IAAP Certified Accessibility Specialists.
This project is licensed under the MIT License - see the LICENSE file for details.