@modernized/jpeg-exif

Get exif information from JPEG files. Works with TIFF too.

Fork notice. This is a maintained fork of jpeg-exif (zhso/jpeg-exif), which is deprecated on npm and whose GitHub repository has been removed. The public API (parse, parseSync, fromBuffer) is fully compatible — you should be able to swap jpeg-exif for @modernized/jpeg-exif without any code changes. Maintained at modernized-js/jpeg-exif.

What's new in the fork: TypeScript source with bundled .d.ts, dual ESM + CJS publish, a Promise-returning parsePromise(), modern toolchain (Node ≥ 22, node:test, ESLint 10, Prettier), and CI on Linux / macOS / Windows × Node 22 / 24.

Installation

yarn add @modernized/jpeg-exif
# or
npm i @modernized/jpeg-exif

Usage

Async (callback)

import exif from '@modernized/jpeg-exif';

const filePath = '~/Photo/IMG_0001.JPG';

exif.parse(filePath, (err, data) => {
  if (err) {
    console.log(err);
  } else {
    console.log(data);
  }
});

Async (Promise)

import { parsePromise } from '@modernized/jpeg-exif';

const filePath = '~/Photo/IMG_0001.JPG';
const data = await parsePromise(filePath);

console.log(data);

Sync

import exif from '@modernized/jpeg-exif';

const filePath = '~/Photo/IMG_0001.JPG';
const data = exif.parseSync(filePath);

console.log(data);

From Buffer

import fs from 'node:fs';
import exif from '@modernized/jpeg-exif';

const filePath = '~/Documents/DOC_0001.TIFF';
const buffer = fs.readFileSync(filePath);
const data = exif.fromBuffer(buffer);

console.log(data);

Features

• Supports all CP3451 Standard Tags (including GPS & SubExif tags)
• Sync and async APIs
• Accepts a Buffer directly

Returned Data Shape

{
    "Make": "Apple",
    "Model": "Apple",
    //...
    "SubExif": [
        "DateTimeOriginal": "2015:10:06 17:19:36",
        "CreateDate": "2015:10:06 17:19:36",
        //...
    ],
    "GPSInfo": [
        "GPSLatitudeRef": "N",
        "GPSLatitude": [ 35, 39, 40.08 ],
        //...
    ]
}

License

MIT — original work © zhso. Fork modifications © contributors. See LICENSE.txt.