From d6ac6e5483fcafd88bfde6173778c1ec3a5d35f9 Mon Sep 17 00:00:00 2001 From: Thomas McWork Date: Fri, 23 Jan 2026 15:00:31 +0100 Subject: [PATCH 1/2] Improve face_recognition.md Improved the whole document. --- .../scripts/contrib/face_recognition.md | 42 ++++++++++++------- 1 file changed, 27 insertions(+), 15 deletions(-) diff --git a/content/lua.scripts.manual/scripts/contrib/face_recognition.md b/content/lua.scripts.manual/scripts/contrib/face_recognition.md index 5122dc2c..25d8af9c 100644 --- a/content/lua.scripts.manual/scripts/contrib/face_recognition.md +++ b/content/lua.scripts.manual/scripts/contrib/face_recognition.md @@ -8,29 +8,41 @@ author: "people" ## Name -face_recognition.lua - add a new storage option and calls face_recognition after export +face_recognition.lua - Calls externel tool [face_recognition]() and applies the results ## Description -Add a new storage option to send images to face_recognition. -Images are exported to darktable tmp dir first. -A directory with known faces must exist, the image name are the -tag names which will be used. -Multiple images for one face can exist, add a number to it, the -number will be removed from the tag, for example: -People|IknowYou1.jpg -People|IknowYou2.jpg -People|Another.jpg -People|Youtoo.jpg +Adds on option to apply face recognition on a selection of photos. The results are written into customizable tags. + +## Preparation + +1. Install the face recognition solution https://github.com/ageitgey/face_recognition: `pipx install face-recognition` +2. Prepare your known faces in the following fashion: + +You need a directory which holds the photos of all known faces. The file names are the tag names which will be used. You can add a number suffix to provide multiple photos of the same persone to improve the result. The number will be removed from the tag. + +Example: + +- `People|Family|IknowYou1.jpg` +- `People|Family|IknowYou2.jpg` +- `People|Friend|Another.jpg` +- `People|Youtoo.jpg` + +3. Enable this script from script manager (included in the default installation of darktable. Thus no additional manual download required) and point it to the faces folder from the previous step. + +## Technical process + +1. Selected images are exported into a temporary location with a lowered resolution +2. The external tool is invoced with the photo and the path to the face folder as parameters +3. The result is parsed an dapplied as tags ## Usage -* start this script from script manager. +* start the recognition from the corresponding module ("face recognition") on the right side in the library view -## Additional Software Required +## Source -* https://github.com/ageitgey/face_recognition -* https://github.com/darktable-org/lua-scripts/tree/master/lib +https://github.com/darktable-org/lua-scripts/blob/master/contrib/face_recognition.lua ## Limitations From 44faa3da76e1d985143e8882b94182928380548c Mon Sep 17 00:00:00 2001 From: Thomas McWork Date: Fri, 23 Jan 2026 15:40:15 +0100 Subject: [PATCH 2/2] Update face_recognition.md add missing URL --- content/lua.scripts.manual/scripts/contrib/face_recognition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/lua.scripts.manual/scripts/contrib/face_recognition.md b/content/lua.scripts.manual/scripts/contrib/face_recognition.md index 25d8af9c..1dba3b1a 100644 --- a/content/lua.scripts.manual/scripts/contrib/face_recognition.md +++ b/content/lua.scripts.manual/scripts/contrib/face_recognition.md @@ -8,7 +8,7 @@ author: "people" ## Name -face_recognition.lua - Calls externel tool [face_recognition]() and applies the results +face_recognition.lua - Calls externel tool [face_recognition](https://github.com/ageitgey/face_recognition/) and applies the results ## Description