add a LOG tab to the web UI

App users have Home Assistant's log tab; standalone and container users had to
open a terminal - precisely when they are in the UI wondering why nothing is
recognised. Shows the last 500 lines with a warnings filter and a copy button,
with inference-library noise filtered out.

Author: skycryer

CHANGELOG.md

@@ -3,6 +3,15 @@
 All notable changes to FaceID. The Home Assistant app shows this file in the
 update dialog; standalone users can watch GitHub releases.
 
+## 0.6.11 — 2026-07-26
+
+- **New LOG tab.** The service log is now visible in the web UI — the last 500 lines,
+  refreshing every 5 seconds, with a warnings-only filter and a copy button for pasting
+  into a bug report. Home Assistant app users had the app's log tab; standalone and
+  container users had to reach for `journalctl` or `docker logs`, which is exactly the
+  wrong moment to switch to a terminal when you are trying to find out why nothing is
+  being recognised. Noise from the inference library is filtered out.
+
 ## 0.6.10 — 2026-07-26
 
 - **Fixed: polled events could be processed twice.** The finalizer clears an event from

README.md

@@ -331,6 +331,14 @@ being unusual, it's automatically kept.
 **Full details:** [docs/trimming.md](docs/trimming.md) explains the why, the exact
 selection rule (with numbers), and how to restore or curate set-aside photos.
 
+## Seeing what it is doing
+
+The **LOG tab** shows the last 500 log lines straight in the UI — including the quiet
+cases that decide whether a setup works: whether Frigate answers at startup, which
+cameras were announced to Home Assistant, and for every event whether a face was found
+at all. If nothing is ever recognised, that tab usually says why within a few lines.
+There is a warnings-only filter and a copy button for pasting into an issue.
+
 ## Backup & restore
 
 Your gallery (enrolled persons + ignore anchors) is the one thing you can't regenerate —

app/logbuffer.py

@@ -0,0 +1,57 @@
+"""Die letzten Logzeilen im Speicher halten, damit die Web-UI sie zeigen kann.
+
+Wer FaceID als Home-Assistant-App betreibt, hat den Log-Tab der App. Standalone und
+im Container liegt das Log dagegen in journalctl bzw. `docker logs` — beides sieht
+niemand, der gerade in der Oberfläche nach dem Grund sucht, warum nichts erkannt wird.
+"""
+import logging
+import re
+from collections import deque
+
+# Rauschen der Inferenz-Bibliothek, das im UI-Log nur ablenkt.
+_NOISE = re.compile(r"pthread_setaffinity_np|Applied providers|find model:|model ignore:|"
+                    r"set det-size|FutureWarning|tform\.estimate")
+
+
+class RingBufferHandler(logging.Handler):
+    def __init__(self, capacity: int = 500):
+        super().__init__()
+        self.records: deque = deque(maxlen=capacity)
+
+    def emit(self, record: logging.LogRecord):
+        try:
+            msg = record.getMessage()
+            if _NOISE.search(msg):
+                return
+            self.records.append({
+                "ts": record.created,
+                "level": record.levelname,
+                "logger": record.name.removeprefix("faceid."),
+                "msg": msg if len(msg) <= 2000 else msg[:2000] + " …",
+            })
+        except Exception:      # ein kaputter Logeintrag darf nichts umbringen
+            pass
+
+    def tail(self, limit: int = 300, level: str | None = None):
+        items = list(self.records)
+        if level in ("WARNING", "ERROR"):
+            wanted = {"WARNING", "ERROR", "CRITICAL"} if level == "WARNING" else {"ERROR", "CRITICAL"}
+            items = [r for r in items if r["level"] in wanted]
+        return items[-limit:]
+
+
+_handler: RingBufferHandler | None = None
+
+
+def install(capacity: int = 500) -> RingBufferHandler:
+    """Am Root-Logger einhängen; mehrfacher Aufruf liefert denselben Puffer."""
+    global _handler
+    if _handler is None:
+        _handler = RingBufferHandler(capacity)
+        _handler.setLevel(logging.INFO)
+        logging.getLogger().addHandler(_handler)
+    return _handler
+
+
+def buffer() -> RingBufferHandler | None:
+    return _handler

app/main.py

@@ -6,6 +6,7 @@
 import uvicorn
 import yaml
 
+from . import logbuffer
 from .engine import FaceEngine
 from .frigate_api import FrigateAPI
 from .gallery import Gallery
@@ -16,6 +17,7 @@
 BASE = Path(__file__).resolve().parent.parent
 
 logging.basicConfig(level=logging.INFO, format="%(asctime)s %(name)s %(levelname)s %(message)s")
+logbuffer.install()   # damit die Weboberflaeche das Log zeigen kann
 log = logging.getLogger("faceid")
 
 

app/webui.py

@@ -16,6 +16,7 @@
 from fastapi.staticfiles import StaticFiles
 from pydantic import BaseModel
 
+from . import logbuffer
 from .engine import FaceEngine, crop_face, find_face_padded
 from .backup_util import build_backup_gz, write_backup_file, prune_backups
 from pathlib import Path as _P
@@ -420,6 +421,15 @@ async def restore(file: UploadFile, merge: bool = False):
         return {"restored_files": added, "mode": "merge" if merge else "replace",
                 "persons": len(gallery.persons())}
 
