$ npm · MIT · zero setup

exifregistry

The photographer's metadata toolkit.

Inspect, fix and organize your photos from the terminal. It never touches a pixel, and it never loses an original.

$ npm install -g exifregistry
GitHub
or brew install daviarndt/tap/exifregistry
▸ RAW · HEIC · video ▸ powered by ExifTool + libvips
exifreg
$ exifreg show DSC02481.ARW
┌──────────────────────────┬─────────────────────────┐
│ Camera │ Sony A7 IV │
│ Shutter count │ 48,213 │
│ Aperture │ f/2.8 │
│ Shutter │ 1/250s │
│ Taken (DateTimeOriginal) │ 2026:06:01 14:30:00 │
│ GPS │ -23.550500, -46.633300 │
└──────────────────────────┴─────────────────────────┘
$ exifreg date *.ARW --shift "+2h"
✓ Updated dates on 214 files.
$ exifreg resize photo.jpg --max-size 1mb
✓ photo.jpg (12.3 MB) → photo.resized.jpg (0.98 MB, q74)
$
Safe by default these files are your life's work, and the tool treats them that way
{{ p.mark }}
{{ p.title }}
{{ p.desc }}
New // your archive, guaranteed

Verified backups.

Checksum-verified copies of your whole library, tracked in a manifest. Deletions never propagate, changed files are versioned instead of overwritten, and one command re-checks every byte to catch silent disk corruption years later. Restore everything, one folder, or just one month of captures.

Read how it works →

$ exifreg backup ~/Photos --to /Volumes/Backup --apply
✓ 1,214 files copied and verified (18.2 GB).
$ exifreg backup --verify --to /Volumes/Backup
✓ Backup is healthy: every file matches its checksum.
// what it does

Everything around the image.

01

Inspect

Beautiful terminal reports of camera, lens, shutter count and GPS, with one-flag export to Markdown.

$ exifreg show DSC02481.ARW -e report.md ✓ Exported metadata report to report.md
02

Fix metadata

Set GPS from map coordinates, shift wrong clocks, copy tags between files, or strip everything. Every edit keeps a backup.

$ exifreg gps beach.jpg --coords "-23.5505, -46.6333" ✓ Set GPS of beach.jpg · backup saved
03

Organize

Sort into folders from metadata, rename in shooting order, ingest cards with checksums, find duplicates. Previews first, RAW+JPEG stay paired.

$ exifreg organize ./card --by "{year}/{camera}" --apply ✓ Moved 214 files · 0 overwritten
04

Prepare & publish

Render photos in aesthetic colored frames with their EXIF caption, or resize to an exact file-size target.

[ your photo ]
35mm · f/2.8 · 1/250s · ISO 400
// 25 commands

One tool, one job each.

exifreg {{ c.name }}
{{ c.desc }}
// no flags to memorize

Just run exifreg

Run it bare and exifregistry opens a guided interactive mode. Pick what you need from a menu and it walks you through the rest.

$ exifreg
? What would you like to do? (↑↓ to move)
{{ m.caret }} {{ m.icon }} {{ m.label }}
// your photos stay yours

Runs 100% on your machine.

⌂

Local by design

Every command runs offline, on your computer. Even GPS-to-city lookups use a bundled database. Your photos, locations and client work never leave your disk. No cloud, no uploads, no telemetry, no account.

◇

Free & open-source

MIT licensed and free forever: no paywalls, no pro tier, no locked features. Every line of code is public on GitHub, so you can verify exactly what touches your files.

✎

Maintained by a photographer

This is not a side demo. It is the tool its author uses on real shoots, so it keeps getting fixed and sharpened. From a photographer, for photographers.

If it saves your archive some day, you can fuel the next feature: ☕ Buy me a coffee