[Announce] VDR Plugin eventpub

Zabrimus · November 6, 2025 at 3:47 PM

Das Plugin habe ich für mich geschrieben, weil ich (nicht nur aus dem VDR) Events senden will und andere Systeme auf diese Events reagieren sollen.
Ich habe mir verschiedene Konfigurationen angesehen, u.a. Kafka, ActiveMQ, blazingmq und nein... alles viel zu schwergewichtig und zu kompliziert und im Falle blazingmq ist der Build gewöhnungsbedürftig. Dann bin ich über NATS gestolpert und habe mich spontanverliebt. Extrem leichtgewichtig, kaum Abhängigkeiten und erfüllt alle meine Erwartungen.

Die Homepage des Plugins und die Dokumentation befindet sich auf Github: https://github.com/Zabrimus/vdr-plugin-eventpub.

Zum Plugin:
Aus dem VDR heraus werden messages gesendet (aktuell bisher nur über cStatus generiert), die dann von irgendwelchen Consumern im Netz gelesen und verarbeitet werden können. Dazu muss ein NATS Server (oder in meinem Fall sogar ein Cluster) installiert werden. Die einfache Installation habe ich auf der Homepage des Plugins beschrieben.

Die möglichen Messages haben ein Subject, die von den Consumern gefiltert werden können. Entweder global vdr.> oder nur bestimmte vdr.recording.end.*. Im Setup des Plugins kann eingestellt werden, welche Messages mit welcher TTL (time to live) erzeugt werden sollen. Dazu wird Jetstream zur Persistenz im NATS Server verwendet. So kann ich speichern lassen, wann z.B welcher Timer angelegt/gelöscht wird, welche Aufnahmen wann gestartet und beendet werden - ohne die VDR immer im Auge haben zu müssen. Mein TTL liegt bei 720 Stunden, also kann ich die Aktivitäten über einen Monat lang verfolgen (natürlich nur Timer und Recording, die anderen lasse ich nicht senden).

Es gibt bestimmt eine Begrenzung für die Anzahl der Consumer, wo auch immer diese liegen mag.

Code

vdr.timer.add.VDRNAME
vdr.timer.del.VDRNAME
vdr.channelswitch.VDRNAME
vdr.recording.start.VDRNAME
vdr.recording.stop.VDRNAME
vdr.replay.start.VDRNAME
vdr.replay.stop.VDRNAME
vdr.volume.absolute.VDRNAME
vdr.volume.relative.VDRNAME
vdr.audiotrack.VDRNAME
vdr.audiochennel.VDRNAME
vdr.subtitletrack.VDRNAME
vdr.osdstatusmessage.VDRNAME
vdr.osdchannel.VDRNAME

Display More

Im Verzeichnis nats-receiver befindet sich ein NATS Client, der genutzt werden kann um für bestimmte Subjects ein Script aufzurufen mit allen notwendigen Parametern.

Ich habe 2 völlig getrennte VDR Aufnahmeserver (sowohl Video als auch Timer) und markad in jeweils eigenen Containern. Im Verzeichnis nats-receiver/markad befinden sich ein Beispielscript und eine systemd Unit. Der nats-receiver wurde auf das Subject vdr.recording.stop.* konfiguriert. Und damit wird jetzt markad aufgerufen, sobald eine Aufnahme beendet wurde (unabhängig vom Aufnahmeserver) und die Aufnahmen werden sequentiell der Reihe nach geschnitten.

Für das Gegenstück eventsub überlege ich noch, was sinnvoll ist. Ziel ist eine bessere Vernetzung der VDR und die Möglichkeit auf bestimmte Ereignisse flexibel reagieren zu können oder auch die Konfiguration aller VDR zu vereinfachen. Ich denke da z.B. an den Abgleich der channels.conf in allen VDR.

seahawk1986 · November 7, 2025 at 9:47 AM

Geht das nur mir so, oder ist die Dokumentation in https://natsbyexample.com/examples/auth/sys-account/cli bzw. https://github.com/Zabrimus/vdr-p…r-configuration fehlerhaft?

Code

accounts: {
  \$SYS: {
    users: [{user: sys, password: pass}]
  }
}

Bei mir funktioniert die Kommunikation mit dem Server über nats nur, wenn ich den Backslash vor $SYS weglasse.

In den bisherigen Ubuntu-Versionen sind die Pakete für die Nutzung von jetstream zu alt, da muss ich mal schauen, was zurückportierbar ist.

Zabrimus · November 7, 2025 at 10:23 AM

Quote from seahawk1986

Bei mir funktioniert die Kommunikation mit dem Server über nats nur, wenn ich den Backslash vor $SYS weglasse.

Ich denke, du hast das cat << EOF > /etc/nats-server.conf am Anfang übersehen. Ansonsten wird $SYS ersetzt durch einen höchstwahrscheinlich leeren String. Im File muss aber tatsächlich $SYS stehen.

Quote from seahawk1986

In den bisherigen Ubuntu-Versionen sind die Pakete für die Nutzung von jetstream zu alt, da muss ich mal schauen, was zurückportierbar ist.

Für Jetstream und vor allen Dingen TTL sollten unbedingt die neueren Server verwendet werden, da im Server einiges diesbezüglich gefixed wurde.

seahawk1986 · November 7, 2025 at 10:29 AM

Ah, das wird ja noch von der Shell evaluiert

seahawk1986 · November 7, 2025 at 12:54 PM

Wie kann ich das denn am besten debuggen, wenn das Plugin beim Senden von Events einen generischen Fehler wirft? So etwas wie

Code

Nov 07 11:33:24 yavdr-noble-vm vdr[5446]: [5446] [eventpub] js_PublishMsg: 1 - Error

ist leider nicht so aussagekräftig ... - ich habe die libnats.c Bibliothek in Version 3.11 von Ubuntu 25.10 genommen und die hat klaglos gebaut.

Ich kann auch grundsätzlich mit einem Python-Skript unter anderem Namen/Subject über Jetstream Nachrichten von dem selben Rechner aus absetzen:

Python

#!/usr/bin/env python3
import asyncio
from nats import NATS


async def main():
    nc = NATS()
    await nc.connect(servers=["nats://192.168.1.173:4222"])
    js = nc.jetstream()

    await js.add_stream(name="testevents", subjects=["test"])
    for i in range(10):
        ack = await js.publish("test", f"test {i}".encode())
        print(ack)

    await nc.close()

if __name__ == "__main__":
    asyncio.run(main())

Display More

Zabrimus · November 7, 2025 at 5:30 PM

Quote from seahawk1986

[eventpub] js_PublishMsg: 1 - Error

Wenn der soweit gekommen ist, dann soll nur noch die Nachricht gesendet werden. Die Connection, die Message und alles andere hat funktioniert.
Ich habe einen Verdacht: Hast du eine TTL im Setup konfiguriert oder steht die noch bei 0? Ich probiere es direkt mal aus.

Edit: Jup. TTL 0 wirft genau den Fehler. Ich fix das.

Zabrimus · November 8, 2025 at 5:02 PM New

Ich gebe jetzt auch den jsErrorCode (jerr) mit aus, falls vorhanden. Im Fehlerfall kann man den dann nachschlagen um hoffentlich mehr Informationen zu bekommen.

z.B.

Code

nats errors lookup 10058

[Announce] VDR Plugin eventpub

Participate now!

Users Viewing This Thread