log in English

Everything a user reads was English except the log itself - so the diagnostic
lines added over the last releases were unreadable for most of the audience
they were written for, and anyone reporting an issue had to translate first.

Author: skycryer

CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to FaceID. The Home Assistant app shows this file in the
 update dialog; standalone users can watch GitHub releases.
 
+## 0.6.13 — 2026-07-26
+
+- **Log messages are English now.** README, UI, docs and changelog were English while the
+  service logged in German — so anyone reporting a problem had to translate their own log
+  first, and the diagnostic lines added in 0.6.10–0.6.12 were unreadable for most of the
+  people they were written for. All user-facing log output is now English. (Code comments
+  stay German; they are for whoever edits the source, not for whoever runs it.)
+
 ## 0.6.12 — 2026-07-26
 
 - **"No face found" now says which kind.** The log distinguishes *a face was detected but

app/backup_util.py

@@ -55,9 +55,9 @@ def loop():
                         p = write_backup_file(data_dir, backup_dir)
                         prune_backups(backup_dir, int(cfg_faceid.get("backup_keep", 7)))
                         last_day = day
-                        log.info("Auto-Backup geschrieben: %s", p)
+                        log.info("auto backup written: %s", p)
             except Exception:
-                log.exception("Auto-Backup fehlgeschlagen")
+                log.exception("auto backup failed")
             time.sleep(300)  # alle 5 Min prüfen
 
     threading.Thread(target=loop, daemon=True, name="faceid-autobackup").start()

app/frigate_api.py

@@ -24,7 +24,7 @@ def snapshot(self, event_id: str, crop: bool = True) -> np.ndarray | None:
             img = cv2.imdecode(np.frombuffer(r.content, np.uint8), cv2.IMREAD_COLOR)
             return img
         except requests.RequestException as e:
-            log.warning("Snapshot %s fehlgeschlagen: %s", event_id, e)
+            log.warning("snapshot %s failed: %s", event_id, e)
             return None
 
     def recording_frame(self, camera: str, ts: float) -> np.ndarray | None:
@@ -37,7 +37,7 @@ def recording_frame(self, camera: str, ts: float) -> np.ndarray | None:
                 return None
             return cv2.imdecode(np.frombuffer(r.content, np.uint8), cv2.IMREAD_COLOR)
         except requests.RequestException as e:
-            log.debug("Recording-Frame %s@%s fehlgeschlagen: %s", camera, ts, e)
+            log.debug("recording frame %s@%s failed: %s", camera, ts, e)
             return None
 
     def download_clip(self, event_id: str, dest: str, max_bytes: int = 80_000_000) -> bool:
@@ -58,12 +58,12 @@ def download_clip(self, event_id: str, dest: str, max_bytes: int = 80_000_000) -
                             continue
                         written += len(chunk)
                         if written > max_bytes:
-                            log.debug("Clip %s abgebrochen (> %d Bytes)", event_id, max_bytes)
+                            log.debug("clip %s aborted (> %d bytes)", event_id, max_bytes)
                             return False
                         fh.write(chunk)
                 return written > 1000
         except (requests.RequestException, OSError) as e:
-            log.debug("Clip %s fehlgeschlagen: %s", event_id, e)
+            log.debug("clip %s failed: %s", event_id, e)
             return False
 
     def set_sub_label(self, event_id: str, label: str, score: float):
@@ -76,4 +76,4 @@ def set_sub_label(self, event_id: str, label: str, score: float):
             if r.status_code not in (200, 202):
                 log.warning("sub_label %s -> %s: HTTP %s %s", event_id, label, r.status_code, r.text[:200])
         except requests.RequestException as e:
-            log.warning("sub_label %s fehlgeschlagen: %s", event_id, e)
+            log.warning("sub_label %s failed: %s", event_id, e)

app/main.py

@@ -32,8 +32,8 @@ def main():
         try:
             cfg.setdefault("faceid", {}).update(json.loads(settings_f.read_text()))
         except (json.JSONDecodeError, OSError):
