https://github.com/cdown/exifrename

Rename image files based on EXIF data.
https://github.com/cdown/exifrename

command-line command-line-tool exif filesystem organization photo-organiser photo-organizer photography rename rust rust-lang

Last synced: 20 days ago
JSON representation

Rename image files based on EXIF data.

• Host: GitHub
• URL: https://github.com/cdown/exifrename
• Owner: cdown
• License: mit
• Created: 2023-02-21T01:01:51.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2025-02-11T22:28:12.000Z (3 months ago)
• Last Synced: 2025-03-27T20:22:53.726Z (about 1 month ago)
• Topics: command-line, command-line-tool, exif, filesystem, organization, photo-organiser, photo-organizer, photography, rename, rust, rust-lang
• Language: Rust
• Homepage:
• Size: 169 KB
• Stars: 11
• Watchers: 2
• Forks: 4
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# exifrename | [![Tests](https://img.shields.io/github/actions/workflow/status/cdown/exifrename/ci.yml?branch=master)](https://github.com/cdown/exifrename/actions?query=branch%3Amaster)

exifrename renames or copies files based on EXIF data.

## Installation

    cargo install exifrename

## Usage

See `--help` for more information on how to populate `-f FORMAT` and other

available options. An example invocation is:

    % exifrename --copy \

    >  -f "$HOME/Photos/{camera_make}/{year}{month}{day}_{hour}{minute}{second}" \

    >  /mnt/sdcard/*.jpg

    /mnt/sdcard/P0001.jpg -> /home/cdown/Photos/FUJIFILM/20230126_184547_0.jpg

    /mnt/sdcard/P0002.jpg -> /home/cdown/Photos/FUJIFILM/20230126_184547_1.jpg

    /mnt/sdcard/P0003.jpg -> /home/cdown/Photos/FUJIFILM/20230126_184548_0.jpg

    /mnt/sdcard/P0004.jpg -> /home/cdown/Photos/FUJIFILM/20230126_184548_1.jpg

    /mnt/sdcard/P0005.jpg -> /home/cdown/Photos/FUJIFILM/20230126_184548_2.jpg

    /mnt/sdcard/P0006.jpg -> /home/cdown/Photos/FUJIFILM/20230126_184548_3.jpg

    /mnt/sdcard/P0007.jpg -> /home/cdown/Photos/FUJIFILM/20230126_184551.jpg

    /mnt/sdcard/P0008.jpg -> /home/cdown/Photos/FUJIFILM/20230126_184802.jpg

    [...]

You can also see what would be changed first using `--dry-run`.

## Performance

exifrename has a strong focus on performance. On a sample modern laptop with a

mid-spec SSD, we take ~0.02 seconds to produce new names for over 5000 files

with the format `{year}{month}{day}_{hour}{minute}{second}`.