danielthegray/autocrop

A python package to crop smaller photos out of a larger image and optionally rotate crooked photos

This is a python package to crop smaller photos out of a larger image and
optionally rotate crooked photos.  The typical use would be to scan several
photos in a flatbed scanner, and use autocrop to find the photos, deskew them,
and save them independently.

Pipenv can be used to install dependencies (currently only pillow and numpy).

Basic usage of the package is as follows:

>>> from PIL import Image
>>> from autocrop import MultiPartImage, Background
>>> 
>>> # A saved scan with the scanner empty.
>>> blank_img = Image.open('/path/to/blank/scan')
>>> background = Background().load_from_image(blank_img, dpi=200)
>>> 
>>> # A saved scan with multiple photos loaded in the scanner
>>> scan_img = Image.open('/path/to/scanned/image')
>>> scan = MultiPartImage(scan_img, background, dpi=200)
>>> 
>>> for index, photo in enumerate(scan):
...     photo.save('/path/to/cropped/image-%d.jpg' % index)

Also included is a simple linux command-line script to initiate a scan and
handle the cropping.  It should be considered a demonstration of most of the
capabilities of the package, not a utility for general wide-spread use.