{"id":17520520,"url":"https://github.com/jonashoechst/facecropper","last_synced_at":"2025-10-29T11:45:37.394Z","repository":{"id":95253703,"uuid":"260196327","full_name":"jonashoechst/facecropper","owner":"jonashoechst","description":"facecropper: detect faces, grayscale and create circular images","archived":false,"fork":false,"pushed_at":"2024-10-08T11:33:53.000Z","size":2362,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-23T16:09:26.193Z","etag":null,"topics":["circle","circular","crop","crop-image","detection","face","facecropper","head","image","processing"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonashoechst.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"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":"2020-04-30T11:44:11.000Z","updated_at":"2024-10-08T11:33:57.000Z","dependencies_parsed_at":"2025-03-06T13:31:52.110Z","dependency_job_id":null,"html_url":"https://github.com/jonashoechst/facecropper","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonashoechst%2Ffacecropper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonashoechst%2Ffacecropper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonashoechst%2Ffacecropper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonashoechst%2Ffacecropper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonashoechst","download_url":"https://codeload.github.com/jonashoechst/facecropper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250468270,"owners_count":21435452,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["circle","circular","crop","crop-image","detection","face","facecropper","head","image","processing"],"created_at":"2024-10-20T11:23:38.465Z","updated_at":"2025-10-29T11:45:37.327Z","avatar_url":"https://github.com/jonashoechst.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"facecropper\n=== \n\n`facecropper` is tool to extract faces from images. It facilitates OpenCV to detect faces, grayscale and create circular images.\n\nThere are multiple settings, such as the padding, background color, or grayscaling:\n\n![lenna.png processed by facecropper with default settings](docs/lenna_0.png)\n![export using the grayscale option](docs/lenna_1.png)\n![applying custom padding](docs/lenna_2.png)\n![custom background color](docs/lenna_3.png)\n\n```bash\nfacecropper -v -o docs/lenna_0.png docs/lenna.png\nfacecropper -v -o docs/lenna_1.png docs/lenna.png --grayscale\nfacecropper -v -o docs/lenna_2.png docs/lenna.png --grayscale --padding 1.0\nfacecropper -v -o docs/lenna_3.png docs/lenna.png --padding 1.0 --color \"(122, 90, 50, 255)\"\n```\n\n## Installation\n\n`facecropper` comes a python package and thus can be installed using pip.\n\n```bash\ngit clone https://github.com/jonashoechst/facecropper.git\npushd facecropper\npip install .\n```\n\n## Usage\n\n```bash\n$ facecropper -h\nusage: facecropper [-h] [--cascade CASCADE] [-o OUTPUT] [-p PADDING] [-s SIZE]\n                   [-g] [-v] [-c COLOR]\n                   image [image ...]\n\nDetect and crop faces from an image.\n\npositional arguments:\n  image                 path to input image\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --cascade CASCADE     face detection cascade to be used by OpenCV\n  -o OUTPUT, --output OUTPUT\n                        Output path template, evaluates placehoders: \n                        {path} -\u003e original file path, \n                        {name} -\u003e original file name, \n                        {ext} -\u003e original file extension, \n                        {i} -\u003e index of detected face\n  -p PADDING, --padding PADDING\n                        relative space around recognized face (\u003e 0), default=0.3\n  -s SIZE, --size SIZE  export image resolution height / width, default=200\n  -g, --grayscale       grayscale cropped image\n  -v, --verbose         increase verbosity (may be applied multiple times)\n  -c COLOR, --color COLOR\n                        background color for circular cutout, BRG(A)-format, default: (255, 255, 255, 0)\n```\n\n### Cascades\n\nThe cascades used by OpenCV can be \n\n- user-supplied by giving a path to the respective xml file or \n- be selected from the project:\n\n```\nhaarcascade_eye.xml\nhaarcascade_eye_tree_eyeglasses.xml\nhaarcascade_frontalcatface.xml\nhaarcascade_frontalcatface_extended.xml\nhaarcascade_frontalface_alt.xml\nhaarcascade_frontalface_alt2.xml\nhaarcascade_frontalface_alt_tree.xml\nhaarcascade_frontalface_default.xml\nhaarcascade_fullbody.xml\nhaarcascade_lefteye_2splits.xml\nhaarcascade_licence_plate_rus_16stages.xml\nhaarcascade_lowerbody.xml\nhaarcascade_profileface.xml\nhaarcascade_righteye_2splits.xml\nhaarcascade_russian_plate_number.xml\nhaarcascade_smile.xml\nhaarcascade_upperbody.xml\n```\n\n## Example\n\n```bash\n$ facecropper -v -o docs/lenna_3.png docs/lenna.png --padding 1.0 --color \"(122, 90, 50, 255)\"\nINFO: Loading /Users/hoechst/Projects/facecropper/facecropper/haarcascades/haarcascade_frontalface_default.xml\nINFO: Processing docs/lenna.png, resolution: 512x512\nINFO: detected face of size 173x173\nINFO: Exporting docs/lenna_3.png, grayscale: False\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonashoechst%2Ffacecropper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonashoechst%2Ffacecropper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonashoechst%2Ffacecropper/lists"}