[Modul] Reolink

Reolink für IP-Symcon

Inhaltsverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Software-Installation
  4. Einrichtung der Instanzen in IP-Symcon
  5. Statusvariablen und Profile
  6. WebFront
  7. Webhook
  8. Versionen

1. Funktionsumfang

Dieses Modul integriert Reolink-Kameras vollständig in IP-Symcon, mit Schwerpunkt auf der Webhook-Integration.
Die Webhook-Funktion erlaubt es, Ereignisse der Kamera (z. B. Bewegung, Person, Tier, Fahrzeug, Besucher) in Echtzeit an IP-Symcon zu übertragen — ohne Polling und nahezu verzögerungsfrei.

Hauptfunktionen

  • Echtzeit-Verarbeitung über Webhook: Auslösen bei Personen-, Tier-, Fahrzeug- und Bewegungsereignissen
  • Automatische Schnappschüsse bei jeder erkannten Bewegung
  • Bildarchiv-Funktion mit frei definierbarer Anzahl gespeicherter Bilder
  • Intelligente Bewegungserkennung (Person, Tier, Fahrzeug, Besucher) als IP-Symcon-Variablen
  • RTSP-Stream-Integration (Main- oder Substream auswählbar)
  • API-Funktionen zur Kamerasteuerung:
    • LED-Licht (Ein/Aus, Helligkeit, Automatik)
    • E-Mail-Benachrichtigung
    • PTZ-Steuerung mit Presets und Zoom
  • Automatische Webhook-Erstellung in IP-Symcon
  • Optimierte IP-Adress-Erkennung (Sollte nun auch unter Linux-Systemen funktionieren)

Unterstützte Kameras (getestet)

Modell Webhook Bemerkung
Reolink Duo 2 :white_check_mark: Voll unterstützt
Reolink RLC-810A :white_check_mark: Empfohlen
Reolink Doorbell :white_check_mark: Besucher-Erkennung aktivierbar
Reolink E1 Outdoor :warning: Nur bestimmte Hardware-Revisionen
Reolink RLC-520A :white_check_mark: Voll unterstützt
Reolink E1 Zoom :white_check_mark: Unterstützt PTZ
Reolink E540 :white_check_mark: Voll unterstützt

:warning: Akkubetriebene Modelle (z. B. Argus-Reihe) unterstützen keine Webhooks.
Diese können nur über Polling angebunden werden (eingeschränkt getestet).


2. Voraussetzungen

  • IP-Symcon ab Version 7.0
  • Kamera muss HTTP / HTTPS-Zugriff zulassen
  • Im Kameramenü unter Push Notifications → Webhook muss ein Eintrag möglich sein
  • Aktuellste Firmware über das Reolink Download-Center
  • Bei Kameras ohne Webhook kann Polling aktiviert werden (mit Latenz)

3. Software-Installation

Das Modul kann direkt über den IP-Symcon Module Store installiert werden.


4. Einrichtung der Instanzen in IP-Symcon

Instanz hinzufügen

  • Unter Instanz hinzufügen das Modul Reolink auswählen.

Konfigurationsparameter

Name Beschreibung
Webhook Wird automatisch erzeugt. Dieser Pfad muss exakt im Kamera-Menü unter Push → Webhook eingetragen werden.
Instanz aktivieren Deaktiviert die Instanz temporär, um Fehlermeldungen zu vermeiden.
IP-Adresse IP-Adresse der Kamera.
Benutzername Benutzername für den Zugriff.
Passwort Passwort für den Zugriff. Sonderzeichen wie + & @ : / ? # [ ] dürfen nicht verwendet werden, da Reolink diese in URLs nicht korrekt verarbeitet. Verwende ausschließlich alphanumerische Zeichen.
Stream-Typ Auswahl zwischen Mainstream und Substream. Achtung: Mainstream ist oft H.265-codiert und kann von IP-Symcon nicht direkt angezeigt werden.
API-Funktionen Aktivien der API-Funktionen für LED-Scheinwerfer, E-Mail Alarm und PTZ-Steuerung, FTP-Upload, Sirene, Kameraaufzeichnung und Sensitivität der Bewegungserkennung. Eine Rücksetzung des API-Versins Cache ist möglich, falls die Firmware der Kamera nach einem Update die neue API unterstützt
Polling aktivieren Nur aktivieren, wenn die Kamera keinen Webhook unterstützt.
Intelligente Bewegungserkennung Erstellt Variablen für Personen, Tiere, Fahrzeuge, Bewegung und Besucher.
Schnappschüsse anzeigen Zeigt den letzten Schnappschuss jeder Erkennungsart.
Bildarchive anzeigen Erstellt Archive mit Schnappschüssen; Anzeige über separate Verlinkung im WebFront.
Anzahl Archivbilder Maximale Bildanzahl pro Archiv (Standard 20).
Test-Elemente anzeigen Fügt Test-Variablen und Test-Snapshots hinzu (nur zur Diagnose).
Besucher-Erkennung Aktiviert Klingel-Erkennung (nur Doorbell-Modelle).

