Astro Image EXIF Loader

An Astro content collection loader that extracts EXIF metadata from images using exiftool-vendored.

What it does

This package provides two main functions:

Loader: Creates an Astro content collection from your images and extracts EXIF metadata into structured data. Each entry's id is the filename with extension (e.g., "photo.jpg").
Importer: Optionally enhances collection entries with Astro Assets imports so you can display the actual images. Only works for images under /src/.

The loader scans your image directory and creates collection entries with EXIF data. Use getEntry("collection", "filename.jpg") to get specific images by filename.

Quick Start

1. Create a content collection with EXIF data

Configure your collection in src/content.config.ts:

import { defineCollection } from "astro:content";
import { defineExifCollection } from "astro-image-exif-loader";

const images = defineCollection(
  defineExifCollection({
    imagesDir: { pattern: "**/*", base: "src/content/images" },
    presets: ["basic", "location"], // or use `tags` for specific fields
  }),
);

export const collections = { images };

2. Use the data in your pages

Option A: Just EXIF data (no image display)

---
import { getCollection } from 'astro:content';

const images = await getCollection('images');
---

{images.map(image => (
  <div>
    <h3>{image.data.fileName}</h3>
    <p>Camera: {image.data.Make} {image.data.Model}</p>
    <p>ISO: {image.data.ISO}</p>
  </div>
))}

Option B: EXIF data + actual images

---
import { getCollection } from 'astro:content';
import { Image } from 'astro:assets';
import imageImporter from 'astro-image-exif-loader/importer';

const images = await imageImporter(await getCollection('images'));
---

{images.map(image => (
  <div>
    {image.defaultImport && <Image src={image.defaultImport} alt="" width={400} />}
    <p>Camera: {image.data.Make} {image.data.Model}</p>
    <p>ISO: {image.data.ISO}</p>
  </div>
))}

Image Patterns

Configure where your images are located:

defineExifCollection({
  imagesDir: {
    pattern: "**/*.{jpg,jpeg,png,tiff}",
    base: "src/content/photos",
  },
});

Pattern Restrictions

For the Loader (EXIF extraction): No restrictions - any valid glob pattern works

For the Importer (Astro Assets): Must be under /src/ due to Vite limitations

`defineExifCollection(options)`

Creates a complete collection definition with both loader and schema.

Options:

imagesDir.pattern: Glob pattern for matching images (default: '**/*')
imagesDir.base: Base directory path (default: 'src/content/images')
presets: Array of preset groups to extract
tags: Array of specific EXIF tag names to extract
excludeTags: Array of EXIF tag names to exclude from presets/tags
extractAll: Boolean to extract all available EXIF data
includeRawExif: Boolean to include raw EXIF object (default: false)

You can combine presets and tags together. Use excludeTags to remove specific tags from presets:

defineExifCollection({
  presets: ["camera", "exposure"],
  tags: ["GPSAltitude"],
  excludeTags: ["Make"],
});

Available Preset Tags

basic:

FileSize
ImageWidth
ImageHeight

camera:

Make, Model
LensModel, Lens, LensID, LensInfo
LensSerialNumber, SerialNumber, BodySerialNumber, CameraSerialNumber
LensMake, MaxAperture, MinFocalLength, MaxFocalLength

exposure:

ISO, FNumber
ExposureTime, ShutterSpeed
FocalLength, FocalLengthIn35mmFormat
Flash, WhiteBalance, ExposureMode, MeteringMode

datetime:

DateTimeOriginal, CreateDate, DateTime

location:

GPSLatitude, GPSLongitude, GPSAltitude
Country, State, City, Location, Sub-location
GPSAreaInformation, Country-PrimaryLocationCode, Province-State

technical:

ColorSpace, Orientation, Software
SceneType, SceneCaptureType

metadata:

Artist, Copyright, ImageDescription
Keywords, Title, Subject

Package detail