This example prefixes each folder name with the date range of the photos inside it — showing the earliest and latest taken dates — while renaming every file with its reverse-geocoded address and day. The original folder hierarchy is preserved; only the names change.Documentation Index
Fetch the complete documentation index at: https://photocli.com/llms.txt
Use this file to discover all available pages before exploring further.
Command
Key arguments
| Argument | Value | What it does |
|---|---|---|
--process-type | SubFoldersPreserveFolderHierarchy | Keeps the original subfolder structure in the output. |
--folder-append | DayRange | Computes the earliest and latest photo taken date within each folder and prepares that range to be appended to the folder name. |
--folder-append-location | Prefix | Places the date range before the original folder name, e.g., 2005.12.14-2008.10.22-Italy album. |
--naming-style | AddressDay | Names each file as {address}-{yyyy.MM.dd}.ext, using the reverse-geocoded location and the date the photo was taken. |
--reverse-geocode | OpenStreetMapFoundation | Uses the OpenStreetMap Nominatim API to look up an address for each photo’s GPS coordinates. |
--openstreetmap-properties | country city town suburb | Selects which address fields to include when building the address string. |
--number-style | AllNamesAreSameLength | When multiple files in the same folder would get the same name, appends a suffix padded so all suffixed names stay equal length. |
Before and after
Before (photos/):
organized-albums/):
What you see in the output
TheItaly album folder is renamed 2005.12.14-2008.10.22-Italy album, reflecting that the earliest photo inside it was taken on 14 December 2005 and the latest on 22 October 2008. The Spain Journey folder becomes 2015.04.10-2015.04.10-Spain Journey — both dates are the same because all dated photos in that folder were taken on the same day.
Files are renamed using their reverse-geocoded address and day. The ten Arezzo photos all share the same address and date (Italia-Arezzo-2008.10.22), so photo-cli appends a two-digit suffix (-10 through -19) to keep their names equal length across the group.
Photos without GPS coordinates (IMG_2371.jpg) or without any EXIF date (IMG_5397.jpg) are kept under their original names and placed inside the renamed folder alongside the other files.