Skip to content

Latest commit

 

History

History
104 lines (83 loc) · 3.94 KB

README.md

File metadata and controls

104 lines (83 loc) · 3.94 KB
Raw

photo-ingest

GitHub license GitHub issues

Tool(s) I personally use to organize photographs I take using various cameras and phones. This covers the gamut of renaming, losslessly rotating, adding copyright notices and storing them in a personally appealing folder structure.

Pre-requisites

This workflow relies on exiftool, jhead and jpegran and expects them to be installed and available.

Usage - bash

Usage: ./photo-ingest.sh [-h]
        -a <artist>     name to use in copyright notices.
        -c <comment>    optional - suffix for destdir.
        -d <destdir>    optional - specify a destination directory. Defaults to PhotosTODO-YYYYmmdd.
        -g grouping     optional - 'm' or 'md'. Defaults to 'md'.
        -h              print this help screen.
        -s <srcdir>     specify source directory with images/videos.
        -t <h>          optional - offset picture dates by <h> hours (int or float). +h to jump forward and -h to fall back.

Usage - PowerShell

     -srcdir            specify source directory with images/videos.
     -artist            name to use in copyright notices.
     -destdir           optional - specify a destination directory. Defaults to PhotosTODO-YYYYmmdd.
     -groupby           optional - 'm' or 'md' for group by month or month-day. Defaults to 'md'. 
     -device            optional - suffix for destdir.
     -fallBackTime      optional - specify number of hours to fall back in timestamps.
     -springForwardTime optional - specify number of hours to spring forward in timestamps.
     -skipCopyright     skip updating copyright notices.
     -skipRename        skip renaming images.
     -skipRotate        skip lossless rotation of images.

Examples

Assuming a source directory with the following contents from an iPhone 6S:

~/Desktop/DCIM
├── 136APPLE
│   ├── IMG_6442.JPG
│   ├── IMG_6443.JPG
│   ├── IMG_6444.JPG
│   ├── IMG_6445.JPG
│   └── IMG_6819.MOV
└── 137APPLE
    ├── IMG_7001.JPG
    ├── IMG_7002.JPG
    ├── IMG_7003.JPG
    ├── IMG_7004.JPG
    └── IMG_7005.JPG

the following invocations:

./photo-ingest.sh -s ~/Desktop/DCIM -a "John Doe" -g md -c "iPhone"
.\photo-ingest.ps1 -srcdir C:\Users\User\Desktop\DCIM -artist "John Doe" -groupby md -device "iPhone"

will produce a directory structure of:

~/Desktop/PhotosTODO-20210505-iPhone
└── 2021
    ├── 0313
    │   ├── 20210313-113149-IMG_6442-001-iP6s.jpg
    │   ├── 20210313-113200-IMG_6443-001-iP6s.jpg
    │   ├── 20210313-113200-IMG_6444-001-iP6s.jpg
    │   └── 20210313-113202-IMG_6445-001-iP6s.jpg
    ├── 0325
    │   └── 20210325-163318-IMG_6819-001-iP6s.mov
    └── 0326
        ├── 20210326-171414-IMG_7001-001-iP6s.jpg
        ├── 20210326-171414-IMG_7002-001-iP6s.jpg
        ├── 20210326-171414-IMG_7003-001-iP6s.jpg
        ├── 20210326-171414-IMG_7004-001-iP6s.jpg
        └── 20210326-171414-IMG_7005-001-iP6s.jpg

where each of the files has been losslessly rotated and metadata updated with copyright notices for John Doe.

Acknowledgements

Contributing

Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.