5. Statusvariablen und Profile

Statusvariablen

Je nach Konfiguration werden automatisch angelegt:

Variable Typ Beschreibung
Person Boolean Bewegung durch Person erkannt
Tier Boolean Bewegung durch Tier erkannt
Fahrzeug Boolean Bewegung durch Fahrzeug erkannt
Bewegung Boolean Allgemeine Bewegung erkannt
Besucher Boolean Besucher erkannt (Doorbell)
WhiteLed / Mode / Bright Integer / Boolean LED-Licht-Parameter
EmailNotify / Interval / Content Integer / Boolean E-Mail-Steuerung
PTZ_HTML String HTML-Element für PTZ-Steuerung

Profile

Profilname Typ Beschreibung
REOCAM.WLED Integer LED-Modus (Aus / Auto / Zeit)
REOCAM.EmailInterval Integer Versandintervall
REOCAM.EmailContent Integer E-Mail-Inhalt (Text / Bild / Video)

6. WebFront

  • Anzeige des Live-Streams über RTSP-Medienobjekt
  • Darstellung der Schnappschüsse und Bildarchive
  • Direkte PTZ-Steuerung über ein integriertes HTML-Element
  • Klare Trennung der Ereignis-Kategorien (Person, Tier, Fahrzeug, Besucher)

7. Webhook

  • Der Webhook wird bei Instanz-Erstellung automatisch registriert.
  • Der vollständige Pfad wird im Formular angezeigt.
  • Dieser muss in der Kamera unter Push → Webhook eingetragen werden.
  • Unterstützt POST-Payloads der Reolink-API sowie zusätzliche Status-Updates.
  • Funktioniert über Symcon Connect (extern) und lokal.
  • Unter Linux wird automatisch die korrekte lokale IP ermittelt (nicht 127.0.1.1).

8. Versionen

Version 2.11 (28.10.2025)

  • API-Abfrage und Debug-Log weiter umgebaut und vereinheitlicht.
  • Zurücksetzen des Versions-Cache in die API-Funktionen eingefügt, falls Kammera nach Update die neue API unterstützt.
  • Konfiguratisonsformular überarbeitet.

Version 2.10 (26.10.2025)

  • Einige Variablen konnten nicht über das Konfigurationsformular gelöscht werden.
  • API-Punkt ‚FTP-Upload‘, ‚Sensitivität‘, ‚Kameraaufzeichnung‘ und ‚Sirene‘ hinzugefügt.
  • Weitere Code-Optimierungen

Version 2.9 (23.10.2025)

  • Verbesserte Erkennung der Server-IP-Adresse im Konfigurationsformular
  • Einige Variablen konnten nicht über das Konfigurationsformular gelöscht werden
  • API-Punkt ‚FTP-Upload‘ hinzugefügt

Version 2.8 (30.09.2025)

  • Neuer Schalter Instanz deaktivieren
  • Vollständiger Webhook-Pfad im Formular
  • Überarbeitete Debug-Ausgabe
  • Optimierte API-Abfragen

Version 2.7 (04.09.2025)

  • Neue API-Funktion PTZ-Steuerung (Zoom & Presets)
  • Eigene Rubrik für API-Funktionen im Formular

Version 2.6 (25.08.2025)

  • Neue API-Funktion E-Mail-Versand
  • Diverse interne Code-Anpassungen

Version 2.5 (15.06.2025)

  • Code-Optimierungen für LED-Parameter

Version 2.4 (14.02.2025)

  • urlencode()-Erweiterung für einfache Sonderzeichen

Version 2.3 (02.01.2025)

  • Fehlerbehebung bei Instanz-Erstellung
  • Verbesserte Debug-Ausgabe und API-Verarbeitung

Version 2.2 (28.12.2024)

  • Verbesserte Fehlerbehandlung in SendApiRequest
  • Automatische Aktualisierung der API-Werte

Version 2.1 (22.12.2024)

  • Anpassung Modulname
  • Überarbeitete Readme-URL

Version 2.0 (07.12.2024)

  • Vorbereitung auf Store-Kompatibilität
  • Diverse interne Anpassungen

Version 1.2 (19.11.2024)

  • Unterstützung für Kameras ohne Webhook (Polling)

Version 1.1 (17.11.2024)

  • Unterstützung Doorbell
  • Neue API-Funktion LED-Licht

Version 1.0 (16.11.2024)

  • Initiale Beta-Version

  1. Lizenz
    Dieses Modul steht unter der MIT-Lizenz.
    © 2025 Stefan Künzli
    The MIT License – Open Source Initiative
1 „Gefällt mir“

Tolle Nachrichten! Danke für das Modul!
Werde das gleich mal mit meinen Trackmix und E1 Pro Cams testen!

coole Sache.

