https://github.com/lodev09/react-native-exify

Read and write Exif metadata from/into an image 🏷️
https://github.com/lodev09/react-native-exify

android exif exif-metadata ios react-native react-native-vision-camera

Last synced: 4 days ago
JSON representation

Read and write Exif metadata from/into an image 🏷️

• Host: GitHub
• URL: https://github.com/lodev09/react-native-exify
• Owner: lodev09
• License: mit
• Created: 2024-03-10T04:02:39.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-30T21:06:08.000Z (almost 2 years ago)
• Last Synced: 2025-08-23T17:57:27.577Z (6 months ago)
• Topics: android, exif, exif-metadata, ios, react-native, react-native-vision-camera
• Language: Kotlin
• Homepage:
• Size: 2.9 MB
• Stars: 40
• Watchers: 3
• Forks: 2
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# React Native Exify

[![CI](https://github.com/lodev09/react-native-exify/actions/workflows/ci.yml/badge.svg)](https://github.com/lodev09/react-native-exify/actions/workflows/ci.yml)

[![Maintainability](https://api.codeclimate.com/v1/badges/d15705025ef5d25f794f/maintainability)](https://codeclimate.com/github/lodev09/react-native-exify/maintainability)

![NPM Downloads](https://img.shields.io/npm/dw/%40lodev09%2Freact-native-exify)

A simple library to read and write image Exif metadata in React Native. Inspired from [this thread](https://github.com/mrousavy/react-native-vision-camera/issues/780).

## Features

* ✅ Read Exif data from an image

* ✅ Write Exif data into an image

* ✅ Tags are typed and standardized

* ✅ Works with Expo and bare React Native projects

## Installation

```sh

yarn add @lodev09/react-native-exify

```

## Usage

```ts

import { writeAsync, readAsync, ExifTags } from '@lodev09/react-native-exify';

```

### 🧐 Reading Exif

```ts

// ...

const uri = 'file://path/to/image.jpg'

const tags = await readAsync(uri)

console.log(tags)

```

### ✍️ Writing Exif

```ts

const uri = 'file://path/to/image.jpg'

const newTags: ExifTags = {

  GPSLatitude: 69.69,

  GPSLongitude: 69.69,

  UserComment: 'Someone wrote GPS here!',

}

const result = await writeAsync(uri, newTags)

console.log(result.tags)

```

> [!NOTE]

> On IOS, writing exif into an Asset file will duplicate the image. IOS does not allow writing exif into an Asset file directly.

> If you're getting the photo from a [camera](https://github.com/mrousavy/react-native-vision-camera/), write it into the output file first before saving to the Asset library!

See [example](example) for more detailed usage.

## Contributing

Contributions are welcome!

See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.