> ## Documentation Index
> Fetch the complete documentation index at: https://photocli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Copy Command Examples

> 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.

## 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.

```text theme={null}
├── 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.

<CardGroup cols={2}>
  <Card title="Sequential numbering" icon="list-ol" href="/examples/sequential-numbering">
    Rename every photo to a padded sequential number while keeping the original subfolder hierarchy intact.
  </Card>

  <Card title="Group by date" icon="folder-tree" href="/examples/group-by-date">
    Flatten all photos into a year/month/day folder tree and rename each file with its full timestamp.
  </Card>

  <Card title="Folder date range prefix" icon="calendar-range" href="/examples/folder-date-range">
    Prefix each folder name with the earliest and latest photo dates inside it, and name files with address and date.
  </Card>

  <Card title="Address + date naming" icon="location-dot" href="/examples/address-date-naming">
    Rename every photo using its reverse-geocoded address combined with the taken date, preserving the original folder hierarchy.
  </Card>

  <Card title="Group by location" icon="map-location-dot" href="/examples/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.
  </Card>
</CardGroup>