Gesichtserkennung¶
PhotoPrism enthält eine Gesichtserkennung, mit der du Bilder deiner Familie und Freunde wiederfindest. Freue dich darauf, längst vergessene Aufnahmen neu zu entdecken! Neue Gesichter werden während des Indexierens deiner Sammlung erkannt und anschließend nach Ähnlichkeit gruppiert, sodass du sie schnell Personen zuordnen kannst.
Die Erkennung beginnt erst, wenn deine Sammlung vollständig indexiert wurde. Das Suchen und Aktualisieren von Gesichtern verursacht vorübergehend eine hohe CPU-Belastung und kann je nach Hardware und Anzahl der Bilder eine Weile dauern.
Vorhandene Cluster werden automatisch im Hintergrund optimiert, z.B. wenn neue Gesichter erkannt werden, du eine falsche Zuordnung gemeldet hast oder neue Dateien zu deiner Sammlung hinzugefügt werden.
Erkannte und neue Personen¶
Der Bereich Personen zeigt dir bereits erkannte Personen sowie neue Gesichts-Cluster.
Klicke , um eine Person als Favorit zu markieren. Favoriten werden ganz oben angezeigt.

Warum werden im Bereich NEU nicht alle erkannten Gesichter angezeigt?¶
Im Bereich NEU werden nur erkannte Gesichts-Cluster angezeigt. In deiner Sammlung kann es noch tausende weitere, nicht gruppierte Gesichter geben, wie z. B. Gesichter auf Shampooflaschen oder im Fernsehen.
Du kannst diese Bilder finden, indem du nach face:new suchst. Falls du bestimmte Bilder suchst, empfehlen wir, die Suche mit anderen Filtern wie year oder country zu kombinieren. Im Personen-Tab des Bearbeitungs-Dialogs werden alle Gesichter angezeigt, sodass du sie benennen oder eine falsche Zuordnung über die Schaltfläche melden kannst.
Wenn ein Gesicht nicht erkannt wurde...¶
Gesichter können aus mehreren Gründen nicht erkannt werden:
- Unsere neueste Version beinhaltet eine verbesserte Gesichtserkennung. Nach einem Update solltest du einen kompletten Rescan durchführen oder
photoprism faces indexim Terminal ausführen, um weitere zuvor übersehene Gesichter zu finden - Möglicherweise musst du warten, bis die Indexierung abgeschlossen ist, da die Gesichtserkennung erst danach beginnt
- Bei Bildstapeln wird nur die Primärdatei nach Gesichtern durchsucht
- Gesichter können kleiner als die konfigurierte Mindestgröße sein
- Unsere Gesichtserkennung hat das Bild nicht gründlich genug gescannt
- Eine reduzierte Auflösung sowie Qualität von generierten Vorschaubildern führt zu schlechteren Gesichtserkennungs-Ergebnissen
- Der Kontrast spielt eine große Rolle, so dass ein helles Gesicht mit grauen Haaren auf einem grauen Hintergrund für unsere Gesichtserkennung weniger auffällig sein kann als für dich
- In sehr seltenen Fällen kann ein Gesicht als falsch-positiv eingestuft und daher ignoriert werden
Die Gesichtserkennung vergleicht die Ähnlichkeit von Gesichtern. Der Ähnlichkeits‑Schwellwert für ein Gesicht wird reduziert, wenn du ein Gesicht aus einem Cluster entfernst.
Gesichter identifizieren¶
- Gehe zu Personen
- Gehe zu Neu
- Klicke in das Eingabefeld
- Beginne einen Namen einzugeben
- Drücke Enter

- Öffne den Bearbeitungs-Dialog
- Gehe zu Personen
- Klicke in das Eingabefeld
- Beginne einen Namen einzugeben
- Drücke Enter

Du kannst Namen auch direkt aus der Info-Seitenleiste des Vollbildbetrachters zuweisen. Sie ist außerdem der einzige Ort, an dem du ein Gesicht manuell markieren kannst, das PhotoPrism bei der automatischen Erkennung übersehen hat.
Die Person wird nun unter Erkannt angezeigt
Cover für eine Person ändern¶
- Gehe zum Tab Personen im Bearbeitungs-Dialog des Bildes, auf dem das Gesicht zu sehen ist, das du als Titelbild verwenden möchtest
- Fahre mit der Maus über in der oberen rechten Ecke des Gesichts
- Klicke auf Als Titelbild festlegen
Personen ausblenden¶
Du kannst Personen im Bereich Erkannt ausblenden, indem du klickst.
Bilder von ausgeblendeten Personen tauchen weiterhin in Suchergebnissen auf.

Um alle Personen, inklusive ausgeblendete, zu sehen klicke .

Ausgeblendete Personen werden wieder angezeigt, wenn du klickst.

Gesichter ausblenden¶
Du kannst Gesichts-Cluster im Bereich Neu auf die gleiche Weise wie Personen ausblenden.
Alle Bilder einer Person ansehen¶
- Gehe zu Personen
- Gehe zu Erkannt
- Klicke auf eine Person

