Skip to content
Read and modify exif in client-side or server-side JavaScript.
Branch: master
Clone or download
hMatoba Merge pull request #62 from pranksinatra/master
Throw Error objects instead of strings to preserve stack traces
Latest commit 6cabb8a Apr 2, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Remove sphinx theme files. Jul 1, 2018
samples Add GPS coordintes helper. May 20, 2017
tests Edit test. Mar 20, 2015
.gitattributes :octocat: Added .gitattributes Mar 17, 2015
.gitignore Fix adobe XMP matter. May 14, 2016
.npmignore Add Dockerfile. Sep 2, 2015
.travis.yml Edit .travis.yml Feb 17, 2018
Dockerfile Add Dockerfile. Sep 2, 2015
LICENSE.txt 1st. Mar 17, 2015
README.rst Make README more readable Oct 27, 2018
azure-pipelines.yml Update azure-pipelines.yml Sep 12, 2018
bower.json m Jan 23, 2016
nodetest.js m Aug 28, 2015
package.json m Apr 7, 2018
phestum.js Revert "Delete phestum.js" Aug 21, 2018
piexif.js Throw Error objects instead of strings to preserve Apr 1, 2019

README.rst

Piexifjs

https://travis-ci.org/hMatoba/piexifjs.svg?branch=master

Read and modify exif. Library to modify exif in JS(both client-side and Node.js). http://piexifjs.readthedocs.org/en/latest/index.html

Notice and Warning!

We are implementing v2.0. This version would include a few big changes. If you won't ready to use, don't update this library.

` npm install piexifjs@1.0.4 `

Thank you for using piexifjs!

How to Use

  • var exifObj = piexif.load(jpegData) - Get exif data as object. jpegData must be a string that starts with "data:image/jpeg;base64,"(DataURL), "\xff\xd8", or "Exif".
  • var exifStr = piexif.dump(exifObj) - Get exif as string to insert into JPEG.
  • piexif.insert(exifStr, jpegData) - Insert exif into JPEG. If jpegData is DataURL, returns JPEG as DataURL. Else if jpegData is binary as string, returns JPEG as binary as string.
  • piexif.remove(jpegData) - Remove exif from JPEG. If jpegData is DataURL, returns JPEG as DataURL. Else if jpegData is binary as string, returns JPEG as binary as string.

Use with File API or Canvas API.

Example

<input type="file" id="files" />
<script src="/js/piexif.js" />
<script>
function handleFileSelect(evt) {
    var file = evt.target.files[0];

    var zeroth = {};
    var exif = {};
    var gps = {};
    zeroth[piexif.ImageIFD.Make] = "Make";
    zeroth[piexif.ImageIFD.XResolution] = [777, 1];
    zeroth[piexif.ImageIFD.YResolution] = [777, 1];
    zeroth[piexif.ImageIFD.Software] = "Piexifjs";
    exif[piexif.ExifIFD.DateTimeOriginal] = "2010:10:10 10:10:10";
    exif[piexif.ExifIFD.LensMake] = "LensMake";
    exif[piexif.ExifIFD.Sharpness] = 777;
    exif[piexif.ExifIFD.LensSpecification] = [[1, 1], [1, 1], [1, 1], [1, 1]];
    gps[piexif.GPSIFD.GPSVersionID] = [7, 7, 7, 7];
    gps[piexif.GPSIFD.GPSDateStamp] = "1999:99:99 99:99:99";
    var exifObj = {"0th":zeroth, "Exif":exif, "GPS":gps};
    var exifStr = piexif.dump(exifObj);

    var reader = new FileReader();
    reader.onload = function(e) {
        var inserted = piexif.insert(exifStr, e.target.result);

        var image = new Image();
        image.src = inserted;
        image.width = 200;
        var el = $("<div></div>").append(image);
        $("#resized").prepend(el);

    };
    reader.readAsDataURL(file);
}

document.getElementById('files').addEventListener('change', handleFileSelect, false);
</script>

Dependency

No dependency. Piexifjs just needs standard JavaScript environment.

Environment

Both client-side and server-side. Standard browsers(Tested on IE11, Opera28, and PhantomJS) and Node.js.

Issues

Give me details. Environment, code, input, output. I can do nothing with abstract.

License

This software is released under the MIT License, see LICENSE.txt.

You can’t perform that action at this time.