archive-images

Description

Small python package to create an image archive from a bunch of unordered images. The images are archived on the basis of the timestamp in the exif data.

Installation

You can install the simpleicp package from PyPI:

pip install archive-images

Then call the help screen of executable with archive-images --help.

Usage notes

The default target path of an image in the archive is year/month/%Y_%m_%d_%H_%M_%S.%f.ext, e.g. image_archive\2018\04\2018_04_03_17_21_20.219.jpg. Note that the extension of an image is automatically converted to lowercase, e.g. .JPG to .jpg.

Help screen

usage: archive-images [-h] -i IMAGEFOLDER -a IMAGEARCHIVE [-e IMAGEEXTENSIONS] [-m {copy,move}]
                      [-fs FILTERBYIMAGESIZE FILTERBYIMAGESIZE] [-d] [-n] [-c]

required arguments:
  -i IMAGEFOLDER, --imageFolder IMAGEFOLDER
                        Path to input folder with images to archive. (default: None)
  -a IMAGEARCHIVE, --imageArchive IMAGEARCHIVE
                        Path to output folder with image archive. (default: None)

optional arguments:
  -e IMAGEEXTENSIONS, --imageExtensions IMAGEEXTENSIONS
                        Extensions of images to archive separated by commas.
                        (default: ['jpg', 'jpeg'])
  -m {copy,move}, --mode {copy,move}
                        Move or copy image files to archive? (default: copy)
  -fs FILTERBYIMAGESIZE FILTERBYIMAGESIZE, --filterByImageSize FILTERBYIMAGESIZE FILTERBYIMAGESIZE
                        Archive only images with a specific image size. The image size must be
                        specified as two integer numbers separated by a single space,
                        i.e. num1 num2. The orientation of the images (portrait or landscape) is
                        not considered by this filter, i.e. images with size num1-by-num2 or
                        num2-by-num1 are archived. (default: [0, 0])
  -d, --addDuplicates   Add duplicates to a subfolder "duplicates" in image archive?
                        (default: False)
  -n, --addNoExif       Add images with no exif information to a subfolder "no_exif" in image
                        archive? (default: False)
  -c, --confirm         Confirm each operation before execution? (default: False)