# photo-cli

## Docs

- [Address Command Reference](https://photocli.com/commands/address.md): Resolve a single photo's GPS coordinates using your chosen reverse geocode provider, and preview the raw response to fine-tune address property selection.
- [Archive Command Reference](https://photocli.com/commands/archive.md): Archive photos into a year/month/day folder structure with SHA1 deduplication and index all metadata into a local SQLite database.
- [Copy Command Reference](https://photocli.com/commands/copy.md): Copy and rename photos into a new organized folder using EXIF date and GPS address data. Choose from 11 naming styles and multiple folder strategies.
- [Info Command Reference](https://photocli.com/commands/info.md): Scan a folder of photos, extract EXIF date and GPS coordinates, optionally reverse geocode each location, and export all data to a CSV file.
- [List Command Reference](https://photocli.com/commands/list.md): Browse, filter, and open photos from an archive folder by album, date, or date range using the photo-cli list command.
- [MCP Command Reference](https://photocli.com/commands/mcp.md): Run photo-cli as an MCP stdio server to expose your archived photo database to AI assistants like Claude, VS Code, and other MCP-compatible clients.
- [Settings Command Reference](https://photocli.com/commands/settings.md): View, change, and reset photo-cli defaults: date formats, separator characters, folder names for missing data, API keys, and supported file extensions.
- [Copy and Rename Companion Files Alongside Your Photos](https://photocli.com/configuration/companion-files.md): Automatically copy sidecar and companion files — like iPhone Live Photo .mov videos — whenever photo-cli copies or archives a photo.
- [Configure photo-cli Application Defaults and Preferences](https://photocli.com/configuration/settings.md): Manage application-level defaults that persist across all photo-cli commands — date formats, separators, report file names, API keys, and more.
- [Supported Photo File Formats and Extensions in photo-cli](https://photocli.com/configuration/supported-formats.md): photo-cli processes jpg, jpeg, heic, png, and hif by default. Learn how to extend support to any format the MetadataExtractor library can read.
- [Rename Photos With Address and Date Using photo-cli](https://photocli.com/examples/address-date-naming.md): Use photo-cli copy to rename every photo using its reverse-geocoded address and taken date and time, while preserving the original folder hierarchy.
- [Prefix Photo Folder Names With Date Ranges in photo-cli](https://photocli.com/examples/folder-date-range.md): Use photo-cli copy to prefix each folder name with the earliest and latest photo dates it contains, and name files with reverse-geocoded address and date.
- [Group All Photos Into Year, Month, and Day Folders](https://photocli.com/examples/group-by-date.md): Use photo-cli copy to flatten all photos into a year/month/day folder hierarchy and rename each file with its full date and time, ordered chronologically.
- [Group Photos Into Country, City, and Town Subfolders](https://photocli.com/examples/group-by-location.md): Use photo-cli copy to organize photos into a country/city/town folder hierarchy from GPS coordinates and name each file with the taken date and address.
- [Copy Command Examples](https://photocli.com/examples/overview.md): These examples show how photo-cli transforms a folder of photos using the `copy` command. Each example shows the original folder structure, the exact command to run, and the resulting output folder so you can compare what changed and why.
- [Rename Photos as Sequential Numbers Using photo-cli](https://photocli.com/examples/sequential-numbering.md): Use photo-cli copy to rename every photo to a padded sequential number ordered by taken date, while keeping the original subfolder hierarchy unchanged.
- [Features Explained: What photo-cli Does and How](https://photocli.com/features-explained.md): A walkthrough of the five things photo-cli is built to do — archive, copy, list/open, export to CSV, and map your photos — each shown end to end with a real command, before/after folders, and what happens behind the scenes.
- [photo-cli: Organize Photos by Date and GPS Location](https://photocli.com/index.md): `photo-cli` is a cross-platform command-line tool that extracts when and where (reverse geocode) your photographs are taken, [archive](/commands/archive) or [copy](/commands/copy) into a new organized folder (not modifying source folder) with various [folder](http://localhost:3000/reference/argument…
- [How to Install photo-cli on macOS, Windows, and Linux](https://photocli.com/installation.md): Step-by-step instructions to install photo-cli as a self-contained executable, via Homebrew, as a .NET global tool, or in a container (Docker, Podman), including PATH troubleshooting.
- [Get Started with photo-cli: Archive Photos in Minutes](https://photocli.com/quickstart.md): Run your first photo-cli archive command to lay your photos out by year/month/day, hash-stamp every file, deduplicate, index everything in a local SQLite database, and expose the archive to AI assistants over MCP.
- [Complete photo-cli Command-Line Arguments Reference](https://photocli.com/reference/arguments.md): Complete reference for every command-line argument accepted by photo-cli, including short flags, long flags, applicable commands, and accepted values.
- [photo-cli Version Changelog and Full Release History](https://photocli.com/reference/changelog.md): Full release history for photo-cli listed in reverse chronological order, covering new features, bug fixes, and breaking changes for every version.
- [Run photo-cli in Docker or Podman With Bind-Mounted Photos](https://photocli.com/reference/container.md): Run photo-cli inside a Docker or Podman container by mounting your photographs and output directory as bind mounts, with a worked archive command example.
- [photo-cli Process Exit Codes and Error Explanations](https://photocli.com/reference/exit-codes.md): Every numeric exit code photo-cli can return, what each one means, and how to check them in shell scripts and CI pipelines to handle errors.
- [Set Up API Keys for photo-cli Reverse Geocode Providers](https://photocli.com/reverse-geocoding/api-keys.md): Supply API keys for BigDataCloud, Google Maps, or LocationIq as a command-line argument, environment variable, or a saved photo-cli setting.
- [Customize Location Address Format in Photo File Names](https://photocli.com/reverse-geocoding/building-address.md): Select address components from your reverse geocode provider and configure the separator to control how location names appear in your file names.
- [How GPS Reverse Geocoding Works in photo-cli Commands](https://photocli.com/reverse-geocoding/overview.md): Learn how photo-cli converts GPS coordinates from your photos into human-readable location names for use in file and folder names.
- [Choose a Reverse Geocode Provider for Your photo-cli](https://photocli.com/reverse-geocoding/providers.md): Compare the four reverse geocode providers in photo-cli — BigDataCloud, OpenStreetMap, Google Maps, and LocationIq — and choose the right one.