- Gehe zu Suche
- Suche nach person:"jane-doe"

Personen umbenennen¶
- Gehe zu Personen
- Gehe zu Erkannt
- Klicke auf den Namen
- Gib einen neuen Namen ein
- Klicke auf Speichern


Gesicht einer anderen Person zuordnen¶
Wenn einem Gesicht die falsche Person zugeordnet ist, kannst du dies ändern.
Jedes Mal, wenn du ein Gesicht aus einem Cluster aussortierst, werden die Gesichts-Cluster im Hintergrund aktualisiert.
- Öffne den Bearbeitungs-Dialog
- Gehe zu Personen
- Klicke
- Nun kannst du einen neuen Namen eingeben, oder das Feld leer lassen

Du kannst Zuordnungen auch über die Info-Seitenleiste des Vollbildbetrachters ändern.
Gesichter entfernen¶
Falls etwas Falsches als Gesicht erkannt wurde, oder dich ein Gesicht nicht interessiert, kannst du es entfernen.
- Öffne den Bearbeitungs-Dialog
- Gehe zu Personen
- Klicke

Bevor die Seite neu geladen wird kannst du diese Aktion rückgängig machen.

Gesichter können auch über die Info-Seitenleiste des Vollbildbetrachters entfernt werden.
Alle Bilder einer Person herunterladen¶
- Gehe zu Personen
- Selektiere eine Person
- Öffne das Kontext-Menü
- Klicke

Album aus Personen erstellen¶
- Gehe zu Personen
- Selektiere eine Person
- Öffne das Kontext-Menü
- Klicke
- Wähle ein existierendes Album oder gib einen neuen Albumnamen ein
- Klicke auf Hinzufügen

Suche¶
Du kannst Bilder von bestimmten Personen mit Hilfe der folgenden Suchanfragen finden
people,facesoderfaces:truefindet alle Bilder mit Gesichternfaces:falsefindet alle Bilder ohne Gesichterfaces:3findet alle Bilder mit mindestens 3 Personenperson:"John Doe"odersubject:"John Doe"findet alle Bilder der Person John Doepeople:"John"odersubjects:"John"findet alle Bilder von Personen, deren Namen John enthält
Der person/subject sowie der people/subjects Filter kann in Kombination mit & und | verwendet werden (siehe Suche). Suchfilter können auch kombiniert werden.
person:"John Doe&Jane Doe" faces:3 findet alle Bilder auf denen John und Jane Doe und mindestens eine weitere Person abgebildet sind.

Bekannte Probleme¶
Eine vollständige Liste bekannter Probleme findest du unter Erste Schritte > Bekannte Probleme > Gesichtserkennung.
Ältere Hardware¶
Die Gesichtserkennung kann auf älterer Hardware aufgrund unzureichender Ressourcen langsam sein oder sogar abstürzen.
Wie die meisten Anwendungen hat auch PhotoPrism bestimmte Anforderungen und unser Entwicklungsprozess beinhaltet keine Tests auf nicht unterstützter oder ungewöhnlicher Hardware.
Hintergrund-Worker¶
Die Gesichtserkennung wurde unter der Annahme entwickelt und getestet, dass der Hintergrund-Worker ungefähr alle 15 Minuten läuft, sofern das Backend nicht mit anderen Aufgaben wie der Indexierung beschäftigt ist. Sie wurde nicht mit deutlich längeren Intervallen getestet und ist dafür auch nicht ausgelegt.
Der Hintergrund-Worker gruppiert neue Gesichter nach Ähnlichkeit, vergleicht Gesichter mit Clustern und optimiert bei Bedarf bestehende Cluster. Ohne diese Routineaufgaben wird die Anzahl der zu verarbeitenden Gesichter schnell zu groß. Bei der nächsten Ausführung des Workers kann es dann zu einer starken Serverbelastung kommen, bis alle Gesichter, Gesichts-Cluster und zugehörigen Bilder aktualisiert wurden. Je länger du wartest, desto mehr CPU wird benötigt und desto länger dauert es.
Ein wichtiger Grund, warum der Worker unabhängig von tatsächlichen Änderungen in der Hauptinstanz läuft, ist, dass manche Nutzer Datenbankinhalte direkt verändern oder zusätzliche Instanzen betreiben, etwa zum Indexieren. Dieses Problem lässt sich lösen, braucht aber Zeit. Würden wir das ignorieren und den Worker nicht ständig laufen lassen, könnte das zu vielen zusätzlichen Support-Anfragen führen und uns weiter von der Entwicklung abhalten.
Der Umgang mit Änderungen über mehrere Instanzen hinweg wird im Laufe der Zeit verbessert, sodass der Worker in zukünftigen Releases seltener laufen muss.
Geplante Funktionen
- Import von XMP-Gesichtsmarkierungen
- Personen beim Durchsuchen deiner Bilder ausschließen
- automatische Sicherung benannter Personen in YAML-Dateien