Skip to main content

Automatically crops faces from batches of pictures

Project description

# autocrop

![obama_crop](https://cloud.githubusercontent.com/assets/15659410/10975709/3e38de48-83b6-11e5-8885-d95da758ca17.png)

Basic script using openCV, that automatically detects and crops faces from batches of photos.

Perfect for batch work for ID cards or profile pictures, will output 500px wide square images, centered around the biggest face detected. It can also add a touch of auto gamma correction.

## Installation Simple!

The script will process all .jpg files in the /photos directory. The cropped files are placed in photos/crop, and originals are moved to photos/bkp.

If it can’t find a face in the picture, it’ll simply leave it in /photos.

### conda The easiest way to run autocrop is to use the [Anaconda Python distribution](https://www.anaconda.com/download/) and run the following:

git clone https://github.com/leblancfg/autocrop conda install –channel conda-forge –file requirements.txt

Move your pictures to be cropped in the photos directory, then run the script with:

cd autocrop python autocrop.py

If running on Windows, this is by far the sanest way to approach this problem. Also, installing Anaconda doesn’t require admin privileges on Windows.

### pip Otherwise, binaries for the Python-only bindings for OpenCV have recently been made available through pip, which makes installation a breeze.

git clone https://github.com/leblancfg/autocrop pip install numpy opencv-python

Move your pictures to be cropped in the photos directory, then run the script with:

cd autocrop python autocrop.py

## Versions The script works on openCV 3+, and Python 2.7 or (preferably) 3+. It is in active development.

## More Info Check out: * http://docs.opencv.org/master/d7/d8b/tutorial_py_face_detection.html#gsc.tab=0 * http://docs.opencv.org/master/d5/daf/tutorial_py_histogram_equalization.html#gsc.tab=0

Adapted from: * http://photo.stackexchange.com/questions/60411/how-can-i-batch-crop-based-on-face-location

## TODO Pull requests welcome! I don’t see major feature additions in the future, but proper * [ ] Create PyPI and conda-forge packages so that it can be directly pip- or conda-installable. * [ ] Split off into smaller functions, and write unit tests. * [ ] Handle input filetypes for *.bmp, *.dib, *.jp2, *.png, *.webp, *.pbm, *.pgm, *.ppm, *.sr, *.ras, *.tiff, *.tif. * [X] Handle output image size. * [X] Handle CLI input: $ autocrop [-w width] [-H height] [-p path]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autocrop-0.1.2.tar.gz (141.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page