Skip to main content

Documentation Index

Fetch the complete documentation index at: https://photocli.com/llms.txt

Use this file to discover all available pages before exploring further.

​
The test photo set

Every example on this site uses the same starting folder: 17 photos spread across two subfolders. The Italy album folder holds 13 photos taken between December 2005 and October 2008, with GPS coordinates pointing to locations in Arezzo and Florence. The Spain Journey folder holds 3 photos — two taken in Madrid in April 2015 and one with no EXIF data at all. Two photos (DSC_5727.jpg and GOPR6742.jpg) live at the root level, taken in Kenya and the United Kingdom respectively. One photo (Italy album/IMG_2371.jpg) has a taken date but no GPS coordinate, and Spain Journey/IMG_5397.jpg has neither. 
├── DSC_5727.jpg
├── GOPR6742.jpg
├── Italy album
│   ├── DJI_01732.jpg
│   ├── DJI_01733.jpg
│   ├── DSC00001.JPG
│   ├── DSC03467.jpg
│   ├── DSC_1769.JPG
│   ├── DSC_1770.JPG
│   ├── DSC_1770_(same).jpg
│   ├── DSC_1771.JPG
│   ├── GOPR7496.jpg
│   ├── GOPR7497.jpg
│   ├── IMG_0747.JPG
│   └── IMG_2371.jpg
└── Spain Journey
    ├── DSC_1807.jpg
    ├── DSC_1808.jpg
    └── IMG_5397.jpg

2 directories, 17 files

​
Copy command examples

Each of the five pages below demonstrates a different combination of --process-type, --naming-style, --group-by, and folder-append arguments. Pick the strategy that matches how you want to browse your photos.

Sequential numbering

Rename every photo to a padded sequential number while keeping the original subfolder hierarchy intact.

Group by date

Flatten all photos into a year/month/day folder tree and rename each file with its full timestamp.

Folder date range prefix

Prefix each folder name with the earliest and latest photo dates inside it, and name files with address and date.

Address + date naming

Rename every photo using its reverse-geocoded address combined with the taken date, preserving the original folder hierarchy.

Group by location

Group photos into a country/city/town folder hierarchy based on GPS coordinates and name each file with the taken date and address.