v0.3.2: configurable suggest_threshold (+ add-on option), jump-to-person dropdown on the Persons tab

Author: skycryer

CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to FaceID. The Home Assistant add-on shows this file in the
 update dialog; standalone users can watch GitHub releases.
 
+## 0.3.2 — 2026-07-23
+
+- **Configurable suggestion threshold** (`suggest_threshold`, default 0.40): controls
+  when an unknown face is grouped into a "Looks like <person>" suggestion. Available as
+  an add-on option too.
+- **Jump-to-person dropdown** on the Persons tab (shown once you have more than a few
+  people) — pick a name to scroll straight to that person.
+
 ## 0.3.1 — 2026-07-23
 
 - **Smarter review queue**: unknown faces that resemble an enrolled person are now

app/webui.py

@@ -256,6 +256,7 @@ def recent():
     @app.get("/api/health")
     def health():
         return {"status": "ok", "persons": len(gallery.persons()),
-                "queue": processor.queue.qsize(), "open_events": len(processor.events)}
+                "queue": processor.queue.qsize(), "open_events": len(processor.events),
+                "suggest_threshold": float(cfg["faceid"].get("suggest_threshold", 0.40))}
 
     return app

docs/example-config.yaml

@@ -25,6 +25,10 @@ faceid:
   max_attempts: 6                      # recognition attempts per Frigate event
   retry_seconds: 2.5                   # min. seconds between attempts on the same event
   cluster_eps: 0.55                    # DBSCAN cosine distance for grouping unknowns in the UI
+  # review UI: unknown faces with a best-match score >= this get grouped into a
+  # "Looks like <person>" suggestion with the dropdown pre-selected. Keep below
+  # match_threshold so borderline faces are pre-sorted without weak-match noise.
+  suggest_threshold: 0.40
   set_sub_label: true                  # write recognized names back to Frigate events
   presence_window: 120                 # camera sensor shows everyone seen within this window (s)
   # process events only from these cameras (empty = all cameras)

faceid-addon/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to FaceID. The Home Assistant add-on shows this file in the
 update dialog; standalone users can watch GitHub releases.
 
+## 0.3.2 — 2026-07-23
+
+- **Configurable suggestion threshold** (`suggest_threshold`, default 0.40): controls
+  when an unknown face is grouped into a "Looks like <person>" suggestion. Available as
+  an add-on option too.
+- **Jump-to-person dropdown** on the Persons tab (shown once you have more than a few
+  people) — pick a name to scroll straight to that person.
+
 ## 0.3.1 — 2026-07-23
 
 - **Smarter review queue**: unknown faces that resemble an enrolled person are now

faceid-addon/app/webui.py

@@ -256,6 +256,7 @@ def recent():
     @app.get("/api/health")
     def health():
         return {"status": "ok", "persons": len(gallery.persons()),
-                "queue": processor.queue.qsize(), "open_events": len(processor.events)}
+                "queue": processor.queue.qsize(), "open_events": len(processor.events),
+                "suggest_threshold": float(cfg["faceid"].get("suggest_threshold", 0.40))}
 
     return app

faceid-addon/config.yaml

@@ -1,5 +1,5 @@
 name: FaceID
-version: "0.3.1"
+version: "0.3.2"
 slug: faceid
 description: Face recognition for Frigate — trainable gallery, clustered unknown review, HA sensors
 url: https://github.com/SkyTechNerds/faceid
@@ -30,6 +30,7 @@ options:
   match_threshold: 0.5
   unknown_threshold: 0.35
   cluster_eps: 0.55
+  suggest_threshold: 0.40
   presence_window: 120
   set_sub_label: true
   cameras: []
@@ -44,6 +45,7 @@ schema:
   match_threshold: float(0.2,0.9)
   unknown_threshold: float(0.1,0.8)
   cluster_eps: float(0.3,0.8)
+  suggest_threshold: float(0.1,0.9)
   presence_window: int(10,3600)
   set_sub_label: bool
   cameras:

faceid-addon/run.sh

@@ -59,6 +59,7 @@ faceid:
   match_threshold: $(cfg '.match_threshold')
   unknown_threshold: $(cfg '.unknown_threshold')
   cluster_eps: $(cfg '.cluster_eps')
+  suggest_threshold: $(cfg '.suggest_threshold')
   presence_window: $(cfg '.presence_window')
   set_sub_label: $(cfg '.set_sub_label')
   min_face_px: 48

faceid-addon/static/index.html

@@ -87,7 +87,7 @@ <h1>FACEID</h1>
 
 <script>
 const $=s=>document.querySelector(s), main=$('#main');
-let tab='unknowns', persons={}, selected=new Set();
+let tab='unknowns', persons={}, selected=new Set(), suggestThr=0.40;
 
 async function j(url,opt){const r=await fetch(url,opt);if(!r.ok)throw new Error(await r.text());return r.json()}
 function toast(m){const t=$('#toast');t.textContent=m;t.style.display='block';setTimeout(()=>t.style.display='none',2500)}
@@ -100,6 +100,7 @@ <h1>FACEID</h1>
   render()});
 
 async function health(){try{const h=await j('api/health');
+  if(typeof h.suggest_threshold==='number')suggestThr=h.suggest_threshold;
   $('#health').textContent=`${h.persons} persons · queue ${h.queue} · events ${h.open_events}`}catch(e){$('#health').textContent='offline'}}
 
 function personOptions(sel){
@@ -157,7 +158,7 @@ <h1>FACEID</h1>
     main.innerHTML=backfillRow(bf)+'<div class="empty">No unknown faces in the queue.</div>';return}
   const excluded=window._excludedIds||(window._excludedIds=new Set());
   const n2s={}; Object.entries(persons).forEach(([sl,p])=>{n2s[p.name]=sl;});
