Console Bulk Photo Upload
To bulk-upload photos to the dossier database, you can use the findface-security-uploader utility from the FindFace package (in addition to the web interface upload functionality). Use this utility when you need to upload a large number of photos (more than 10,000).
Tip
To view the findface-security-uploader help, execute:
findface-security-uploader --help
Do the following:
Write the list of photos and metastrings to a CSV or TSV file.
Important
The file used as a metadata source must have the following format:
path to photo | metastring
.To prepare a TSV file, use either a
script
or thefind
command.Note
Both the script and the command in the examples below create the
images.tsv
file. Each image in the list will be associated with a metastring coinciding with the image file name in the formatpath to photo | metastring
.To build a TSV file listing photos from a specified directory (
/home/user/25_celeb/
in the example below), run the following command:python3 tsv_builder.py /home/user/25_celeb/
The
find
usage example:find photos/ -type f -iname '*g' | while read x; do y="${x%.*}"; printf "%s\t%s\n" "$x" "${y##*/}"; done
Create a job file out of a CSV or TSV file by using
add
. As a result, a fileenroll-job.db
will be created and saved in a current directory.findface-security-uploader add images.tsv
The
add
options:--format
: input file format,tsv
by default,--delimiter
: field delimiter, by default"\t"
for TSV, and","
for CSV.
Note
A job file represents a sqlite database which can be opened on the sqlite3 console.
Process the job file by using
run
.findface-security-uploader run --dossier-lists 2 --api http://127.0.0.1:80 --user admin --password password
The
run
options:--parallel
: the number of photo upload threads, 10 by default. The more threads you use, the faster the bulk upload is completed, however it requires more resources too.--all-faces
: upload all faces from a photo if it features several faces.--api
:findface-security
API URL,http://127.0.0.1:80/
by default.--user
: login.--password
: password.--dossier-lists
: comma-separated list of the watch lists id’s.--failed
: should an error occur during the job file processing, correct the mistake and try again with this option.