Table of Contents

1. Building instructions
   1. installing the CLI tool itself
   2. pyproject and MANIFEST
   3. structurey
   4. installing it as a library
   5. Usage

Building instructions

installing the CLI tool itself

pipx install faceblocker

And then, you'll be able to do things like this!

pyproject and MANIFEST

[project]
name = "faceblocker"
version = "0.0.4"
authors = [
{name="Rita Collins", email="r.collins3730@gmail.com" },
]
description = "A CLI tool that can remove faces from videos and replace them with images."
readme = "README.md"
requires-python = ">=3.11"
dependencies = [
"moviepy<2.0",
"opencv-python>4.8.0",
]
classifiers = [
"Programming Language :: Python :: 3",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
]

[project.urls]
"Homepage" = "https://gitlab.com/rdotcollins/movie-anonymiser"
"Bug Tracker" = "https://gitlab.com/rdotcollins/movie-anonymiser/issues"

#[tool.setuptools.packages]
#find = {}  # Scan the project directory with the default parameters
[tool.setuptools]
include-package-data = true
# OR
[tool.setuptools.package-data]
"faceblocker.models" = ["*"]

  
[tool.setuptools.dynamic]
readme = {file = ["README.org"]}
[tool.setuptools.packages.find]
# All the following settings are optional:
namespaces = true
where = ["src"]  # ["."] by default
include = ["*"]  # ["*"] by default

[project.scripts] 
faceblocker = "faceblocker.deface:main"

[build-system]
requires = ["setuptools >= 61.0"]
build-backend = "setuptools.build_meta"

# Command Description
# include pat1 pat2 ... Add all files matching any of the listed patterns (Files must be given as paths relative to the root of the project)
# exclude pat1 pat2 ... Remove all files matching any of the listed patterns (Files must be given as paths relative to the root of the project)
# recursive-include dir-pattern pat1 pat2 ... Add all files under directories matching dir-pattern that match any of the listed patterns
recursive-include ./yunet_model/*
include test_lsoh_out.gif	  
# recursive-exclude dir-pattern pat1 pat2 ... Remove all files under directories matching dir-pattern that match any of the listed patterns
# global-include pat1 pat2 ... Add all files anywhere in the source tree matching any of the listed patterns
# global-exclude pat1 pat2 ... Remove all files anywhere in the source tree matching any of the listed patterns
# graft dir-pattern Add all files under directories matching dir-pattern
# prune dir-pattern Remove all files under directories matching dir-pattern
# The patterns here are glob-style patterns: * matches zero or more regular filename characters (on Unix, everything except forward slash; on Windows, everything except backslash and colon); ? matches a single regular filename character, and [chars] matches any one of the characters between the square brackets (which may contain character ranges, e.g., [a-z] or [a-fA-F0-9]). Setuptools also has undocumented support for ** matching zero or more characters including forward slash, backslash, and colon.
# Directory patterns are relative to the root of the project directory; e.g., graft example* will include a directory named examples in the project root but will not include docs/examples/.

structurey

pwd
tree -L 2 ./ -I "envs|build"

installing it as a library

If you want to download and run it from source, do

pip install faceblocker

and then run faceblocker using

python3 -m faceblocker 

If things are working right with the script and the virtual environment you (Hopefully!) installed this into, faceblocker should be in your $PATH and should allow for being called with just

and then run faceblocker using

faceblocker 

Usage

faceblocker -h

so as an example,

faceblocker -i inputvideo.mp4

should take inputvideo.mp4, render a black square over all faces detected using the default settings on the model. The default settings are fairly liberal in considering things "faces" and will often block first, ask questions later. The default parameters are set to the following.

faceblocker -i /home/river/Videos/test_lsoh.mp4 -p /home/river/Pictures/fox_1f98a.png --samplerate 2 --scale 0.3 --nms_threshhold -o test_lsoh_out.mp4

will create a video like the gif above.