würde mir das Modul auch helfen, wenn ich den Reolink Netzwerkrekorder nutze.
ich kann meine Kameras nicht direkt erreichen, sondern nur über den Rekorder

Mega, genau darauf hab ich gewartet :slight_smile:

Erster eindruck Top. Hab es mit der 810a und der Doorbell getestet.

Meinst du du könntest für die Doorbett noch den Webhook „Visitor“ einbinden?

dann hat man auch den Klingelknopf in IPS…

17.11.2024, 09:44:47 | Raw Webhook Data | {„alarm“:{„alarmTime“:„2024-11-17T08:44:46.000+0000“,„channel“:0,„channelName“:„Reolink Video Doorbell PoE“,„device“:„Reolink Video Doorbell PoE“,„deviceModel“:„Reolink Video Doorbell PoE“,„message“:„Visitor Detected from Reolink Video Doorbell PoE“,„name“:„Visitor Alert“,„title“:„Visitor message“,„type“:„VISITOR“}}

Viele Grüße
Stephan

Danke fürs Testen und melden der funktionierenden 810a
Ich habe eine neue beta im Store, wo im Konfigurationsformular für Doorbell-Besitzer die Besuchererkennung aktiviert werden kann.
Bin gespannt obs funktioniert, habe keine Doorbell…

Ich denke, das wird eher schwierig, da total andere Konstellation und keine Testmöglichkeit…

Klingeltaster wird erfolgreich gemeldet. Danke!

Viele Grüße
Stephan

Vorfreude war groß - Ernüchterung kam schnell :sleepy:

Akkubetriebene Kameras haben kein WebInterface (und somit vermutlich auch kein WebHook), sondern lediglich einen Zugriff über die Reolink App.
In meinem Fall eine Argus 3 Pro…

Äußerst Schade…

Ich hab leider weder bei meinen Trackmix noch bei der E1 Pro Outdoor die Möglichkeit finden können, einen Webhook einzutragen.
Wenn Du das Modul erweitertes, wäre es toll, wenn Du noch die Scheinwerfersteuerung behandelst.
Ich würde sie gerne nachts auf Automodus einstellen - nicht jedoch, wenn ich zu Hause bin. Das wäre toll. Mit dem Reolink Modul läufst Du hier allerdings offene Türen ein. Das ist mir auch klar :slight_smile:

Neuste Firmware drauf? Ich hab festgestellt das in der App mir nicht die neuste Version angezeigt wurde. Auf der Reolink Webseite gab es dann plötzlich neue Versionen für meine Kameras. Die hatten dann auch die relativ neue Funktion mit den Webhook drin. Die webhook stellst du unter dem Punkt Push ein.

Gruß
Stephan

E1 Outdoor (nicht Pro) habe ich heute bei einem Bekannten getestet, auch mit der neusten FW kein Webhook. Daher habe ich diese schon mal in die Liste der nicht kompatiblen Kameras aufgenommen…
Aber richtig, so wie ich gelesen habe hat die Doorbell ganz neu eine Unterstützung für Webhook.

Ich habe mich nun an die API rangemacht und schon mal das Ein- und Ausschalten der LED realisiert. Wenn du also die neuste beta installierst hast du einen neuen Schalter im Konfigurationsformular (API-Funktionen). Da werden in Zukunft nützliche Ansteuerungen und Einstellungen möglich sein. Vorerst, wie erwähnt, schon mal die LED zu Testzwecken.
Leider kannst du noch nicht auf Automatisch stellen, aber vorerst könntest du das allenfalls über einen Ablaufplan lösen (Abwesend+Bewegung=LED an)

2 „Gefällt mir“

leider hat keine meiner Reos (akt. Firmware) den Push…

Ja schade, welche Modelle hast du?

E1outdoor, Lumus, Argus3pro, RLC-842A, Duo2Wifi, DuoPoE

Duo2 geht, die habe ich auch.
Prüf nochmals auf der Reolink Downloadseite alle Kameras.
Der Link zum Downloadportal findest du am Anfang dieses Threds in meiner Beschreibung

Vielen Dank für das Modul,

dass erleichtert die Arbeit mit den Kameras ungemein.

Gerne…
Welche Kameramodelle hast du, die funktionieren?

Verdammt, ich habe die RLC 520A_V2 Kameras. Für diese bekommt man aus irgendwelchen Gründen keine Firmware auf der Seite.
Habe jetzt den Support angeschrieben.
Ich habe zwar die neue Benutzeroberfläche auf dem Web Interface aber der Punkt fehlt leider.
Ich verstehe manchmal die Entscheidungen bei Reolink nicht, echt nervig.
Ich werde berichten, ob es eine Version gibt, die das Feature hinzufügt.
Wäre echt zu schön gewesen…

bei mir hat der Download schonmal eine Stunde gedauert (32MB) und dann hat die Cam es nicht akzeptiert, vermutl Korrupt.