Metadata-Version: 1.1
Name: autocrop
Version: 0.1.2
Summary: Automatically crops faces from batches of pictures
Home-page: https://github.com/leblancfg/autocrop
Author: Francois Leblanc
Author-email: leblancfg@gmail.com
License: BSD 2-Clause
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]`
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
