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 |
-
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
$ 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
- 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
