{"id":20453681,"url":"https://github.com/sowham-3098/basic-face-mask-ar-using-python-opencv","last_synced_at":"2026-05-09T08:06:49.006Z","repository":{"id":176330630,"uuid":"655047401","full_name":"Sowham-3098/Basic-Face-Mask-AR-using-Python-opencv","owner":"Sowham-3098","description":"Face Mask AR is a Python program that detects faces in a live video stream and augments them with a mask image. This provides a fun and interactive way to try on different masks virtually.","archived":false,"fork":false,"pushed_at":"2023-06-18T17:09:39.000Z","size":3818,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-15T23:17:30.457Z","etag":null,"topics":["augmented-reality","face-detection","opencv","python3"],"latest_commit_sha":null,"homepage":"","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/Sowham-3098.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":"2023-06-17T18:04:03.000Z","updated_at":"2024-07-11T22:00:04.000Z","dependencies_parsed_at":"2023-07-06T19:47:03.123Z","dependency_job_id":null,"html_url":"https://github.com/Sowham-3098/Basic-Face-Mask-AR-using-Python-opencv","commit_stats":null,"previous_names":["sowham-3098/basic-face-mask-ar-using-python-opencv"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sowham-3098%2FBasic-Face-Mask-AR-using-Python-opencv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sowham-3098%2FBasic-Face-Mask-AR-using-Python-opencv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sowham-3098%2FBasic-Face-Mask-AR-using-Python-opencv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sowham-3098%2FBasic-Face-Mask-AR-using-Python-opencv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sowham-3098","download_url":"https://codeload.github.com/Sowham-3098/Basic-Face-Mask-AR-using-Python-opencv/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242005734,"owners_count":20056432,"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":["augmented-reality","face-detection","opencv","python3"],"created_at":"2024-11-15T11:13:36.903Z","updated_at":"2026-05-09T08:06:43.960Z","avatar_url":"https://github.com/Sowham-3098.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Face Mask AR\n\nFace Mask AR is a Python program that detects faces in a live video stream and augments them with a mask image. This provides a fun and interactive way to try on different masks virtually.\n\n## Requirements\n\n- Python 3\n- OpenCV library (`pip install opencv-python`)\n- Haar cascade XML file for face detection (e.g., `haarcascade_frontalface_default.xml`)  taken from `https://github.com/kipr/opencv/blob/master/data/haarcascades/haarcascade_frontalface_default.xml`\n- Mask image with transparency (RGBA format)\n\n## Usage\n\n1. Clone the repository or download the Python script and the required image files.\n\n2. Install the necessary libraries by running the following command in the terminal:\n```pip install opencv-python```\n\n3. Place the Haar cascade XML file (`haarcascade_frontalface_default.xml`) and the mask image (e.g., `mask.png`) in the same directory as the Python script.\n\n4. Run the Python script in a terminal or IDE:\n```python face_mask_ar.py```\n\n5. The program will open a window showing the live video stream from your default webcam. It will detect faces in the video and augment them with the selected mask image.\n\n6. To choose a different mask, press the \"Q\" key to exit the program and update the `mask.png` file with your desired mask image.\n\n## Screenshots\n![screenshot](https://github.com/Sowham-3098/Basic-Face-Mask-AR-using-Python-opencv/assets/95470604/a6340c86-ddc0-45b5-ae0c-17e185b66e2c)\n\n*Example screenshot of the program displaying the live video stream with a detected face and a mask augmented on it.*\n\n\n## Notes\n\n- Ensure that your webcam is properly connected and accessible by the program.\n- Experiment with different mask images to achieve the desired augmented reality effect.\n- Adjust the face detection parameters in the script (e.g., scale factor, minimum neighbors) for better face detection results if needed.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsowham-3098%2Fbasic-face-mask-ar-using-python-opencv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsowham-3098%2Fbasic-face-mask-ar-using-python-opencv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsowham-3098%2Fbasic-face-mask-ar-using-python-opencv/lists"}