{"_id":"@capawesome/capacitor-exif","_rev":"4-8c12dc34489fdaf950d077d12f60f59d","name":"@capawesome/capacitor-exif","dist-tags":{"latest":"0.1.2"},"versions":{"0.0.1":{"name":"@capawesome/capacitor-exif","version":"0.0.1","keywords":["capacitor","plugin","native","exif","metadata","gps","privacy","heic","jpeg"],"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","_id":"@capawesome/capacitor-exif@0.0.1","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"homepage":"https://capawesome.io/docs/sdks/capacitor/exif/","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"88bd8e3576508212e407f0b1cad4b9bfa488f405","tarball":"https://registry.npmjs.org/@capawesome/capacitor-exif/-/capacitor-exif-0.0.1.tgz","fileCount":43,"integrity":"sha512-0VuijU7KntbQCPTK1FDfCQEuAs6zPWQOctDIcBWtiNz8tmqvZsPiQMPBgTjPd6czpoFGgOkJMX+FAZHOLoC5Mg==","signatures":[{"sig":"MEUCIQCh8cCPpNY3MLMEk0+uoGFDFDyadFucJ5K3X0kTJofeYgIgIsF6JbBC/L6oV4dbQv0z9XQN2RhajiMWcoiuFi96w74=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":126955},"main":"dist/plugin.cjs.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"a8c9e0f3c4687c6a9f4fc7554f3dc79536ad5154","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api ExifPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"_npmUser":{"name":"robingenz","email":"mail@robingenz.dev"},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.13.0","description":"Capacitor plugin to read, write and remove EXIF metadata from image files.","directories":{},"_nodeVersion":"24.16.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.53.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.0.0","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.6.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/capacitor-exif_0.0.1_1783449352783_0.6261935377200714","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@capawesome/capacitor-exif","version":"0.1.0","keywords":["capacitor","plugin","native","capacitor-plugin","exif","metadata","gps","privacy","heic","jpeg","exif metadata","image metadata","photo metadata","exif reader","exif editor","remove exif","strip metadata","geotag"],"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","_id":"@capawesome/capacitor-exif@0.1.0","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"homepage":"https://capawesome.io/docs/sdks/capacitor/exif/","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"beb91edecfd809eaf47345124871c20848015233","tarball":"https://registry.npmjs.org/@capawesome/capacitor-exif/-/capacitor-exif-0.1.0.tgz","fileCount":43,"integrity":"sha512-xBbVzXvTGyFr+vTuOgsXr8b7lTDfLIgTRkh1BnzFbMbuS6v4RC76XY56FFNh8YeDsfUI1T/Op0OFHvnA1d/xow==","signatures":[{"sig":"MEUCIQCvAXBAqopZyjNh6wlsZlzzGKp8EBAccPvE4nrvsJg0dQIgKRzLv+zbCnablf9r7GjogS2ZHB6k5LNZGjsSn2JkuXE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@capawesome%2fcapacitor-exif@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":131777},"main":"dist/plugin.cjs.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"1ce17b1fd14c43b2f1d5d3c2da82221e1d1dca37","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api ExifPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7982153e-0214-4a9e-b1a2-0e8108d65145"}},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.16.0","description":"Capacitor plugin to read, write and remove EXIF metadata from image files on Android and iOS.","directories":{},"_nodeVersion":"24.18.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.53.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.0.0","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.6.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/capacitor-exif_0.1.0_1784015518144_0.3249978258235817","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@capawesome/capacitor-exif","version":"0.1.1","keywords":["capacitor","plugin","native","capacitor-plugin","exif","metadata","gps","privacy","heic","jpeg","exif metadata","image metadata","photo metadata","exif reader","exif editor","remove exif","strip metadata","geotag"],"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","_id":"@capawesome/capacitor-exif@0.1.1","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"homepage":"https://capawesome.io/docs/sdks/capacitor/exif/","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"cc361da20af9c7f0d9de73b4a0e8593635356548","tarball":"https://registry.npmjs.org/@capawesome/capacitor-exif/-/capacitor-exif-0.1.1.tgz","fileCount":43,"integrity":"sha512-PtKEw/jFfmx9BEGGI4hg6+gK6DkGyvW+Qx35y97wgCpWduDnntGViEWuzqKVGqKAu2xxtZMeluSQlXKyTa3e2w==","signatures":[{"sig":"MEYCIQCxnjlA0zNDEV9kL3lE56X/DtAmk/GhTgjyHGdzo3zxiwIhAOzOYC6GuTLRcESVtT6Um7II62Vo97Pfe7sclzLNyM1i","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@capawesome%2fcapacitor-exif@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":131786},"main":"dist/plugin.cjs.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"3e61f4b412f9f3f512c21169bb135bbb23a67e6d","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api ExifPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7982153e-0214-4a9e-b1a2-0e8108d65145"}},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.16.0","description":"Capacitor plugin to read, write and remove EXIF metadata from image files on Android and iOS.","directories":{},"_nodeVersion":"24.18.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.53.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.0.0","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.6.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/capacitor-exif_0.1.1_1784102970823_0.3103855399604303","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"_id":"@capawesome/capacitor-exif@0.1.2","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"0e5183b76f964accb697826ec9a655da04cd14b9","tarball":"https://registry.npmjs.org/@capawesome/capacitor-exif/-/capacitor-exif-0.1.2.tgz","fileCount":43,"integrity":"sha512-1MkrS0tDbNlhVeIQ8uHxU3bDLP25F6ukFKV43EFLXCkOiMdslyTX2rB+LfEGJxiliWfjIljAsQ0Z56xHgdWodw==","signatures":[{"sig":"MEUCIQDV3VFl9K77FRs+VyhY/hDxONX2S8rR7CPbxnLjcHjibQIgYEzdrE0LGR8fCuR/y/gzNyWK8w7LfiksFUYx3xXYUQo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIH3uuIuz5Kr66irSrNDhSkfUTGlgQ3PZSTtOgz1+zQHQAiEAvXedS+huB7VIDJh/zRdTTWLGBkey2Ekl6I4FxzxyjM4="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@capawesome%2fcapacitor-exif@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":131648},"main":"dist/plugin.cjs.js","name":"@capawesome/capacitor-exif","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"7c1937ed10b7de86ca2c1cdc3539a2735fd69a00","license":"MIT","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api ExifPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"version":"0.1.2","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7982153e-0214-4a9e-b1a2-0e8108d65145"}},"homepage":"https://capawesome.io/docs/sdks/capacitor/exif/","keywords":["capacitor","plugin","native","capacitor-plugin","exif","metadata","gps","privacy","heic","jpeg","exif metadata","image metadata","photo metadata","exif reader","exif editor","remove exif","strip metadata","geotag"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.17.0","description":"Capacitor plugin to read, write and remove EXIF metadata from image files on Android and iOS.","directories":{},"maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"_nodeVersion":"24.19.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.62.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.4.2","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.9.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/capacitor-exif_0.1.2_1788337427617_0.8993040687657183"}}},"time":{"created":"2026-07-07T18:35:52.524Z","modified":"2026-09-02T08:23:48.076Z","0.0.1":"2026-07-07T18:35:52.934Z","0.1.0":"2026-07-14T07:51:58.274Z","0.1.1":"2026-07-15T08:09:30.961Z","0.1.2":"2026-09-02T08:23:47.702Z"},"bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","homepage":"https://capawesome.io/docs/sdks/capacitor/exif/","keywords":["capacitor","plugin","native","capacitor-plugin","exif","metadata","gps","privacy","heic","jpeg","exif metadata","image metadata","photo metadata","exif reader","exif editor","remove exif","strip metadata","geotag"],"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"description":"Capacitor plugin to read, write and remove EXIF metadata from image files on Android and iOS.","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"readme":"# Capacitor Exif Plugin\n\nCapacitor plugin to read, write and remove EXIF metadata from image files.\n\n<div class=\"capawesome-z29o10a\">\n  <a href=\"https://cloud.capawesome.io/\" target=\"_blank\">\n    <img alt=\"Deliver Live Updates to your Capacitor app with Capawesome Cloud\" src=\"https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1\" />\n  </a>\n</div>\n\n## Features\n\n- 📖 **Read**: Read typed EXIF tags like GPS position, camera model, and capture date.\n- ✍️ **Write**: Update EXIF tags in place without touching the rest of the file.\n- 🕵️ **Privacy**: Strip GPS positions and other sensitive metadata before uploading images.\n- 💎 **Lossless**: The pixel data is never re-encoded, so the image quality is not affected.\n- 🖼️ **HEIC support**: Read and write HEIC metadata natively, which JavaScript libraries can not do.\n- ⚡ **Native performance**: Files are processed natively and never loaded into the WebView memory.\n- 🔒 **App Store safe**: Uses only official platform APIs.\n- 🤝 **Compatibility**: Works alongside the [File Picker](https://capawesome.io/docs/sdks/capacitor/file-picker/), [File Compressor](https://capawesome.io/docs/sdks/capacitor/file-compressor/) and [Photo Editor](https://capawesome.io/docs/sdks/capacitor/photo-editor/) plugins.\n- 📦 **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS.\n- 🔁 **Up-to-date**: Always supports the latest Capacitor version.\n\nMissing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!\n\n## Use Cases\n\nThe Exif plugin is typically used whenever an app needs to work with photo metadata, for example:\n\n- **Privacy protection**: Strip GPS positions and other sensitive metadata from photos before uploading them to a server.\n- **Photo organization**: Read the capture date and GPS position to sort and group photos.\n- **Metadata correction**: Fix a wrong capture date or add a missing GPS position without re-encoding the image.\n- **Camera details**: Display camera and lens information such as ISO, aperture, and exposure time in a photo detail view.\n\n## Compatibility\n\n| Plugin Version | Capacitor Version | Status         |\n| -------------- | ----------------- | -------------- |\n| 0.x.x          | >=8.x.x           | Active support |\n\n## Installation\n\nYou can use our **AI-Assisted Setup** to install the plugin.\nAdd the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:\n\n```bash\nnpx skills add capawesome-team/skills --skill capacitor-plugins\n```\n\nThen use the following prompt:\n\n```\n Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-exif` plugin in my project.\n```\n\nIf you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:\n\n```bash\nnpm install @capawesome/capacitor-exif\nnpx cap sync\n```\n\n### Android\n\n#### Variables\n\nThis plugin will use the following project variables (defined in your app’s `variables.gradle` file):\n\n- `$androidxExifInterfaceVersion` version of `androidx.exifinterface:exifinterface` (default: `1.4.2`)\n\n### iOS\n\nNo additional configuration is required for this plugin.\n\n## Configuration\n\nNo configuration required for this plugin.\n\n## Usage\n\nThe following examples show how to read the EXIF metadata of an image, write EXIF tags to an image, and remove the EXIF metadata from an image.\n\n### Read the EXIF metadata of an image\n\nRead typed EXIF tags such as the GPS position, camera model, and capture date from an image file. Only available on Android and iOS:\n\n```typescript\nimport { Exif } from '@capawesome/capacitor-exif';\n\nconst readExif = async () => {\n  const { tags } = await Exif.readExif({\n    path: 'file:///path/to/photo.jpg',\n  });\n  console.log('GPS position:', tags.gpsLatitude, tags.gpsLongitude);\n};\n```\n\n### Write EXIF tags to an image\n\nUpdate EXIF tags in place. Only the provided tags are updated and the pixel data is never re-encoded. Only available on Android and iOS:\n\n```typescript\nimport { Exif } from '@capawesome/capacitor-exif';\n\nconst writeExif = async () => {\n  await Exif.writeExif({\n    path: 'file:///path/to/photo.jpg',\n    tags: {\n      dateTimeOriginal: '2026:01:15 10:30:00',\n      gpsLatitude: 51.503364,\n      gpsLongitude: -0.127625,\n    },\n  });\n};\n```\n\n### Remove the EXIF metadata from an image\n\nStrip all EXIF metadata from an image file in place, for example to protect the privacy of your users before an upload. By default, the orientation tag is kept so that the image is not suddenly displayed rotated. Only available on Android and iOS:\n\n```typescript\nimport { Exif } from '@capawesome/capacitor-exif';\n\nconst removeExif = async () => {\n  await Exif.removeExif({\n    path: 'file:///path/to/photo.jpg',\n  });\n};\n```\n\n## API\n\n<docgen-index>\n\n* [`readExif(...)`](#readexif)\n* [`removeExif(...)`](#removeexif)\n* [`writeExif(...)`](#writeexif)\n* [Interfaces](#interfaces)\n\n</docgen-index>\n\n<docgen-api>\n<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->\n\n### readExif(...)\n\n```typescript\nreadExif(options: ReadExifOptions) => Promise<ReadExifResult>\n```\n\nRead the EXIF metadata of an image file.\n\nOnly available on Android and iOS.\n\n| Param         | Type                                                        |\n| ------------- | ----------------------------------------------------------- |\n| **`options`** | <code><a href=\"#readexifoptions\">ReadExifOptions</a></code> |\n\n**Returns:** <code>Promise&lt;<a href=\"#readexifresult\">ReadExifResult</a>&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### removeExif(...)\n\n```typescript\nremoveExif(options: RemoveExifOptions) => Promise<void>\n```\n\nRemove the EXIF metadata from an image file in place.\n\nThe pixel data is never re-encoded, so the image quality\nis not affected.\n\nOnly available on Android and iOS.\n\n| Param         | Type                                                            |\n| ------------- | --------------------------------------------------------------- |\n| **`options`** | <code><a href=\"#removeexifoptions\">RemoveExifOptions</a></code> |\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### writeExif(...)\n\n```typescript\nwriteExif(options: WriteExifOptions) => Promise<void>\n```\n\nWrite EXIF metadata to an image file in place.\n\nOnly the provided tags are updated. All other tags remain unchanged.\nThe pixel data is never re-encoded, so the image quality\nis not affected.\n\nOnly available on Android and iOS.\n\n| Param         | Type                                                          |\n| ------------- | ------------------------------------------------------------- |\n| **`options`** | <code><a href=\"#writeexifoptions\">WriteExifOptions</a></code> |\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### Interfaces\n\n\n#### ReadExifResult\n\n| Prop       | Type                                          | Description                                       | Since |\n| ---------- | --------------------------------------------- | ------------------------------------------------- | ----- |\n| **`tags`** | <code><a href=\"#exiftags\">ExifTags</a></code> | The EXIF tags that were read from the image file. | 0.1.0 |\n\n\n#### ExifTags\n\nThe EXIF tags of an image file.\n\nEvery property is optional and only present if the tag\nexists in the file.\n\n| Prop                   | Type                 | Description                                                                                                        | Since |\n| ---------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------ | ----- |\n| **`dateTimeOriginal`** | <code>string</code>  | The date and time when the image was originally captured in the EXIF date format `YYYY:MM:DD HH:MM:SS`.            | 0.1.0 |\n| **`exposureTime`**     | <code>number</code>  | The exposure time in seconds.                                                                                      | 0.1.0 |\n| **`fNumber`**          | <code>number</code>  | The F number (aperture) of the lens.                                                                               | 0.1.0 |\n| **`flash`**            | <code>boolean</code> | Whether or not the flash fired when the image was captured.                                                        | 0.1.0 |\n| **`focalLength`**      | <code>number</code>  | The focal length of the lens in millimeters.                                                                       | 0.1.0 |\n| **`gpsAltitude`**      | <code>number</code>  | The altitude in meters above (positive) or below (negative) sea level.                                             | 0.1.0 |\n| **`gpsLatitude`**      | <code>number</code>  | The latitude in signed decimal degrees. Positive values are north of the equator, negative values are south.       | 0.1.0 |\n| **`gpsLongitude`**     | <code>number</code>  | The longitude in signed decimal degrees. Positive values are east of the prime meridian, negative values are west. | 0.1.0 |\n| **`iso`**              | <code>number</code>  | The ISO speed rating (photographic sensitivity).                                                                   | 0.1.0 |\n| **`lensModel`**        | <code>string</code>  | The model of the lens.                                                                                             | 0.1.0 |\n| **`make`**             | <code>string</code>  | The manufacturer of the camera.                                                                                    | 0.1.0 |\n| **`model`**            | <code>string</code>  | The model of the camera.                                                                                           | 0.1.0 |\n| **`orientation`**      | <code>number</code>  | The orientation of the image as defined by the EXIF specification (1-8).                                           | 0.1.0 |\n| **`pixelHeight`**      | <code>number</code>  | The height of the image in pixels.                                                                                 | 0.1.0 |\n| **`pixelWidth`**       | <code>number</code>  | The width of the image in pixels.                                                                                  | 0.1.0 |\n| **`software`**         | <code>string</code>  | The name of the software that was used to create or edit the image.                                                | 0.1.0 |\n\n\n#### ReadExifOptions\n\n| Prop       | Type                | Description                                                                                                   | Since |\n| ---------- | ------------------- | ------------------------------------------------------------------------------------------------------------- | ----- |\n| **`path`** | <code>string</code> | The path to the image file to read the EXIF metadata from. Local file paths and `file://` URIs are supported. | 0.1.0 |\n\n\n#### RemoveExifOptions\n\n| Prop                  | Type                 | Description                                                                                                                                                                                   | Default           | Since |\n| --------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ----- |\n| **`keepOrientation`** | <code>boolean</code> | Whether or not to keep the orientation tag when removing the EXIF metadata. This is enabled by default so that images are not suddenly displayed rotated after the metadata has been removed. | <code>true</code> | 0.1.0 |\n| **`path`**            | <code>string</code>  | The path to the image file to remove the EXIF metadata from. Local file paths and `file://` URIs are supported.                                                                               |                   | 0.1.0 |\n\n\n#### WriteExifOptions\n\n| Prop       | Type                                                          | Description                                                                                                    | Since |\n| ---------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ----- |\n| **`path`** | <code>string</code>                                           | The path to the image file to write the EXIF metadata to. Local file paths and `file://` URIs are supported.   | 0.1.0 |\n| **`tags`** | <code><a href=\"#writableexiftags\">WritableExifTags</a></code> | The EXIF tags to write to the image file. Only the provided tags are updated. All other tags remain unchanged. | 0.1.0 |\n\n\n#### WritableExifTags\n\nThe writable subset of the EXIF tags.\n\n| Prop                   | Type                 | Description                                                                                                                                                      | Since |\n| ---------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |\n| **`dateTimeOriginal`** | <code>string</code>  | The date and time when the image was originally captured in the EXIF date format `YYYY:MM:DD HH:MM:SS`.                                                          | 0.1.0 |\n| **`exposureTime`**     | <code>number</code>  | The exposure time in seconds.                                                                                                                                    | 0.1.0 |\n| **`fNumber`**          | <code>number</code>  | The F number (aperture) of the lens.                                                                                                                             | 0.1.0 |\n| **`flash`**            | <code>boolean</code> | Whether or not the flash fired when the image was captured.                                                                                                      | 0.1.0 |\n| **`focalLength`**      | <code>number</code>  | The focal length of the lens in millimeters.                                                                                                                     | 0.1.0 |\n| **`gpsAltitude`**      | <code>number</code>  | The altitude in meters above (positive) or below (negative) sea level.                                                                                           | 0.1.0 |\n| **`gpsLatitude`**      | <code>number</code>  | The latitude in signed decimal degrees. Positive values are north of the equator, negative values are south. Must be provided together with `gpsLongitude`.      | 0.1.0 |\n| **`gpsLongitude`**     | <code>number</code>  | The longitude in signed decimal degrees. Positive values are east of the prime meridian, negative values are west. Must be provided together with `gpsLatitude`. | 0.1.0 |\n| **`iso`**              | <code>number</code>  | The ISO speed rating (photographic sensitivity).                                                                                                                 | 0.1.0 |\n| **`lensModel`**        | <code>string</code>  | The model of the lens.                                                                                                                                           | 0.1.0 |\n| **`make`**             | <code>string</code>  | The manufacturer of the camera.                                                                                                                                  | 0.1.0 |\n| **`model`**            | <code>string</code>  | The model of the camera.                                                                                                                                         | 0.1.0 |\n| **`orientation`**      | <code>number</code>  | The orientation of the image as defined by the EXIF specification (1-8).                                                                                         | 0.1.0 |\n| **`software`**         | <code>string</code>  | The name of the software that was used to create or edit the image.                                                                                              | 0.1.0 |\n\n</docgen-api>\n\n## Format Support\n\nThe plugin can read EXIF metadata from any image format that the platform supports.\nWriting and removing EXIF metadata is a lossless in-place operation that is only supported for the following formats:\n\n| Format    | Read (Android) | Read (iOS) | Write & Remove (Android) | Write & Remove (iOS) |\n| --------- | -------------- | ---------- | ------------------------ | -------------------- |\n| JPEG      | ✅             | ✅         | ✅                       | ✅                   |\n| PNG       | ✅             | ✅         | ✅                       | ❌                   |\n| WebP      | ✅             | ✅         | ✅                       | ❌                   |\n| HEIC/HEIF | ✅             | ✅         | ❌                       | ✅                   |\n| DNG/RAW   | ✅             | ✅         | ❌                       | ❌                   |\n\nCalling `writeExif(...)` or `removeExif(...)` with an unsupported format rejects with the `UNSUPPORTED_FORMAT` error code.\n\n## Lossless Metadata Writes\n\nA metadata plugin that degrades the image quality is broken.\nThis plugin therefore guarantees that the pixel data is never decoded or re-encoded:\n\n- On **Android**, the [`ExifInterface`](https://developer.android.com/reference/androidx/exifinterface/media/ExifInterface) library rewrites only the metadata segments of the file in place.\n- On **iOS**, the [`CGImageDestinationCopyImageSource`](https://developer.apple.com/documentation/imageio/cgimagedestinationcopyimagesource(_:_:_:_:)) API copies the compressed image data unchanged and only replaces the metadata.\n\n## Privacy: Strip Metadata Before Upload\n\nImages taken with a smartphone usually contain the exact GPS position, the device model, and the capture date.\nTo protect the privacy of your users, remove this metadata before uploading images to a server:\n\n```typescript\nimport { Exif } from '@capawesome/capacitor-exif';\n\nconst prepareUpload = async (path: string) => {\n  // Remove the GPS position and all other EXIF metadata.\n  // The orientation is kept so that the image is not displayed rotated.\n  await Exif.removeExif({ path });\n};\n```\n\n## Limitations\n\n### Android\n\n- Vendor-specific maker notes and other unknown tags may survive `removeExif(...)` since the `ExifInterface` library can only remove known tags.\n\n### iOS\n\n- HEIC files store the orientation at the container level, so the `orientation` tag can not be changed and is always kept, even with `keepOrientation` set to `false`.\n- HEIC files may keep the `software` and `dateTimeOriginal` tags after `removeExif(...)`. GPS data and device identity tags (`make`, `model`, `lensModel`) are always removed.\n\n## FAQ\n\n### How is this plugin different from other similar plugins?\n\nIt reads, writes and removes EXIF metadata directly on the image file on Android and iOS, updating tags in place so the pixel data is never re-encoded and the image quality is untouched. It reads and writes HEIC metadata natively, processes files natively without loading them into WebView memory, and uses only official platform APIs, so it stays App Store safe. The API is fully typed, ships for both CocoaPods and Swift Package Manager, and is kept current with the latest Capacitor version.\n\n### Which platforms are supported by this plugin?\n\nThe plugin supports Android and iOS. All methods (`readExif`, `writeExif` and `removeExif`) are only available on these two platforms, since the files are processed natively and never loaded into the WebView memory.\n\n### Does writing or removing EXIF metadata affect the image quality?\n\nNo. Writing and removing EXIF metadata is a lossless in-place operation. The pixel data is never decoded or re-encoded, so the image quality is not affected. See [Lossless Metadata Writes](#lossless-metadata-writes) for details on how this is implemented on each platform.\n\n### Which image formats are supported?\n\nReading EXIF metadata works with any image format that the platform supports, including JPEG, PNG, WebP, HEIC/HEIF, and DNG/RAW. Writing and removing metadata is only supported for certain formats, which differ between Android and iOS (see [Format Support](#format-support)). Calling `writeExif(...)` or `removeExif(...)` with an unsupported format rejects with the `UNSUPPORTED_FORMAT` error code.\n\n### Why is the orientation tag still present after calling `removeExif`?\n\nThe `keepOrientation` option is enabled by default so that images are not suddenly displayed rotated after the metadata has been removed. You can set it to `false` to also remove the orientation tag. Note that HEIC files on iOS store the orientation at the container level, so it is always kept there.\n\n### How do I remove the GPS position from a photo before uploading it?\n\nCall `removeExif(...)` with the path to the image file. This strips the GPS position along with all other EXIF metadata in place, without affecting the image quality. See [Privacy: Strip Metadata Before Upload](#privacy-strip-metadata-before-upload) for an example.\n\n### Can I use this plugin with Ionic, React, Vue or Angular?\n\nYes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects.\n\n## Related Plugins\n\n- [File Compressor](https://capawesome.io/docs/sdks/capacitor/file-compressor/): Compress images in formats like PNG, JPEG, and WebP.\n- [File Picker](https://capawesome.io/docs/sdks/capacitor/file-picker/): Pick the image files whose metadata you want to read or edit.\n- [Photo Editor](https://capawesome.io/docs/sdks/capacitor/photo-editor/): Let the user edit a photo.\n- [Photo Manipulator](https://capawesome.io/docs/sdks/capacitor/photo-manipulator/): Headless image transforms like crop, resize, rotate, and format conversion.\n\n## Newsletter\n\nStay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).\n\n## Changelog\n\nSee [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/exif/CHANGELOG.md).\n\n## License\n\nSee [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/exif/LICENSE).\n","readmeFilename":"README.md"}