v1.1.1 – Lizenz und Icon

Keine Änderungen am Verhalten der Integration – dieses Release bringt die
Repository-Metadaten in Ordnung, an denen die HACS-Prüfung seit dem ersten
Commit gescheitert ist.

• Lizenz: Das Projekt steht jetzt unter der GNU General Public License
  v3.0, der vollständige Text liegt in LICENSE. Home Assistant selbst ist
  Apache-2.0-lizenziert und damit mit der GPLv3 verträglich.
• Icon: Neue Brand-Assets unter custom_components/vcvideo_nvr/brand/
  (icon.png 256×256, icon@2x.png 512×512). Dort sucht HACS zuerst, bevor
  es auf das home-assistant/brands-Repository zurückfällt. Das Icon zeigt
  einen generischen Rekorder mit Objektiv, Aufnahme-Leuchte und Status-LEDs –
  es ist kein Logo von VC Germany und trägt keinen Schriftzug.

Offen bleibt die HACS-Prüfung topics: mindestens ein Repository-Topic muss
in den Repository-Einstellungen gesetzt werden, das lässt sich nicht aus einem
Workflow heraus erledigen.

v1.1.0 – Vorschaubilder

🖼️ Vorschaubilder werden endlich angezeigt

Der Live-Stream lief, das Vorschaubild blieb leer. Ursache: die Integration
holte Standbilder von /cgi-bin/snapshot.cgi – einem Endpunkt, den diese
NVR-Baureihe gar nicht kennt. async_camera_image lieferte deshalb immer
None und Home Assistant meldete "Unable to get image".

Neu:

• Die Integration prüft einmalig im Hintergrund, ob der NVR überhaupt einen
  HTTP-Snapshot-Endpunkt anbietet. Antworten werden anhand der Magic Bytes
  geprüft, damit eine als image/jpeg ausgelieferte HTML-Fehlerseite nicht
  als Bild durchgeht.
• Hat der NVR keinen Endpunkt (der Normalfall), wird das Vorschaubild per
  FFmpeg als Einzelbild aus dem RTSP-Substream geholt – innerhalb der
  10 Sekunden, die Home Assistant dafür einräumt.
• Bilder werden kurz zwischengespeichert und Anfragen pro Kamera serialisiert,
  damit ein Dashboard mit vielen Karten nicht für jede Karte einen eigenen
  FFmpeg-Prozess startet.
• Neuer Optionen-Dialog: Quelle für Vorschaubilder (automatisch, Substream,
  Hauptstream, HTTP-Snapshot, aus) sowie die FFmpeg-Eingabeoptionen
  (Standard -rtsp_transport tcp).

🐛 Weitere Fehlerbehebungen

• Benutzername und Passwort werden in RTSP-URLs URL-kodiert. Ein Passwort
  mit @, : oder Leerzeichen erzeugte bisher eine unbrauchbare Stream-URL.
• Die Substream-URL (inklusive Passwort) wird nicht mehr als Zustandsattribut
  veröffentlicht.
• Abgelaufene Sitzungen, die der NVR mit HTTP 200 und einem Fehlercode meldet,
  werden erkannt und lösen eine erneute Anmeldung aus.
• Der Schritt "Neu konfigurieren" brach immer mit already_configured ab,
  weil er die Prüfung des Einrichtungs-Schritts wiederverwendet hat.
• Neuer Reauth-Dialog, wenn der NVR die Zugangsdaten nicht mehr akzeptiert.
• channel_param wird sowohl als Objekt mit items als auch als reine Liste
  akzeptiert.
• Der Login-Token wird auch aus dem JSON-Body gelesen, falls eine Firmware den
  Header X-csrftoken nicht sendet.
• Ein überflüssiger dritter Kanal-Abruf beim Setup entfällt; das Entladen der
  Integration verträgt einen fehlenden Koordinator.
• Kanäle, die der NVR als getrennt meldet, werden als nicht verfügbar
  markiert.
• Die API-Tests prüften eine Token-Quelle, die es im Code nie gab. Sie sind
  neu geschrieben und laufen jetzt in der CI mit.

⚠️ Hinweis

Für die Vorschaubilder wird FFmpeg benötigt. In Home Assistant OS,
Container und Supervised ist es bereits enthalten.

v1.0.1 – Connection fixes

🐛 Critical Bug Fixes

Die v1.0.0 hatte einen "Unknown error" Bug beim Einrichten. Drei Ursachen, alle gefixt:

Was war kaputt?

1. aiohttp.DigestAuth existiert in aiohttp 3.10+ nicht mehr → war DigestAuthMiddleware
2. NVR liefert den CSRF-Token im Response-Header X-csrftoken, nicht im JSON-Body
3. Der RTSP-URL-Pfad war falsch — korrekt ist /chNN/0 (main) bzw. /chNN/1 (sub)

Live getestet ✅

Komplette Integration gegen echten NVR getestet:

LOGIN OK, token len: 64
DEVICE channels: 16
CHANNELS: 16 found
  IP_CH1 [Online] -> rtsp://admin:***@nvr:554/ch01/0
  IP_CH2 [Online] -> rtsp://admin:***@nvr:554/ch02/0
  ...
HEARTBEAT: True

Update via HACS

HACS → VCVideo NVR → ⋮ → Redownload → Version 1.0.1 wählen → HA neu starten.

v1.0.0 – Initial Release

VCVideo NVR – Initial Release 🎉

Features

• Lokale Integration für VCVideo NVR Recorder (entwickelt von VC Germany)
• Auto-Discovery aller Kamera-Kanäle via NVR-API (/API/Login/ChannelInfo/Get)
• RTSP Live-Streams (Haupt- + Substream) für jede Kamera
• Snapshot-Bilder
• Online/Offline Status pro Kanal
• Heartbeat zur Session-Erhaltung
• Konfiguration komplett über die HA-UI (kein YAML)
• Deutsch & Englisch

Voraussetzungen

• Home Assistant 2026.5.0 oder neuer
• NVR im lokalen Netzwerk erreichbar (HTTP Port 80, RTSP Port 554)

Installation via HACS

1. HACS → Custom Repository → URL dieses Repos → Kategorie Integration
2. "VCVideo NVR" suchen → Download
3. HA neu starten
4. Einstellungen → Geräte & Dienste → Integration hinzufügen → VCVideo NVR