william-yeh renaming-photos
Rename photo files based on EXIF DateTimeOriginal by running
scripts/rename_photos.py (requires uv and exiftool).
Usage
When the user invokes /rename-photos or asks to rename photos by date:
uv run scripts/rename_photos.py [OPTIONS] DIR [DIR ...]
Options:
--tz +HH:MM— force timezone offset (e.g.--tz +08:00)--format STR— strftime format string (default:%Y-%m-%d %H.%M.%S)--dry-run— print what would be renamed without doing it
Behavior
- Recursively traverses each specified directory
- Supported formats: JPEG, HEIC, CR2, NEF, ARW, DNG, RAF, RW2, ORF, PEF, SRW
- Skips files with missing or suspicious EXIF dates (warns to stderr)
- Timezone: user
--tz>OffsetTimeOriginal> as-is; adds+HHMMsuffix to filename when offset differs from local - Conflict resolution: try bare name → append sub-second → append counter