blurfaces's Introduction

blurfaces

Tool Description

Blurs faces in video.

sample	mode=all, censor-type=gaussianblur
ross.mp4	out.mp4
mode=one, censor-type=pixelation	mode=allexcept, censor-type=facemasking
out_one_pixelation_ross.mp4	out.mp4

Installation

Make sure you have Python version 3.10.6 or greater installed

Download the tool's repository using the command:

 git clone [email protected]:raviksharma/blurfaces.git

Move to the tool's directory and install the tool

 cd blurfaces
 pip install -r requirements.txt

Usage

$ python3 blur_faces.py --help
Usage: blur_faces.py [OPTIONS] IN_VIDEO_FILE

Options:
  --mode [all|one|allexcept]
  --model [hog|cnn]
  --censor-type [gaussianblur|facemasking|pixelation]
  --count INTEGER                 How many times to upsample the image looking
                                  for faces. Higher numbers find smaller
                                  faces.

  --in-face-file TEXT
  --help                          Show this message and exit.

Example

python3 blur_faces.py media/friends.mp4 --mode allexcept --model cnn --censor-type facemasking --in-face-file media/Ross_Geller.jpg

Additional Information

originally developed for Bellingcat Oct 2022 Hackathon
uses face_recognition for face detection
uses ffmpeg for audio and video processing
tool is not perfect; should be used with other manual editing before final publish
next steps
- smooth face_locations (fixes failure in detecting odd frames)
- detect scene change and use it to reset face_locations[]
- choose num_jitters

Recommend Projects