gaaqoo

Convert images into ones suitable for digital photo frames.

• Reduce file size to save SD card spaces: Scale down images to fit just to the screen size of your digital photo frame.
• Ajdust orientation: Rotate images based on EXIF Orientation.
• Overlay shooting datetime: Overlay EXIF DataTimeOriginal.
• Convert smart: Detect new or updated images in src directory recursively, and convert those into dst directory.

'gaaqoo' was named after 'gaku' which means 'frame' in Japanese.

---

Install

$ pip install gaaqoo

Usage

$ gaaqoo --help
usage: gaaqoo [-h] [-V] [-f FILE.yml]

Convert images into ones suitable for digital photo frames.

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  -f FILE.yml, --config FILE.yml
                        config YAML file (default:
                        ~/.config/gaaqoo/default.yml)
$

Config (YAML)

~/.config/gaaqoo/default.yml (have to create by yourself for now.)

# -*- coding: utf-8 -*-

SRC_DIR: ~/Pictures/gaaqoo-src
DST_DIR: ~/Pictures/gaaqoo-dst
SUFFIX: ['.jpg', '.JPG', '.jpeg', '.JPEG']
# exclude if filepath contains there
EXCLUDE: ['_EXCLUDE_', '_NG_']
DST_IMG_SIZE: [800, 480]
FONT: /usr/share/fonts/truetype/dejavu/DejaVuSans.ttf
FONT_SIZE: 30

Example

Nagoya Castle :-)

	image	width x height	orientation
src		4320x3240	[EXIF] Orientation=6 (Rotate 90 CW)
dst		360x480 (fits for 800x480)	Horizontal (normal)

License

MIT License

Dependencies

$ cat requirements.txt | xargs -n1 yolk -l -f License,Author,Home-page,Summary | egrep -v '^Versions with'
Pillow (3.3.1)
    Summary: Python Imaging Library (Fork)
    Home-page: http://python-pillow.org
    Author: Alex Clark (Fork Author)
    License: Standard PIL License

PyYAML (3.12)
    Summary: YAML parser and emitter for Python
    Home-page: http://pyyaml.org/wiki/PyYAML
    Author: Kirill Simonov
    License: MIT

$

---

For developers

EXIF orientation example images

• exif-orientation-examples

Image rotation based on EXIF orientation when tools show it

Without rotation, so suitable for debugging:

• display (ImageMagick)

With rotation:

• display -auto-orient
• nautilus (file manager)
• eog

EXIF tools

• ExifTool
  • exiftool example.jpg
• jhead:
  • jhead example.jpg
  • jhead -autorot example.jpg
• Exiv2: exiv2 -pv example.jpg

$ jhead -autorot example.jpg
$ jhead -mkexif example.jpg  # keep DateTimeOriginal. drop GPS, Orientation, and others.
$ exiftool example.jpg