# kopparmora-xmp-reader

> Extracts basic XMP/RDF metadata from JPEG files

Latest version **1.1.4** (published 2019-06-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install kopparmora-xmp-reader
pnpm add kopparmora-xmp-reader
yarn add kopparmora-xmp-reader
bun add kopparmora-xmp-reader
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.4 |
| Published | 2019-06-11 |
| First published | 2018-03-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=8.0.0 |
| Dependencies | 1 |
| Unpacked size | 9.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Andreas Sehr |
| Maintainers | softbrixorg |
| Keywords | jpeg, jpg, xmp, rdf, picasa, metadata, rating |

## Links

- npm: https://www.npmjs.com/package/kopparmora-xmp-reader
- Repository: https://github.com/softbrix/xmp-reader
- Issues: https://github.com/softbrix/xmp-reader/issues
- npm.io page: https://npm.io/package/kopparmora-xmp-reader

## Dependencies (1)

- [sax](https://npm.io/package/sax.md) ^1.2.1

## Recent versions

- 1.1.4 (latest) — 2019-06-11
- 1.1.2 — 2019-02-20
- 1.1.1 — 2018-08-02
- 1.1.0 — 2018-08-02
- 1.0.2 — 2018-03-20
- 1.0.1 — 2018-03-15

## README

# xmp-reader  [![NPM version](https://badge.fury.io/js/kopparmora-xmp-reader.svg)](http://badge.fury.io/js/kopparmora-xmp-reader) [![Build Status](https://travis-ci.org/softbrix/kopparmora-xmp-reader.svg?branch=master)](https://travis-ci.org/softbrix/kopparmora-xmp-reader)
Extracts XMP/RDF metadata tags from JPEG files.
Does not pretend to be a complete metadata management tool, but allows you to extract information other EXIF-management tools on NPM fail to retrieve.
This package has been forked from [xmp-reader](https://github.com/shkuznetsov/xmp-reader) and has been modified to
include all metadata tags it finds in an image.

## Usage

To install the module add it to your project's ``package.json`` dependencies or install manually running:
```
npm install kopparmora-xmp-reader
```

Then pull it in your code:
```javascript
const xmpReader = require('kopparmora-xmp-reader');
```

Now you can either feed it a file name:
```javascript
xmpReader.fromFile('/path/to/file.jpg', (err, data) => {
  if (err) console.log(err);
  else console.log(data);
});
```

Or a buffer:
```javascript
xmpReader.fromBuffer(buffer, (err, data) => {
  if (err) console.log(err);
  else console.log(data);
});
```

Both methods above return a promise, you can use that instead of the ``callback``:
```javascript
xmpReader.fromBuffer(buffer).then(
  (data) => console.log(data),
  (err) => console.log(err)
);
```

Output will look something like that, depending on your metadata:
```javascript
{
	"raw": {
		"MicrosoftPhoto:Rating": "50",
		"dc:title": "Title",
		"dc:description": "Title",
		"dc:creator": "Alexander Kuznetsov",
		"Iptc4xmpCore:Location": "New York",
		"MicrosoftPhoto:LastKeywordXMP": ["tag1", "tag2"],
		"MicrosoftPhoto:LastKeywordIPTC": ["tag1", "tag2"],
		"xmp:Rating": "3"
	},
	"rating": 3,
	"title": "Title",
	"description": "Title",
	"creator": "Alexander Kuznetsov",
	"location": "New York",
	"keywords": ["tag1", "tag2"]
}
```
``raw`` property contains vendor-specific tag names.

## License
[MIT License](http://en.wikipedia.org/wiki/MIT_License)

---
_Source: https://npm.io/package/kopparmora-xmp-reader · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._