https://github.com/jftuga/photo_id_resizer

Resize photo ID images using face recognition technology
https://github.com/jftuga/photo_id_resizer

batch-processing face-detection face-recognition golang image-processing photos profile-picture

Last synced: 2 months ago
JSON representation

Resize photo ID images using face recognition technology

• Host: GitHub
• URL: https://github.com/jftuga/photo_id_resizer
• Owner: jftuga
• License: mit
• Created: 2020-11-26T16:04:54.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2020-12-07T14:01:19.000Z (about 4 years ago)
• Last Synced: 2024-06-20T10:06:22.967Z (8 months ago)
• Topics: batch-processing, face-detection, face-recognition, golang, image-processing, photos, profile-picture
• Language: Go
• Homepage:
• Size: 250 KB
• Stars: 12
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# photo_id_resizer

Resize photo ID images using face recognition technology.

Binaries for Windows, MacOS, and Linux can be found on the [Releases Page](https://github.com/jftuga/photo_id_resizer/releases).

**Description**

The program is used to resize large photo ID images which reside in a `source` directory and save them into a different

`destination` directory.  If an image file does not need to be resized (eg it is already smaller than `max height`), then the

file is simply copied from the `source` directory to the `destination` directory.  When image resizing occurs, this [content aware image resizing library](https://github.com/esimov/caire) is used with its face detection algorithm to avoid face deformation.

**Usage**

```

photo_id_resizer.exe: resize photo ID image files

  -a int

    	skip files older than X number of days. Ex: 0=do not skip any, 7=skip files older than a week

  -d string

    	destination directory

  -f string

    	path to 'facefinder' classification file (default: "facefinder")

  -h int

    	max image height

  -m string

    	regular expression to match files. Ex: jpg (default: "jpg|png")

  -s string

    	source directory

  -t int

    	number of files to process concurrently (default: # of CPU cores)

  -w int

    	max image width

  -x string

      regular expression to exclude files, precedes -m

```

**Example**

* Copy `jpg` files from `r:\photos` to `r:\resized` resizing any photos that have a height greater than `500`.

* Process `10` files concurrently that are `30` days old or newer.

* Use `r:\facefinder` for the classification file.

```

photo_id_resizer -s r:\photos -d r:\resized -f r:\facefinder -h 500 -m jpg -t 10 -a 30

```

Option | Explanation

-------|------------

-s r:\photos | source directory

-d r:\resized | destination directory

-f r:\facefinder | location of the 'facefinder' classification file

-h 500 | resize file if height is greater than 500 pixels, otherwise, just copy image to destination

-m jpg | match any file name containing 'jpg'; for case insensitive use: (?i)jpg

-t 10 | process 10 images concurrently

-a 30 | skip files older then 30 days

**Acknowledgements**

* [Caire](https://github.com/esimov/caire) - a content aware image resizing library with face detection

* [facefinder](https://github.com/esimov/caire/blob/master/data/facefinder) -  the face finding classification file use by this program

* [Go Concurrency Patterns: Pipelines and cancellation](https://blog.golang.org/pipelines)

**License**

* [MIT License](LICENSE)