{"id":20553572,"url":"https://github.com/mrtj/face-obfuscator","last_synced_at":"2025-06-25T01:32:18.714Z","repository":{"id":69169707,"uuid":"384406126","full_name":"mrtj/face-obfuscator","owner":"mrtj","description":"Obfuscate human faces in video files","archived":false,"fork":false,"pushed_at":"2021-07-23T12:05:37.000Z","size":39,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-06T06:19:26.116Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrtj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2021-07-09T10:44:11.000Z","updated_at":"2021-07-23T12:05:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"20ec5a5b-9a4f-4138-a6a0-4a6eef9216a4","html_url":"https://github.com/mrtj/face-obfuscator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mrtj/face-obfuscator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrtj%2Fface-obfuscator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrtj%2Fface-obfuscator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrtj%2Fface-obfuscator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrtj%2Fface-obfuscator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrtj","download_url":"https://codeload.github.com/mrtj/face-obfuscator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrtj%2Fface-obfuscator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261785319,"owners_count":23209285,"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":[],"created_at":"2024-11-16T02:42:28.989Z","updated_at":"2025-06-25T01:32:18.686Z","avatar_url":"https://github.com/mrtj.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Face Obfuscator\n\nFace Obfuscator obfuscates human faces in a video.\n\n## Installation\n\n### AWS EC2\n\n1. Follow the [detailed guide](ec2.md) to install docker, docker-compose and optionally NVIDIA Container Toolkit on a EC2 instance.\n\n2. Clone this repo on the instance:\n```bash\n$ git clone https://github.com/mrtj/face-obfuscator.git\n```\n\n## Running\n\n1. Place the input video(s) in the `input` folder:\n```bash\n$ cd face-obfuscator\n$ cp path/to/my_input_video.mp4 input/my_input_video.mp4\n```\n2. Run the application with `docker-compose`. The first time you execute this command, docker will build the application image. This can take some time. Successive executions will be faster.\n```bash\n$ docker-compose up --build\n```\n3. The application will try to open each video files in the `input` folder, blur the faces on each frame of the video, and save the blurred video to the `output` folder.\n\n### Skipping frames and reducing resolution\n\nYou can choose to process only every *n*\u003csup\u003eth\u003c/sup\u003e frame and to reduce the resolution of the input video. These options can speed up the video processing, but they will result in a lower quality output video. If you reduce the video resolution, the face detector might also not find all small faces. The processing time should be speeded up approximately by a factor of the product of the downscale variables.\n\nThe following environment variables control skipping frames and reducing resolution:\n - `DOWNSCALE_FPS`: specifies to process only every *n*\u003csup\u003eth\u003c/sup\u003e frame.\n - `DOWNSCALE_RES`: specifies the downscale factor of the resolution of the input video.\n\nFor example, calling `face_obfuscator` with this command:\n```bash\n$ DOWNSCALE_FPS=4 DOWNSCALE_RES=2 docker-compose up --build\n```\nwill make the obfuscator to process only every 4th frame, and change the width and height of the video to half size. Approximately 8x faster processing time can be expected.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrtj%2Fface-obfuscator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrtj%2Fface-obfuscator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrtj%2Fface-obfuscator/lists"}