pad: photo add date

Description

Existing tools are not for me, so I make this. The format and style are almost fully controlled by users. The DateTimeOriginal, i.e., the date the photo was taken, is added if the exif information exists; otherwise, stat.ST_MTIME, the time of last modification, is used for those photo without exif information. Note that ST_MTIME is just close to but not the taken time. The image quality are different after processed due to Pillow tool.

Install

pip3 install git+https://github.com/aben20807/pad.git

stable version:

pip3 install git+https://github.com/aben20807/pad.git@v1.0.6

Usage

pad -s 20221012/ -r

Screenshot

Font

• CursedTimerUlil-Aznm.ttf: designed by heaven castro and licensed as Freeware

Performance

• 360 photos (1.72 GB) -> 360 photos with dates (1.31 GB): 5.967s

Help

$ pad -h
usage: pad.py [-h] -s SRC [-d DST] [-f] [-r] [--text_size TEXT_SIZE] [--text_color TEXT_COLOR] [--text_anchor TEXT_ANCHOR] [--pos_w POS_W] [--pos_h POS_H] [--fine_tune_aspect_ratio FINE_TUNE_ASPECT_RATIO]
              [--stroke_width STROKE_WIDTH] [--stroke_color STROKE_COLOR] [--quality QUALITY] [--format FORMAT] [--img_exts IMG_EXTS]

optional arguments:
  -h, --help            show this help message and exit
  -s SRC, --src SRC     input dir (required) (default: None)
  -d DST, --dst DST     output dir (default: ./pad_result/)
  -f, --force           overwrite existing files (default: False)
  -r, --recursive       recursively process (default: False)
  --text_size TEXT_SIZE
                        text size ('N' mm) (default: 4.24)
  --text_color TEXT_COLOR
                        text color (default: (255, 149, 21))
  --text_anchor TEXT_ANCHOR
                        text anchor (ref: https://pillow.readthedocs.io/en/stable/handbook/text-anchors.html#text-anchors) (default: rb)
  --pos_w POS_W         position for width (0~1) (default: 0.94)
  --pos_h POS_H         position for height (0~1) (default: 0.94)
  --fine_tune_aspect_ratio FINE_TUNE_ASPECT_RATIO
                        expect aspect ratio for fine tune pos for cropping ('none' or 'M/N' (M<=N)) (default: 2/3)
  --stroke_width STROKE_WIDTH
                        stroke width for text (default: 1)
  --stroke_color STROKE_COLOR
                        stroke color (default: (242, 97, 0))
  --quality QUALITY     jpg output quality (default: 95)
  --format FORMAT       date format (ref: https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes) (default: `%y %-m %-d)
  --img_exts IMG_EXTS   support extensions for processed photos (case insensitive) (default: jpg,jpeg,png,tiff)

License

MIT