# Photo ID Magick
Python library to automatically align and crop your photos to the correct biometric passport photo size.
This library is based on the libraries [face_detection](https://github.com/ageitgey/face_recognition) and [Pillow](https://python-pillow.org/).
## Installation
```bash
$ pip install photoidmagick
```
## Usage
| | | | |
| ----------------------- | ----------------------- | ----------------------- | ----------------------- |
| ![](doc/sample_003.jpg) | ![](doc/sample_005.jpg) | ![](doc/sample_009.jpg) | ![](doc/sample_011.jpg) |
| | | | |
| ------------------------------ | ------------------------------ | ------------------------------ | ------------------------------ |
| ![](doc/sample_003.square.jpg) | ![](doc/sample_005.square.jpg) | ![](doc/sample_009.square.jpg) | ![](doc/sample_011.square.jpg) |
```bash
$ photoidmagick -f sample_039.jpg -s 1750x2250
Traceback (most recent call last):
__main__.ObliqueFacePoseException: the midsagittal facial line doesn't intersect the midhorizontal iris line in the middle
$ photoidmagick -f sample_039.jpg -s 350x450 --allow-oblique-face
```
| Original | Passport Photo Format | Square Photo Format |
| ----------------------- | -------------------------------- | ------------------------------ |
| ![](doc/sample_039.jpg) | ![](doc/sample_039.passport.jpg) | ![](doc/sample_039.square.jpg) |
```bash
$ photoidmagick -f sample_054.jpg -s 400x400 --allow-oblique-face
Traceback (most recent call last):
__main__.UnevenlyOpenEyelidException: the right eye is more opened than the left eye
$ photoidmagick -f sample_054.jpg -s 1000x1000 --allow-oblique-face --allow-unevenly-open-eye
```
| Original | Passport Photo Format | Square Photo Format |
| ----------------------- | -------------------------------- | ------------------------------ |
| ![](doc/sample_054.jpg) | ![](doc/sample_054.passport.jpg) | ![](doc/sample_054.square.jpg) | |
Raw data
{
"_id": null,
"home_page": "https://github.com/majormode/photoidmagick-python-library",
"name": "photoidmagick",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "",
"keywords": "photo,library,biometric,passport,cli",
"author": "Daniel CAUNE",
"author_email": "daniel.caune@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/e2/26/d963f250b29406b2a11eb5dd9c9cf54189109ab534333c62057b38c7e048/photoidmagick-1.1.6.tar.gz",
"platform": null,
"description": "# Photo ID Magick\n\nPython library to automatically align and crop your photos to the correct biometric passport photo size.\n\nThis library is based on the libraries [face_detection](https://github.com/ageitgey/face_recognition) and [Pillow](https://python-pillow.org/).\n\n## Installation\n\n```bash\n$ pip install photoidmagick\n```\n\n## Usage\n\n| | | | |\n| ----------------------- | ----------------------- | ----------------------- | ----------------------- |\n| ![](doc/sample_003.jpg) | ![](doc/sample_005.jpg) | ![](doc/sample_009.jpg) | ![](doc/sample_011.jpg) |\n\n| | | | |\n| ------------------------------ | ------------------------------ | ------------------------------ | ------------------------------ |\n| ![](doc/sample_003.square.jpg) | ![](doc/sample_005.square.jpg) | ![](doc/sample_009.square.jpg) | ![](doc/sample_011.square.jpg) |\n\n```bash\n$ photoidmagick -f sample_039.jpg -s 1750x2250\nTraceback (most recent call last):\n__main__.ObliqueFacePoseException: the midsagittal facial line doesn't intersect the midhorizontal iris line in the middle\n\n\n$ photoidmagick -f sample_039.jpg -s 350x450 --allow-oblique-face\n```\n\n| Original | Passport Photo Format | Square Photo Format |\n| ----------------------- | -------------------------------- | ------------------------------ |\n| ![](doc/sample_039.jpg) | ![](doc/sample_039.passport.jpg) | ![](doc/sample_039.square.jpg) |\n\n```bash\n$ photoidmagick -f sample_054.jpg -s 400x400 --allow-oblique-face\nTraceback (most recent call last):\n__main__.UnevenlyOpenEyelidException: the right eye is more opened than the left eye\n\n$ photoidmagick -f sample_054.jpg -s 1000x1000 --allow-oblique-face --allow-unevenly-open-eye\n```\n\n| Original | Passport Photo Format | Square Photo Format |\n| ----------------------- | -------------------------------- | ------------------------------ |\n| ![](doc/sample_054.jpg) | ![](doc/sample_054.passport.jpg) | ![](doc/sample_054.square.jpg) | |\n",
"bugtrack_url": null,
"license": "SEE LICENSE IN <LICENSE.md>",
"summary": "Python library to automatically align and crop your photos to the correct biometric passport photo size",
"version": "1.1.6",
"split_keywords": [
"photo",
"library",
"biometric",
"passport",
"cli"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4945fb60517936316160778dfd5808aa838e755430e8febb44501a0a343764c1",
"md5": "073a29bb39974d9b764f76670781e061",
"sha256": "01725ed894860a56de20d7baaba04dfb5cc6860d272b423d8a9c6c5526845d31"
},
"downloads": -1,
"filename": "photoidmagick-1.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "073a29bb39974d9b764f76670781e061",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 15922,
"upload_time": "2023-01-31T04:09:43",
"upload_time_iso_8601": "2023-01-31T04:09:43.398435Z",
"url": "https://files.pythonhosted.org/packages/49/45/fb60517936316160778dfd5808aa838e755430e8febb44501a0a343764c1/photoidmagick-1.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e226d963f250b29406b2a11eb5dd9c9cf54189109ab534333c62057b38c7e048",
"md5": "2e16d97a582f334cb20f537264fc9299",
"sha256": "eddd4c47b3a59811296a16410cadc2ea21f1dc73db854948d6dd711e772289da"
},
"downloads": -1,
"filename": "photoidmagick-1.1.6.tar.gz",
"has_sig": false,
"md5_digest": "2e16d97a582f334cb20f537264fc9299",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 14770,
"upload_time": "2023-01-31T04:09:45",
"upload_time_iso_8601": "2023-01-31T04:09:45.452199Z",
"url": "https://files.pythonhosted.org/packages/e2/26/d963f250b29406b2a11eb5dd9c9cf54189109ab534333c62057b38c7e048/photoidmagick-1.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-31 04:09:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "majormode",
"github_project": "photoidmagick-python-library",
"lcname": "photoidmagick"
}