+    @app.get("/api/logs")
+    def logs(limit: int = 300, level: str | None = None):
+        """Die letzten Logzeilen — im Container und standalone sonst nur per Terminal
+        einsehbar, genau wenn man wissen will warum nichts erkannt wird."""
+        buf = logbuffer.buffer()
+        if buf is None:
+            return {"lines": [], "note": "Log-Puffer nicht aktiv"}
+        return {"lines": buf.tail(max(1, min(limit, 500)), level)}
+
     @app.get("/api/health")
     def health():
         # "queue" ist die Review-Queue — das ist es, was der Header zeigt. Die interne

faceid-addon/CHANGELOG.md

@@ -3,6 +3,15 @@
 All notable changes to FaceID. The Home Assistant app shows this file in the
 update dialog; standalone users can watch GitHub releases.
 
+## 0.6.11 — 2026-07-26
+
+- **New LOG tab.** The service log is now visible in the web UI — the last 500 lines,
+  refreshing every 5 seconds, with a warnings-only filter and a copy button for pasting
+  into a bug report. Home Assistant app users had the app's log tab; standalone and
+  container users had to reach for `journalctl` or `docker logs`, which is exactly the
+  wrong moment to switch to a terminal when you are trying to find out why nothing is
+  being recognised. Noise from the inference library is filtered out.
+
 ## 0.6.10 — 2026-07-26
 
 - **Fixed: polled events could be processed twice.** The finalizer clears an event from

faceid-addon/app/logbuffer.py

@@ -0,0 +1,57 @@
+"""Die letzten Logzeilen im Speicher halten, damit die Web-UI sie zeigen kann.
+
+Wer FaceID als Home-Assistant-App betreibt, hat den Log-Tab der App. Standalone und
+im Container liegt das Log dagegen in journalctl bzw. `docker logs` — beides sieht
+niemand, der gerade in der Oberfläche nach dem Grund sucht, warum nichts erkannt wird.
+"""
+import logging
+import re
+from collections import deque
+
+# Rauschen der Inferenz-Bibliothek, das im UI-Log nur ablenkt.
+_NOISE = re.compile(r"pthread_setaffinity_np|Applied providers|find model:|model ignore:|"
+                    r"set det-size|FutureWarning|tform\.estimate")
+
+
+class RingBufferHandler(logging.Handler):
+    def __init__(self, capacity: int = 500):
+        super().__init__()
+        self.records: deque = deque(maxlen=capacity)
+
+    def emit(self, record: logging.LogRecord):
+        try:
+            msg = record.getMessage()
+            if _NOISE.search(msg):
+                return
+            self.records.append({
+                "ts": record.created,
+                "level": record.levelname,
+                "logger": record.name.removeprefix("faceid."),
+                "msg": msg if len(msg) <= 2000 else msg[:2000] + " …",
+            })
+        except Exception:      # ein kaputter Logeintrag darf nichts umbringen
+            pass
+
+    def tail(self, limit: int = 300, level: str | None = None):
+        items = list(self.records)
+        if level in ("WARNING", "ERROR"):
+            wanted = {"WARNING", "ERROR", "CRITICAL"} if level == "WARNING" else {"ERROR", "CRITICAL"}
+            items = [r for r in items if r["level"] in wanted]
+        return items[-limit:]
+
+
+_handler: RingBufferHandler | None = None
+
+
+def install(capacity: int = 500) -> RingBufferHandler:
+    """Am Root-Logger einhängen; mehrfacher Aufruf liefert denselben Puffer."""
+    global _handler
+    if _handler is None:
+        _handler = RingBufferHandler(capacity)
+        _handler.setLevel(logging.INFO)
+        logging.getLogger().addHandler(_handler)
+    return _handler
+
+
+def buffer() -> RingBufferHandler | None:
+    return _handler

faceid-addon/app/main.py

@@ -6,6 +6,7 @@
 import uvicorn
 import yaml
 
+from . import logbuffer
 from .engine import FaceEngine
 from .frigate_api import FrigateAPI
 from .gallery import Gallery
@@ -16,6 +17,7 @@
 BASE = Path(__file__).resolve().parent.parent
 
 logging.basicConfig(level=logging.INFO, format="%(asctime)s %(name)s %(levelname)s %(message)s")
+logbuffer.install()   # damit die Weboberflaeche das Log zeigen kann
 log = logging.getLogger("faceid")
 
 

faceid-addon/app/webui.py

@@ -16,6 +16,7 @@
 from fastapi.staticfiles import StaticFiles
 from pydantic import BaseModel
 
+from . import logbuffer
 from .engine import FaceEngine, crop_face, find_face_padded
 from .backup_util import build_backup_gz, write_backup_file, prune_backups
 from pathlib import Path as _P
@@ -420,6 +421,15 @@ async def restore(file: UploadFile, merge: bool = False):
         return {"restored_files": added, "mode": "merge" if merge else "replace",
                 "persons": len(gallery.persons())}
 
+    @app.get("/api/logs")
+    def logs(limit: int = 300, level: str | None = None):
+        """Die letzten Logzeilen — im Container und standalone sonst nur per Terminal
+        einsehbar, genau wenn man wissen will warum nichts erkannt wird."""
+        buf = logbuffer.buffer()
+        if buf is None:
+            return {"lines": [], "note": "Log-Puffer nicht aktiv"}
+        return {"lines": buf.tail(max(1, min(limit, 500)), level)}
+
     @app.get("/api/health")
     def health():
         # "queue" ist die Review-Queue — das ist es, was der Header zeigt. Die interne

faceid-addon/config.yaml

@@ -1,5 +1,5 @@
 name: FaceID
-version: "0.6.10"
+version: "0.6.11"
 slug: faceid
 description: Face recognition for Frigate — trainable gallery, clustered unknown review, HA sensors
 url: https://github.com/SkyTechNerds/faceid