-  const SUGGEST=0.40;
+  const SUGGEST=suggestThr;
   // Vorschlags-Gruppen (nach vermuteter Person) + Rest-Cluster
   const byName={};
   const rest=[];
@@ -358,7 +359,7 @@ <h1>FACEID</h1>
 
 function personCard(slug,p){
   return `
-    <div class="person">
+    <div class="person" id="p-${slug}">
       <div class="head">
         <button class="fav${p.favorite?' on':''}" title="${p.favorite?'remove from favorites':'mark as favorite'}" onclick="toggleFav('${slug}',${p.favorite?0:1})">${p.favorite?'★':'☆'}</button>
         <b>${esc(p.name)}</b><span class="n">${p.count} faces</span>
@@ -387,10 +388,15 @@ <h1>FACEID</h1>
   if(favs.length) body+=`<h2>★ Favorites (${favs.length})</h2>`+favs.map(([s,p])=>personCard(s,p)).join('');
   if(rest.length) body+=`<h2>${favs.length?'Others':'Persons'} (${rest.length})</h2>`+rest.map(([s,p])=>personCard(s,p)).join('');
   if(!entries.length) body='<div class="empty">No persons yet.</div>';
+  const jump=entries.length>3?`
+      <select id="pjump" title="jump to a person" onchange="if(this.value){document.getElementById('p-'+this.value).scrollIntoView({behavior:'smooth',block:'start'});this.value='';}">
+        <option value="">Jump to…</option>${personOptions('')}
+      </select>`:'';
   main.innerHTML=`
     <div class="row">
       <input id="pname" placeholder="New person…" size="18" title="create an empty person, then upload photos or assign faces from the unknown queue">
       <button class="act" onclick="createPerson()">CREATE</button>
+      <span style="flex:1"></span>${jump}
     </div>`+body;
 }
 async function toggleFav(slug,fav){

static/index.html

@@ -87,7 +87,7 @@ <h1>FACEID</h1>
 
 <script>
 const $=s=>document.querySelector(s), main=$('#main');
-let tab='unknowns', persons={}, selected=new Set();
+let tab='unknowns', persons={}, selected=new Set(), suggestThr=0.40;
 
 async function j(url,opt){const r=await fetch(url,opt);if(!r.ok)throw new Error(await r.text());return r.json()}
 function toast(m){const t=$('#toast');t.textContent=m;t.style.display='block';setTimeout(()=>t.style.display='none',2500)}
@@ -100,6 +100,7 @@ <h1>FACEID</h1>
   render()});
 
 async function health(){try{const h=await j('api/health');
+  if(typeof h.suggest_threshold==='number')suggestThr=h.suggest_threshold;
   $('#health').textContent=`${h.persons} persons · queue ${h.queue} · events ${h.open_events}`}catch(e){$('#health').textContent='offline'}}
 
 function personOptions(sel){
@@ -157,7 +158,7 @@ <h1>FACEID</h1>
     main.innerHTML=backfillRow(bf)+'<div class="empty">No unknown faces in the queue.</div>';return}
   const excluded=window._excludedIds||(window._excludedIds=new Set());
   const n2s={}; Object.entries(persons).forEach(([sl,p])=>{n2s[p.name]=sl;});
-  const SUGGEST=0.40;
+  const SUGGEST=suggestThr;
   // Vorschlags-Gruppen (nach vermuteter Person) + Rest-Cluster
   const byName={};
   const rest=[];
@@ -358,7 +359,7 @@ <h1>FACEID</h1>
 
 function personCard(slug,p){
   return `
-    <div class="person">
+    <div class="person" id="p-${slug}">
       <div class="head">
         <button class="fav${p.favorite?' on':''}" title="${p.favorite?'remove from favorites':'mark as favorite'}" onclick="toggleFav('${slug}',${p.favorite?0:1})">${p.favorite?'★':'☆'}</button>
         <b>${esc(p.name)}</b><span class="n">${p.count} faces</span>
@@ -387,10 +388,15 @@ <h1>FACEID</h1>
   if(favs.length) body+=`<h2>★ Favorites (${favs.length})</h2>`+favs.map(([s,p])=>personCard(s,p)).join('');
   if(rest.length) body+=`<h2>${favs.length?'Others':'Persons'} (${rest.length})</h2>`+rest.map(([s,p])=>personCard(s,p)).join('');
   if(!entries.length) body='<div class="empty">No persons yet.</div>';
+  const jump=entries.length>3?`
+      <select id="pjump" title="jump to a person" onchange="if(this.value){document.getElementById('p-'+this.value).scrollIntoView({behavior:'smooth',block:'start'});this.value='';}">
+        <option value="">Jump to…</option>${personOptions('')}
+      </select>`:'';
   main.innerHTML=`
     <div class="row">
       <input id="pname" placeholder="New person…" size="18" title="create an empty person, then upload photos or assign faces from the unknown queue">
       <button class="act" onclick="createPerson()">CREATE</button>
+      <span style="flex:1"></span>${jump}
     </div>`+body;
 }
 async function toggleFav(slug,fav){