Getting Started

Start anonymizing images and videos with Celantur Container.

Overview

Celantur Container is a Docker-based container image that automatically anonymizes faces, persons, license plates and vehicles on images and videos.

How to run Celantur Container in Batch Mode.

Requirements and Installation

Modes and Features

Anonymize Images and Videos

Anonymize Panorama Images

Due to large resolution panorama images require special parametrization to achieve the best anonymization results.

Run following command after, specifying the format value according to Predefined Formats if the panorama's resolution exactly matches an item in the list of predefined formats (e.g. pano:8192):

Batch mode
celantur.sh \
  -a face \
  -a license-plate \
  --format pano:8192 \
  --model segmentatio-omnium 

If your panorama's resolution is not part of Predefined Formats, specify the middle section (x1, y1, x2, y2) of the panorama.

Batch mode
celantur.sh \
  -a face \
  -a license-plate \
  --format '{"number":[4,1],"overlap":[300,0],"section":[0,1870,12288,4950]}' \
  --model segmentatio-omnium 

When starting with a demo of Celantur Container, our team will send you a customized code sample.

Anonymize Drone Images

Example for images (4032x3024) from a DJI Mini 3 Pro.

Persons and vehicles:

Batch mode
celantur.sh \
  -a person \
  -a vehicle \
  --model segmentatio-omnium \
  -f '{"number":[4,3],"overlap":[200,200]}' \
  --vehicle-threshold 0.4 \
  --person-threshold 0.3

Faces and license plates:

Batch mode
celantur.sh \
  -a face \
  -a license-plate \
  --model segmentatio-omnium \
  -f '{"number":[4,3],"overlap":[200,200]}' \
  --face-threshold 0.1 \
  --license-plate-threshold 0.1

-f '{"number":[4,3],"overlap":[200,200]}' specifies into how many tiles (and their respective overlap) the image will be split. For best results anonymization results, tiles should roughly cover 1000x1000 pixels.

Anonymize FullHD Videos

Run following command:

Batch mode
celantur.sh \
  -a face \
  -a license-plate \
  --model segmentatio-omnium \
  --face-threshold 0.2 \
  --license-plate-threshold 0.2 \
  --video \
  --keep-bit-rate

Optimize: Adapt thresholds (lower = better detections, potentially more false positives; higher = less false positives) --face-threshold 0.3 , --license-plate-threshold 0.3 (Batch/Stream mode)

What's New

Celantur Container receives continuous improvements and new features. Read more about past and recent releases in the Release Notes.

Last updated