-            log.warning("settings.json unlesbar — ignoriert")
-    log.info("Lade InsightFace (buffalo_l) …")
+            log.warning("settings.json unreadable — ignoring it")
+    log.info("loading InsightFace (buffalo_l) …")
     engine = FaceEngine(det_size=int(cfg["faceid"].get("det_size", 640)))
     gallery = Gallery(data_dir,
                       top_k=int(cfg["faceid"].get("match_top_k", 3)),

app/mqtt_listener.py

@@ -85,22 +85,19 @@ def _check_frigate(self):
         try:
             r = requests.get(f"{url}/api/config", timeout=8)
             if r.status_code != 200:
-                log.error("Frigate unter %s antwortet mit HTTP %s — ohne Snapshots kann "
-                          "nicht erkannt werden", url, r.status_code)
+                log.error("Frigate at %s replied HTTP %s — without snapshots nothing can be recognised", url, r.status_code)
                 return
             cams = list((r.json().get("cameras") or {}).keys())
-            log.info("Frigate erreichbar (%s), Kameras: %s", url, ", ".join(cams) or "keine")
+            log.info("Frigate reachable (%s), cameras: %s", url, ", ".join(cams) or "keine")
             if self.cameras:
                 unknown = self.cameras - set(cams)
                 if unknown:
-                    log.warning("Konfigurierte Kamera(s) %s gibt es in Frigate nicht — "
-                                "von diesen wird nie etwas verarbeitet", ", ".join(sorted(unknown)))
+                    log.warning("Configured camera(s) %s do not exist in Frigate — nothing from these will ever be processed", ", ".join(sorted(unknown)))
         except (requests.RequestException, ValueError) as e:
-            log.error("Frigate unter %s nicht erreichbar: %s — Snapshots und damit die "
-                      "Erkennung werden fehlschlagen", url, e)
+            log.error("Frigate at %s unreachable: %s — snapshots, and therefore recognition, will fail", url, e)
 
     def _on_connect(self, client, userdata, flags, reason_code, properties):
-        log.info("MQTT verbunden (%s), abonniere %s/events", reason_code, self.frigate_topic)
+        log.info("MQTT connected (%s), subscribing to %s/events", reason_code, self.frigate_topic)
         client.subscribe(f"{self.frigate_topic}/events")
         client.publish(f"{self.prefix}/status", "online", retain=True)
         self._publish_discovery()
@@ -140,7 +137,7 @@ def _on_message(self, client, userdata, msg):
             try:
                 self.queue.put_nowait({"eid": eid})
             except queue.Full:
-                log.warning("Queue voll, Event %s übersprungen", eid)
+                log.warning("queue full, skipping event %s", eid)
 
     # ---------- Verarbeitung ----------
 
@@ -150,7 +147,7 @@ def _worker(self):
             try:
                 self._process(item["eid"])
             except Exception:
-                log.exception("Fehler bei Event %s", item["eid"])
+                log.exception("error while handling event %s", item["eid"])
 
     def _process(self, eid: str):
         st = self.events.get(eid)
@@ -159,7 +156,7 @@ def _process(self, eid: str):
         st["attempts"] += 1
         img = self.frigate.snapshot(eid, crop=True)
         if img is None:
-            log.info("Event %s (%s): kein Snapshot von Frigate", eid, st["camera"])
+            log.info("event %s (%s): no snapshot from Frigate", eid, st["camera"])
             return
         found = self.engine.faces(img)
         face = FaceEngine.best_face(found, min_px=self.min_face_px)
@@ -172,11 +169,11 @@ def _process(self, eid: str):
             h, w = img.shape[:2]
             if found:
                 big = max(int(f.bbox[2] - f.bbox[0]) for f in found)
-                log.info("Event %s (%s): Versuch %d, groesstes Gesicht %dpx < min_face_px "
+                log.info("event %s (%s): attempt %d, largest face %dpx < min_face_px "
                          "%d (Snapshot %dx%d)", eid, st["camera"], st["attempts"], big,
                          self.min_face_px, w, h)
             else:
-                log.info("Event %s (%s): Versuch %d, kein Gesicht im Snapshot %dx%d",
+                log.info("event %s (%s): attempt %d, no face detected in snapshot %dx%d",
                          eid, st["camera"], st["attempts"], w, h)
             return
         emb = face.normed_embedding
@@ -192,11 +189,11 @@ def _process(self, eid: str):
             if self.ignore_learning and ig >= self.ignore_thr + 0.1 and ig - score >= 0.1:
                 iid = self.gallery.add_ignore_anchor(crop_face(img, face.bbox), emb)
                 if iid:
-                    log.info("Event %s: neuer Auto-Ignore-Anker %s (sim %.3f)", eid, iid, ig)
-            log.info("Event %s (%s): ignoriertes Gesicht (sim %.3f)", eid, st["camera"], ig)
+                    log.info("event %s: new auto ignore anchor %s (sim %.3f)", eid, iid, ig)
+            log.info("event %s (%s): ignored face (sim %.3f)", eid, st["camera"], ig)
             return
         crop = crop_face(img, face.bbox)
-        log.info("Event %s (%s): Versuch %d, Match %s (%.3f)", eid, st["camera"], st["attempts"], name, score)
+        log.info("event %s (%s): attempt %d, match %s (%.3f)", eid, st["camera"], st["attempts"], name, score)
 
         if slug and score >= self.match_thr:
             if score > st["best_score"]:
@@ -236,7 +233,7 @@ def _poller(self):
                     continue
                 batch = r.json()
             except (requests.RequestException, ValueError) as e:
-                log.debug("Poll fehlgeschlagen: %s", e)
+                log.debug("poll failed: %s", e)
                 continue
             since = time.time()
             for ev in batch:
@@ -259,12 +256,12 @@ def _poller(self):
                     "start_time": ev.get("start_time") or time.time(),
                     "end_time": ev.get("end_time"),
                 }
-                log.info("Poll: Ereignis %s (%s) nachgezogen — von MQTT nie gemeldet",
+                log.info("poll: picked up event %s (%s) — never announced over MQTT",
                          eid, cam)
                 try:
                     self.queue.put_nowait({"eid": eid})
                 except queue.Full:
-                    log.warning("Queue voll — Poll-Ereignis %s verworfen", eid)
+                    log.warning("queue full — dropped polled event %s", eid)
 
     def _finalizer(self):
         """Beendete Events abschließen: Unknown ablegen, 'unbekannt' melden, aufräumen."""
@@ -297,7 +294,7 @@ def _finalizer(self):
                             new_w = int(face.bbox[2] - face.bbox[0])
                             if new_w > old_w:
                                 crop, emb, full = crop_face(img, face.bbox), face.normed_embedding, img
-                                log.info("Event %s: hi-res Referenz aus Aufnahme (%dpx statt %dpx)",
+                                log.info("event %s: sharper reference from the recording (%dpx instead of %dpx)",
                                          eid, new_w, old_w)
                     uid = self.gallery.save_unknown(
                         crop, emb,
@@ -307,7 +304,7 @@ def _finalizer(self):
                         full_bgr=full,
                     )
                     self._publish_recognition(eid, st, "unknown", u["guess_score"])
-                    log.info("Event %s: unbekanntes Gesicht abgelegt (%s)", eid, uid)
+                    log.info("event %s: unknown face stored (%s)", eid, uid)
                 self.events.pop(eid, None)
 
     # ---------- Publish ----------
@@ -351,8 +348,7 @@ def _frigate_cameras(self) -> set:
             if r.status_code == 200:
                 return set((r.json().get("cameras") or {}).keys())
         except (requests.RequestException, ValueError) as e:
-            log.warning("Kameraliste von Frigate nicht abrufbar (%s) — Sensoren entstehen "
-                        "dann erst, sobald die erste Person erkannt wird", e)
+            log.warning("could not fetch the camera list from Frigate (%s) — sensors will appear once the first person is seen", e)
         return set()
 
     def _ensure_discovery(self, cam: str):
@@ -377,8 +373,8 @@ def _publish_discovery(self, only: list | None = None):
                     or set(self.cfg["faceid"].get("discovery_cameras") or [])
                     or self._frigate_cameras())
             self._announced |= cams
-            log.info("MQTT-Discovery: %d Sensor(en) angemeldet%s", len(cams),
-                     "" if cams else " — Kameras unbekannt, folgen bei der ersten Erkennung")
+            log.info("MQTT discovery: announced %d sensor(s)%s", len(cams),
+                     "" if cams else " — cameras unknown, they follow on first recognition")
         device = {"identifiers": [self.prefix], "name": self.prefix.replace("-", " ").title() if self.prefix != "faceid" else "FaceID",
                   "manufacturer": "Eigenbau", "model": "InsightFace/ArcFace"}
         for cam in cams:

app/webui.py

@@ -269,7 +269,7 @@ def worker():
                     hires=bool(cfg["faceid"].get("hires_enroll", True)))
                 backfill_state["result"] = stats
             except Exception as e:
-                log.exception("Verlaufs-Scan fehlgeschlagen")
+                log.exception("history scan failed")
                 backfill_state["result"] = {"error": str(e)}
             finally:
                 backfill_state["running"] = False

faceid-addon/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to FaceID. The Home Assistant app shows this file in the
 update dialog; standalone users can watch GitHub releases.
 
+## 0.6.13 — 2026-07-26
+
+- **Log messages are English now.** README, UI, docs and changelog were English while the
+  service logged in German — so anyone reporting a problem had to translate their own log
+  first, and the diagnostic lines added in 0.6.10–0.6.12 were unreadable for most of the
+  people they were written for. All user-facing log output is now English. (Code comments
+  stay German; they are for whoever edits the source, not for whoever runs it.)
+
 ## 0.6.12 — 2026-07-26
 
 - **"No face found" now says which kind.** The log distinguishes *a face was detected but

faceid-addon/app/backup_util.py

@@ -55,9 +55,9 @@ def loop():
                         p = write_backup_file(data_dir, backup_dir)
                         prune_backups(backup_dir, int(cfg_faceid.get("backup_keep", 7)))
                         last_day = day
-                        log.info("Auto-Backup geschrieben: %s", p)
+                        log.info("auto backup written: %s", p)
             except Exception:
-                log.exception("Auto-Backup fehlgeschlagen")
+                log.exception("auto backup failed")
             time.sleep(300)  # alle 5 Min prüfen
 
     threading.Thread(target=loop, daemon=True, name="faceid-autobackup").start()

faceid-addon/app/frigate_api.py

@@ -24,7 +24,7 @@ def snapshot(self, event_id: str, crop: bool = True) -> np.ndarray | None:
             img = cv2.imdecode(np.frombuffer(r.content, np.uint8), cv2.IMREAD_COLOR)
             return img
         except requests.RequestException as e:
-            log.warning("Snapshot %s fehlgeschlagen: %s", event_id, e)
+            log.warning("snapshot %s failed: %s", event_id, e)
             return None
 
     def recording_frame(self, camera: str, ts: float) -> np.ndarray | None:
@@ -37,7 +37,7 @@ def recording_frame(self, camera: str, ts: float) -> np.ndarray | None:
                 return None
             return cv2.imdecode(np.frombuffer(r.content, np.uint8), cv2.IMREAD_COLOR)
         except requests.RequestException as e:
-            log.debug("Recording-Frame %s@%s fehlgeschlagen: %s", camera, ts, e)
+            log.debug("recording frame %s@%s failed: %s", camera, ts, e)
             return None
 
     def download_clip(self, event_id: str, dest: str, max_bytes: int = 80_000_000) -> bool:
@@ -58,12 +58,12 @@ def download_clip(self, event_id: str, dest: str, max_bytes: int = 80_000_000) -
                             continue
                         written += len(chunk)
                         if written > max_bytes:
-                            log.debug("Clip %s abgebrochen (> %d Bytes)", event_id, max_bytes)
+                            log.debug("clip %s aborted (> %d bytes)", event_id, max_bytes)
                             return False
                         fh.write(chunk)
                 return written > 1000
         except (requests.RequestException, OSError) as e:
-            log.debug("Clip %s fehlgeschlagen: %s", event_id, e)
+            log.debug("clip %s failed: %s", event_id, e)
             return False
 
     def set_sub_label(self, event_id: str, label: str, score: float):
@@ -76,4 +76,4 @@ def set_sub_label(self, event_id: str, label: str, score: float):
             if r.status_code not in (200, 202):
                 log.warning("sub_label %s -> %s: HTTP %s %s", event_id, label, r.status_code, r.text[:200])
         except requests.RequestException as e:
-            log.warning("sub_label %s fehlgeschlagen: %s", event_id, e)
+            log.warning("sub_label %s failed: %s", event_id, e)

faceid-addon/app/main.py

@@ -32,8 +32,8 @@ def main():
         try:
             cfg.setdefault("faceid", {}).update(json.loads(settings_f.read_text()))
         except (json.JSONDecodeError, OSError):
-            log.warning("settings.json unlesbar — ignoriert")
-    log.info("Lade InsightFace (buffalo_l) …")
+            log.warning("settings.json unreadable — ignoring it")
+    log.info("loading InsightFace (buffalo_l) …")
     engine = FaceEngine(det_size=int(cfg["faceid"].get("det_size", 640)))
     gallery = Gallery(data_dir,
                       top_k=int(cfg["faceid"].get("match_top_k", 3)),