Skip to content

index.mdx

Latest commit

 

History

History
70 lines (60 loc) · 3.23 KB

index.mdx

File metadata and controls

70 lines (60 loc) · 3.23 KB
title photo-cli: Organize Photos by Date and GPS Location
description photo-cli reads EXIF date and GPS data from your photos and copies them into structured folders with meaningful names. Runs on macOS, Windows, and Linux.

photo-cli reads the EXIF metadata embedded in your photos — the taken date and GPS coordinates — and copies them into a clean, organized folder hierarchy with meaningful file names. You run it once from your terminal, and your photos are sorted. No accounts, no subscriptions, no vendor lock-in.

Install photo-cli on macOS, Windows, or Linux in under a minute. Run your first photo-cli command and see results immediately. Explore all commands: copy, archive, list, info, address, settings, and mcp. See real before-and-after examples for common organization strategies.

What photo-cli does

photo-cli extracts two pieces of information from each photo:

  • When — the taken date stored in EXIF metadata by your camera or phone
  • Where — the GPS coordinates, resolved to a human-readable address using a reverse geocode provider of your choice

It uses these to copy your photos into a new folder with structured names like 2024.03.15_14.22.01-France-Paris.jpg, leaving your originals untouched.

Core commands

Copy photos into a new organized folder with custom naming and folder strategies. Archive photos with SHA1-based deduplication and index into a local SQLite database. Export photo metadata (date, coordinates, address) to a CSV file. Browse, filter, and open archived photos by album, date, or date range. Preview the reverse geocode response for a single photo. Run an MCP server to let AI assistants query your photo archive.

Get started

Install via Homebrew on macOS or as a .NET global tool on any platform. See [Installation](/installation). Point photo-cli at a folder of photos and choose a naming strategy. See [Quick Start](/quickstart). Configure a reverse geocode provider to include place names in your file and folder names. See [Reverse Geocoding](/reverse-geocoding/overview). Browse real before-and-after examples for popular organization strategies. See [Examples](/examples/overview).