{"id":23116090,"url":"https://github.com/mr-vaibh/facecrop-thumb","last_synced_at":"2026-05-02T19:33:12.131Z","repository":{"id":232972676,"uuid":"785682280","full_name":"mr-vaibh/facecrop-thumb","owner":"mr-vaibh","description":"Generate thumbnails of detected faces in images using Python. This package leverages the MTCNN (Multi-Task Cascaded Convolutional Neural Network) for accurate face detection and OpenCV for image processing.","archived":false,"fork":false,"pushed_at":"2024-04-15T06:23:22.000Z","size":29,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-23T10:07:26.523Z","etag":null,"topics":["face-recognition","image-processing","mtcnn","opencv","pypi","python","thumbnail-generator","thumbnails","utility"],"latest_commit_sha":null,"homepage":"https://facecrop-thumb.readthedocs.io/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mr-vaibh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-12T11:56:39.000Z","updated_at":"2024-04-15T06:46:09.000Z","dependencies_parsed_at":"2024-11-15T01:49:33.366Z","dependency_job_id":"92a353d3-0ecf-4c85-967b-5a6c2b6cc9a6","html_url":"https://github.com/mr-vaibh/facecrop-thumb","commit_stats":null,"previous_names":["mr-vaibh/facecrop-thumb"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/mr-vaibh/facecrop-thumb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Ffacecrop-thumb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Ffacecrop-thumb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Ffacecrop-thumb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Ffacecrop-thumb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mr-vaibh","download_url":"https://codeload.github.com/mr-vaibh/facecrop-thumb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Ffacecrop-thumb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32547647,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T19:18:06.202Z","status":"ssl_error","status_checked_at":"2026-05-02T19:16:21.335Z","response_time":132,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["face-recognition","image-processing","mtcnn","opencv","pypi","python","thumbnail-generator","thumbnails","utility"],"created_at":"2024-12-17T04:11:01.013Z","updated_at":"2026-05-02T19:33:12.115Z","avatar_url":"https://github.com/mr-vaibh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FaceCropThumb\n\nFaceCropThumb is a Python package for generating thumbnails of detected faces in images. It utilizes the MTCNN (Multi-Task Cascaded Convolutional Neural Network) for accurate face detection and OpenCV for image processing.\n\nAll documentation is in the “docs” directory and online at https://facecrop-thumb.readthedocs.io/en/stable/. If you’re just getting started, here’s how we recommend you read the docs:\n\n## Features\n\n- Detect faces in images using the MTCNN model\n- Crop detected faces with a configurable margin\n- Generate square thumbnails of detected faces\n- Option to resize the entire image if no face is detected or face detection is skipped\n- Command-line utility for easy usage\n\n## Quick Installation\n\nYou can install FaceCropThumb via pip:\n\n```pip install facecropthumb```\n\n## Quick Usage\n\n```facecropthumb \u003cimage_path\u003e [-d/--dir \u003coutput_directory\u003e] [-m/--margin \u003cmargin_size\u003e] [-F/--no-face] [-S/--skip-face] [-a/--all]```\n\n- `\u003cimage_path\u003e`: Path to the input image file.\n- `-d/--dir \u003coutput_directory\u003e`: Directory to store the output thumbnail. Default is the current directory.\n- `-m/--margin \u003cmargin_size\u003e`: Margin around the detected face. Default is 50 pixels.\n- `-F/--no-face`: Skip face detection and resize the whole image if no face is detected.\n- `-S/--skip-face`: Skip face detection and resize the whole image.\n-  `-a/--all`: Process all images in the specified directory. If no directory is provided, it processes images in the current directory.\n-  `-v/--version`: Show installed version.\n-  `-h/--help`: Show help.\n\nExample:\n\n```facecropthumb input_image.jpg -d output_directory -m 30 -F```\n\nThis command will generate a thumbnail of the detected face in `input_image.jpg`, with a margin of 30 pixels, and if no face is detected, it will resize the whole image to a square of 74 x Y pixels (~approx).\n\n## Development Documentation\n\nDISCLAIMER: This documentation is for the contributers of FaceCropThumb, not for general package users.\n\nFirstly install dev dependencies from `requirements.txt` file\n\n### Usage\n\nTo run and test the package, use `python -m facecrop-thumb \u003cargs\u003e`\n\n### Build Docs\n\nYou can see the production build docs in `docs/build/index.html`\n\nUpdate the documentation at any cost after any change in feature\n\nRun this to watch the `docs/` folder while you're making documentation changes\n\n`watchmedo shell-command --patterns=\"*.rst;conf.py;_templates/*\" --recursive --command='sphinx-build -b html docs docs/_build' docs`\n\n### Release\n\nAfter a successful change in the package, it's time to publish it officially.\n\n - Update the version in `facecrop_thumb/version.py`\n\n - Create a new release on [release page](https://github.com/mr-vaibh/facecrop-thumb/releases/new). (This will automatically trigger GitHub actions to release a new version on PYPI)\n\nThat's it, the newer version will be available to everyone.\n\nBut if you want to publish a version by yourself, you can use following command:\n\n - `python setup.py sdist`\n\n - ` twine upload dist/*`\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-vaibh%2Ffacecrop-thumb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmr-vaibh%2Ffacecrop-thumb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-vaibh%2Ffacecrop-thumb/lists"}