https://github.com/aben20807/picdate
photo add date
https://github.com/aben20807/picdate
aspect-ratio cli date datetime font-image photography photos pip3 python3
Last synced: 4 months ago
JSON representation
photo add date
- Host: GitHub
- URL: https://github.com/aben20807/picdate
- Owner: aben20807
- License: mit
- Created: 2022-10-12T05:40:55.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-29T11:59:46.000Z (about 1 year ago)
- Last Synced: 2024-12-29T12:23:04.013Z (about 1 year ago)
- Topics: aspect-ratio, cli, date, datetime, font-image, photography, photos, pip3, python3
- Language: Python
- Homepage:
- Size: 32.2 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PicDate: Quick and Simple Date Marking for Photos
[](https://pypi.org/project/picdate/) [](https://pepy.tech/projects/picdate) [](LICENSE) [](https://github.com/psf/black)
## Description
Photo studios no longer offer the service of adding dates to photos, so if you need it, you have to do it yourself. Since there didn't seem to be any tools for this, I created one. The format and style are almost fully controlled by users. The [`DateTimeOriginal`](https://web.archive.org/web/20240329145302/https://www.awaresystems.be/imaging/tiff/tifftags/privateifd/exif/datetimeoriginal.html), i.e., the date the photo was taken, is added if the exif information exists; otherwise, [`stat.ST_MTIME`](https://docs.python.org/3/library/stat.html#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 qualities are different after processed due to Pillow tool.
## Install
from PyPi:
```bash
pip3 install picdate
```
from GitHub:
```bash
pip3 install git+https://github.com/aben20807/picdate.git
```
```bash
# or with specific version
pip3 install git+https://github.com/aben20807/picdate.git@v2.0.1
```
## Usage
```bash
picdate -s 20221012/ -r
```
After processing, a folder named `picdate_result` will be created, containing the processed files.
## Screenshot
## Font
+ [CursedTimerUlil-Aznm.ttf](https://www.fontspace.com/cursed-timer-ulil-font-f29411): designed by [heaven castro](https://www.fontspace.com/heaven-castro) and licensed as Freeware
## Performance
+ 360 photos (1.72 GB) -> 360 photos with dates (1.31 GB): 5.967s
## Help
```bash
$ picdate -h
usage: picdate [-h] -s DIR [-d DIR] [-f] [-r] [-j N] [--text_size N]
[--text_color COLOR] [--text_anchor TEXT_ANCHOR] [--pos_x X]
[--pos_y Y] [--fine_tune_aspect_ratio RATIO] [--stroke_width N]
[--stroke_color COLOR] [--quality N] [--resize W,H]
[--format FORMAT] [--img_exts IMG_EXTS]
PicDate: Quick and Simple Date Marking for Photos
options:
-h, --help show this help message and exit
-s DIR, --src DIR input dir (required) (default: None)
-d DIR, --dst DIR output dir (default: ./picdate_result/)
-f, --force overwrite existing files (default: False)
-r, --recursive recursively process (default: False)
-j N, --jobs N parallel jobs to process (default: 16)
--text_size N text size ('N' mm) (default: 4.24)
--text_color 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_x X position for x-axis from 0 (left) to 1 (right) (default:
0.94)
--pos_y Y position for y-axis from 0 (top) to 1 (bottom) (default:
0.94)
--fine_tune_aspect_ratio RATIO
expect aspect ratio for fine tune pos for cropping
('none' or 'M/N' (M<=N)) (default: 2/3)
--stroke_width N stroke width for text (default: 1)
--stroke_color COLOR stroke color (default: (242, 97, 0))
--quality N jpg output quality (default: 95)
--resize W,H resize image to WxH (default: None)
--format FORMAT date format (ref: https://docs.python.org/3/library/date
time.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)
```
## Known issues
+ `strftime` exhibits different behavior across platforms, leading to invalid format strings. The current implementation detects the platform and applies a different default format: windows (`` `%y %#m %#d ``) and others (`` `%y %-m %-d ``).
## License
MIT