Streamdev-plugin

Aktuelle Version vom 6. Oktober 2016, 10:25 Uhr

[Bearbeiten] Beschreibung

Das Streamdev Plugin erlaubt das Streamen von Live-TV des VDR zu Streaming Clients.

Streamdev besteht aus zwei Plugins, streamdev-server und streamdev-client. Damit ist auch VDR als Streaming Client nutzbar.

[Bearbeiten] Installation

Beim Kompilieren werden zwei Plugins erzeugt, streamdev-client und streamdev-server.

[Bearbeiten] Konfiguration

Der Zugriff auf den Server wird durch die streamdevhosts.conf konfiguriert.

cp $SOURCEDIR/VDR/PLUGINS/src/streamdev/streamdevhosts.conf.example $VDRCONFIG/plugins/streamdevhosts.conf

Die streamdevhosts.conf muss korrekt konfiguriert werden. Andernfalls erlaubt das Server Plugin kein Streaming zu den Clients!

[Bearbeiten] Konfiguration Client Plugin

Danach muss man in der channels.conf des Clients die Programme hinzufügen, die vom Streaming-Server stammen und in Zukunft von dem 'virtuellen' DVB-Device empfangen werden sollen. Im einfachsten Fall genügt es, auf dem Client eine Kopie der channels.conf des Servers zu installieren. Empfangen Client und Server unterschiedliche Kanal-Quellen (z.B. Server: DVB-S, Client: DVB-T), so werden die Einträge aus der channels.conf des Servers einfach in die des Clients eingefügt.

Es müssen auch nicht alle Kanäle des Server in die channels.conf des Clients aufgenommen werden.

Die Streamdev-Client Einstellungen in VDRs setup.conf:

streamdev-client.StreamFilters = 1
# streamdev-client.SyncEPG = 0
streamdev-client.RemoteIp = 192.168.0.50
streamdev-client.RemotePort = 2004
streamdev-client.StartClient = 1

Filter Streaming (streamdev-client.StreamFilters):
- Voraussetzung hierfür ist eine aktuelle streamdev-Version sowohl auf dem Client als auch auf dem Server (Mai 2007). Der Client wird mit allen relevanten Informationen versorgt, die der Server über die DVB-Karte empfängt (EPG, Kanal-Updates, ...).

EPG synchronisieren (streamdev-client.SyncEPG):
- Diese Funktion wurde in Version 0.5.0 (2010) aus dem Plugin entfernt. Die folgende Beschreibung erlkärt, warum:
- Die EPG-Sync Funktion von streamdev und das Epgsync-plugin machen im großen und ganzen das selbe. Streamdev synchronisiert aber im Vordergrund. Der VDR bleibt komplett blockiert bis der EPG-Sync abgeschlossen ist. Je nachdem wie groß die EPG-Datei auf dem Server ist, kann das dauern. Sofern man trotz Filter Streaming nicht auf eine Synchronisation verzichten kann oder will, empfiehlt sich daher die Verwendung des Epgsync-plugins.

IP-Adresse des Streaming-Servers (streamdev-client.RemoteIp)
VTP-Port auf dem Server (streamdev-client.RemotePort)
streamdev-client.StartClient (streamdev-client.StartClient)

[Bearbeiten] VTP Protokoll

[Bearbeiten] Einleitung

Dieses Protokoll wurde erstellt für Video Übertragungen über das Netzwerk und steht für Video Transfer Protocol. Es ist ein Text basierendes Protokoll wie z.B. FTP, und wird vom Klienten benutzt um mit einem Server zu kommunizieren welcher verschiedene Typen von Videodaten zur Verfügung stellt, wie z.B. Echtzeitübertragungen und Aufnahmen.

Die Grundkommunikation besteht aus kurzen Text Kommandos welche durch den Klient versendet werden und durch den Server in Form eines Nummerncodes und einer Klartextnachricht beantwortet werden. Alle Zeilen enden mit einem vollen CR/LF, was vorzugsweise als "\015\012" geschrieben wird, dies ist Plattformunabhängig. Dennoch sollte ein Klient oder (vor allem) der Server auch auf "\n" Endungen reagieren können. Die MPEG Daten werden über eine separate Datenverbindung übertragen.

Außerdem ist es möglich wie mit SVDRP, bedingt über das VTP Protokoll mittels svdrpsend.pl zu kommunizieren wenn der Port des Streamdev-Servers angegeben wird.

[Bearbeiten] VTP Antwort Codes

215   EPG Eintrag
220   Letztes Kommando ok / Verbindung bereit
221   Service schließt Sende-Kanal
250   Angeforderte Aktion okay, beendet
451   Angeforderte Aktion abgebrochen: lokaler Fehler bei der Bearbeitung
500   Syntax-Fehler, unbekannter Befehl
501   Syntax-Fehler in Parameter oder Argument
550   Angeforderte Aktion nicht ausgeführt
551   Angeforderte Aktion nicht ausgeführt, eine spätere Verbindung war nicht erfolgreich
554   Transaktion fehlgeschlagen
560   Live-Stream derzeit nicht verfügbar
561   Capability not known
562   Pid derzeit nicht verfügbar
563   Stream derzeit nicht verfügbar

Die Antworten sind vom Format:

<Antwort Code><-|Leerzeichen><Text><newline>

Bei der letzten Zeile wird anstelle des - nach dem Antwort Code ein Leerzeichen gesetzt.

[Bearbeiten] Sonstiges

[Bearbeiten] Probleme

[Bearbeiten] Kanal nicht verfügbar/Umschaltproblem

Man kann immer nur den Kanal anschauen, welcher auch gerade auf dem VDR-Server eingestellt ist.
Lösung:
- Im OSD: OSD --> Einstellungen --> Plugins --> streamdev-server: Pausierverhalten "immer pausieren"
- per setup.conf des VDR: streamdev-server.AllowSuspend = 1 streamdev-server.SuspendMode = 1

[Bearbeiten] Umschaltprobleme wegen Primary Limit

Einstellung "Primär-Limit" im Menü "Einstellungen -> Aufnahme" muss auf 0 stehen.
Ist ein höherer Wert eingetragen und eine der DVB-Karten im Server wurde zum "Primary Device" ernannt, dann steht diese Karte Streamdev nicht zur Verfügung.

[Bearbeiten] Sprachdateien werden nicht erkannt (VDR>=1.5.7)

Im Menüs des Plugins ist nur Englisch verfügbar
Abhilfe: vdr-streamdev-gettext.patch

[Bearbeiten] kein TS stream mit pvrinput möglich

Analoge pvrinput Kanäle können im TS Format gestreamt werden, da das streamdev Plugin dafür einen Multiplexer mit Filtersupport im device voraussetzt.
Abhilfe: im pvrinput Plugin stream Format PES wählen.

[Bearbeiten] Tipps

[Bearbeiten] Streamdev-client mit mehreren Verbindungen oder Servern

Von sich aus kann das streamdev-client-Plugin nur genau eine Verbindung zu genau einem festgelegten Server unterhalten. Mit einem einfachen Trick ist es aber möglich, auch mehrere Server zu kontaktieren oder von einem Server gleichzeitig mehrere Transponder zu empfangen. Letzteres ermöglicht es z.B. ein Programm auf dem Client aufzuzeichnen, während ein anderes angeschaut wird. Sogar das osdpip-plugin kann auf dem Client genutzt werden.

Um dies zu erreichen, muss einfach nur eine Kopie des streamdev-client-Plugins unter einem anderen Namen erstellt werden:

cp libvdr-streamdev-client.so.VERSION libvdr-streamdev-client2.so.VERSION

Beim Start des VDR beide Plugins laden

-Pstreamdev-client -Pstreamdev-client2

Im OSD-Menü unter Einstellungen --> Plugins sind nun zwei streamdev-client-Plugins verfügbar die unabhängig voneinander konfiguriert werden können.

[Bearbeiten] Streamen über DSL

Im DSL Router einstellen, dass aus dem Internet Anfragen an Port 3000 (TCP) an den streaming Server weitergeleitet werden,
der verwendete Client sollte die empfangenen Daten buffern: 2,5MByte genügen (je nach Verbindung und Bitrate)
Der Zugriff auf den Stream erfolgt dann über http://<HOST-Adresse>:3000/EXT/<Channel>
Die Datei ist unter VDRCONF/plugins/streamdev-server/externremux.sh abzulegen - ein Beispielskript liegt den Sourcen des Plugins bei.

Beispiele für das Streamen mit unterschiedlichen Einstellungen

http://<HOST-Adresse>:3000/EXT/1 (Kanal 1 mit Standardeinstellungen)
http://<HOST-Adresse>:3000/EXT;QUALITY=WLAN11;VBR=512/1 (Optimiert für WLAN11, jedoch mit Videobitrate 512kBit/s statt der Standardeinstellung für WLAN11)
http://<HOST-Adresse>:3000/EXT;VC=x264/1 (verwende x264 Codec)
http://<HOST-Adresse>:3000/EXT;QUALITY=DSL6000/1 (optimiert für DSL6000)
http://<HOST-Adresse>:3000/EXT;VBR=250;ABR=16;WIDTH=128/1 (manuelle Vorgabe der Video/Audiobitrate und der Breite)

[Bearbeiten] Bugs und Wünsche

http://projects.vdr-developer.org/projects/plg-streamdev/issues

[Bearbeiten] Entwicklerversion

git clone git://projects.vdr-developer.org/vdr-plugin-streamdev.git

[Bearbeiten] Aktuelle Version

0.6.1

[Bearbeiten] Links

Homepage des Plugins

@@ Zeile 1: / Zeile 1: @@
 ==Beschreibung==
-Das Streamdevice Plugin ist die Netzwerkerweiterung des VDR. Es wurde von
+Das Streamdev Plugin erlaubt das Streamen von Live-TV des VDR zu Streaming Clients.
-[http://www.magoa.net/linux/ Sascha Wolkenandt] geschrieben und besteht aus zwei Teilen:
-*Streamdev-server
-*Streamdev-client
-Für das Verständnis des Plugins betrachten wir das Linux-Programm "sort". Es empfängt einen Datenstrom von der Standardeingabe, sortiert ihn und schickt ihn zur Standardausgabe. Die Standardeingabe ist normalerweise am Gerät "Tastatur" und die Ausgabe am Gerät "Monitor" angeschlossen. Effektiver ist es natürlich, die Datenströme umzuleiten und an Dateien anzuschließen:
-sort < unsortiert.txt > sortiert.txt
+Streamdev besteht aus zwei Plugins, streamdev-server und streamdev-client. Damit ist auch VDR als Streaming Client nutzbar.
-Beim VDR kann es mehrere Ein- und Ausgabedatenströme geben. Diese sind normalerweise an den Geräten [[Tuner]] und [[Decoder]] angeschlossen, können aber auch an Plugins umgeleitet werden. Aufnahmen kann man in diesem Zusammenhang wie "eingefrorene" Datenströme auffassen.
+===Status===
+Letztes Update 05/2012
-Das Streamdev Plugin ist nun in der Lage, Ausgabedatenströme entgegenzunehmen, über das Netzwerk an andere Rechner zu versenden und dort als Eingabedatenströme wieder abzuliefern.
+==Bilder==
+[[Bild:streamdev-plugin.jpg|thumb|none|''Einstellungen'']]
-===Streamdev-server===
+==Installation==
-Dieses Plugin stellt für den VDR, welcher das Plugin gestartet hat, ein Ausgabegerät dar. Der VDR kann es wie den Decoderteil einer
+Beim Kompilieren werden zwei Plugins erzeugt, streamdev-client und streamdev-server.
-[[DVB-Karte|Fullfeatured DVB-Karte]] benutzen und MPEG2-Daten von
-Live-TV oder von VDR-Aufnahmen dorthin senden, auch mehrere gleichzeitig. Das Plugin zeigt natürlich die Daten nicht an, sondern packt die Videoströme in ein anderes Streamingformat und versendet sie per Netzwerk an einen anderen Rechner.
-Es wird dann noch ein Eingabegerät für den VDR benötigt.
+===Konfiguration===
+Der Zugriff auf den Server wird durch die [[streamdevhosts.conf]] konfiguriert.
+ cp [[Struktur|$SOURCEDIR]]/VDR/PLUGINS/src/streamdev/streamdevhosts.conf.example [[Struktur|$VDRCONFIG]]/plugins/[[streamdevhosts.conf]]
-===Streamdev-client===
+Die streamdevhosts.conf muss korrekt konfiguriert werden. Andernfalls erlaubt das Server Plugin kein [[Streaming]] zu den Clients!
-Dieses Plugin verhält sich gegenüber VDR, welcher das Plugin gestartet hat, wie ein Eingabegerät. Es empfängt Videoströme per Netzwerk, wandelt das Streamingformat erneut und übergibt die Ströme an VDR. Die Daten werden vom VDR verarbeitet, als kämen sie von einer DVB-Karte.
-Ein Ausgabegerät muss noch bereitgestellt werden, entweder mit einer echten Fullfeatured DVB-Karte oder über ein anderes Plugin ([[Dxr3]]-, [[Softdevice-Plugin|Softdevice]]-, [[Xine-Plugin]]).
+====Konfiguration Client Plugin====
+Danach muss man in der [[channels.conf]] des Clients die Programme hinzufügen, die vom Streaming-Server stammen und in Zukunft von dem 'virtuellen' DVB-Device empfangen werden sollen. Im einfachsten Fall genügt es, auf dem Client eine Kopie der [[channels.conf]] des Servers zu installieren. Empfangen Client und Server unterschiedliche Kanal-Quellen (z.B. Server: DVB-S, Client: DVB-T), so werden die Einträge aus der [[channels.conf]] des Servers einfach in die des Clients eingefügt.
-===Zusammenspiel===
+Es müssen auch nicht alle Kanäle des Server in die [[channels.conf]] des Clients aufgenommen werden.
-*VDR1
-**Eingabedatenströme von
-***DVB-Karte(n)
-**Ausgabedatenströme an
-***Decoder
-***Streamdev-server Plugin (sendet an VDR2 und VDR3)
-*VDR2
-**Eingabedatenströme von
-***DVB-Karte(n)
-***Streamdev-client Plugin (empfängt von VDR1)
-**Ausgabedatenströme an
-***Decoder
-*VDR3
-**Eingabedatenstrom von
-***Streamdev-client Plugin (empfängt von VDR1)
-**Ausgabedatenstrom an
-***Softdevice Plugin
-Dabei kann man die Verbindungen auch mischen. Zwei VDR können sich ihre DVB-Karten gegenseitig zur Verfügung stellen.
+Die Streamdev-Client Einstellungen in VDRs setup.conf:
+ streamdev-client.StreamFilters = 1
+ # streamdev-client.SyncEPG = 0
+ streamdev-client.RemoteIp = 192.168.0.50
+ streamdev-client.RemotePort = 2004
+ streamdev-client.StartClient = 1
-Der Fantasie sind dabei (fast) keine Grenzen gesetzt. Es muss aber gesichert sein, dass mindestens ein Eingabedatenstrom mit dem Gerät "Tuner" und ein Ausgabedatenstrom mit dem Gerät "Decoder" (Fernseher) verbunden ist.
-Soweit die idealisierte Theorie. In der Praxis gibt es da noch einige Schwierigkeiten zu überwinden, da der VDR von sich aus eigentlich nicht netzwerkfähig ist. So haben wir weitere Verbindungen für die Steuerung und das [[OSD]] zu berücksichtigen.
+*Filter Streaming (streamdev-client.StreamFilters):
+**Voraussetzung hierfür ist eine aktuelle streamdev-Version sowohl auf dem Client als auch auf dem Server (Mai 2007). Der Client wird mit allen relevanten Informationen versorgt, die der Server über die DVB-Karte empfängt (EPG, Kanal-Updates, ...).
-==Installation==
+*EPG synchronisieren (streamdev-client.SyncEPG):
-Da es keine externen Abnängigkeiten gibt, gestaltet sich die Installation recht einfach. Es wird installiert, wie jedes andere [[Plugin Installation|Plugin]].
+** Diese Funktion wurde in Version 0.5.0 (2010) aus dem Plugin entfernt. Die folgende Beschreibung erlkärt, warum:
-Eine Besonderheit besteht darin, dass beim Übersetzen gleich zwei Plugins entstehen, der server und der client.
+** Die EPG-Sync Funktion von streamdev und das [[Epgsync-plugin]] machen im großen und ganzen das selbe. Streamdev synchronisiert aber im Vordergrund. Der VDR bleibt komplett blockiert bis der EPG-Sync abgeschlossen ist. Je nachdem wie groß die EPG-Datei auf dem Server ist, kann das dauern. Sofern man trotz Filter Streaming nicht auf eine Synchronisation verzichten kann oder will, empfiehlt sich daher die Verwendung des [[Epgsync-plugin|Epgsync-plugins]].
+*IP-Adresse des Streaming-Servers (streamdev-client.RemoteIp)
+*VTP-Port auf dem Server (streamdev-client.RemotePort)
+*streamdev-client.StartClient (streamdev-client.StartClient)
+==VTP Protokoll ==
+===Einleitung===
+Dieses Protokoll wurde erstellt für Video Übertragungen über das Netzwerk und steht für ''Video Transfer Protocol''. Es ist ein Text basierendes Protokoll wie z.B. FTP, und wird vom Klienten benutzt um mit einem Server zu kommunizieren welcher verschiedene Typen von Videodaten zur Verfügung stellt, wie z.B. Echtzeitübertragungen und Aufnahmen.
+Die Grundkommunikation besteht aus kurzen Text Kommandos welche durch den Klient versendet werden und durch den Server in Form eines Nummerncodes und einer Klartextnachricht beantwortet werden. Alle Zeilen enden mit einem vollen CR/LF, was vorzugsweise als "\015\012" geschrieben wird, dies ist Plattformunabhängig. Dennoch sollte ein Klient oder (vor allem) der Server auch auf "\n" Endungen reagieren können. Die MPEG Daten werden über eine separate Datenverbindung übertragen.
+Außerdem ist es möglich wie mit [[SVDRP]], bedingt über das VTP Protokoll mittels [[svdrpsend.pl]] zu kommunizieren wenn der Port des Streamdev-Servers angegeben wird.
+===VTP Antwort Codes===
+<pre>
+   EPG Eintrag
+   Letztes Kommando ok / Verbindung bereit
+   Service schließt Sende-Kanal
+   Angeforderte Aktion okay, beendet
+   Angeforderte Aktion abgebrochen: lokaler Fehler bei der Bearbeitung
+   Syntax-Fehler, unbekannter Befehl
+   Syntax-Fehler in Parameter oder Argument
+   Angeforderte Aktion nicht ausgeführt
+   Angeforderte Aktion nicht ausgeführt, eine spätere Verbindung war nicht erfolgreich
+   Transaktion fehlgeschlagen
+   Live-Stream derzeit nicht verfügbar
+   Capability not known
+   Pid derzeit nicht verfügbar
+   Stream derzeit nicht verfügbar
+</pre>
+Die Antworten sind vom Format:
+<pre>
+<Antwort Code><-|Leerzeichen><Text><newline>
+</pre>
+Bei der letzten Zeile wird anstelle des - nach dem Antwort Code ein Leerzeichen gesetzt.
+==Sonstiges==
+===Probleme===
+====Kanal nicht verfügbar/Umschaltproblem====
+* Man kann immer nur den Kanal anschauen, welcher auch gerade auf dem VDR-Server eingestellt ist.
+* Lösung:
+** Im OSD:  OSD --> Einstellungen --> Plugins --> streamdev-server: Pausierverhalten "immer pausieren"
+** per [[setup.conf]] des VDR:  streamdev-server.AllowSuspend = 1 streamdev-server.SuspendMode = 1
+====Umschaltprobleme wegen Primary Limit====
+* Einstellung "Primär-Limit" im Menü "Einstellungen -> Aufnahme" muss auf 0 stehen.
+* Ist ein höherer Wert eingetragen und eine der DVB-Karten im Server wurde zum "Primary Device" ernannt, dann steht diese Karte Streamdev nicht zur Verfügung.
+====Sprachdateien werden nicht erkannt (VDR>=1.5.7)====
+* Im Menüs des Plugins ist nur Englisch verfügbar
+* Abhilfe: {{vdrportal attachment|18059|vdr-streamdev-gettext.patch}}
+====kein TS stream mit pvrinput möglich====
+* Analoge pvrinput Kanäle können im TS Format gestreamt werden, da das streamdev Plugin dafür einen Multiplexer mit Filtersupport im device voraussetzt.
+* Abhilfe: im pvrinput Plugin stream Format PES wählen.
+===Tipps===
+====Streamdev-client mit mehreren Verbindungen oder Servern====
+Von sich aus kann das streamdev-client-Plugin nur genau eine Verbindung zu genau einem festgelegten Server unterhalten. Mit einem einfachen Trick ist es aber möglich, auch mehrere Server zu kontaktieren oder von einem Server gleichzeitig mehrere Transponder zu empfangen. Letzteres ermöglicht es z.B. ein Programm auf dem Client aufzuzeichnen, während ein anderes angeschaut wird. Sogar das [[osdpip-plugin]] kann auf dem Client genutzt werden.
+Um dies zu erreichen, muss einfach nur eine Kopie des streamdev-client-Plugins unter einem anderen Namen erstellt werden:
+ cp libvdr-streamdev-client.so.VERSION libvdr-streamdev-client2.so.VERSION
+Beim Start des VDR beide Plugins laden
+ -Pstreamdev-client -Pstreamdev-client2
+Im OSD-Menü unter Einstellungen --> Plugins sind nun zwei streamdev-client-Plugins verfügbar die unabhängig voneinander konfiguriert werden können.
+====Streamen über DSL====
+* Im DSL Router einstellen, dass aus dem Internet Anfragen an Port 3000 (TCP) an den streaming Server weitergeleitet werden,
+* der verwendete Client sollte die empfangenen Daten buffern: 2,5MByte genügen (je nach Verbindung und Bitrate)
+* Der Zugriff auf den Stream erfolgt dann über <nowiki>http://<HOST-Adresse>:3000/EXT/<Channel></nowiki>
+* Die Datei ist unter VDRCONF/plugins/streamdev-server/externremux.sh abzulegen - ein Beispielskript liegt den Sourcen des Plugins bei.
+Beispiele für das Streamen mit unterschiedlichen Einstellungen
+* <nowiki>http://<HOST-Adresse>:3000/EXT/1 (Kanal 1 mit Standardeinstellungen)</nowiki>
+* <nowiki>http://<HOST-Adresse>:3000/EXT;QUALITY=WLAN11;VBR=512/1 (Optimiert für WLAN11, jedoch mit Videobitrate 512kBit/s statt der Standardeinstellung für WLAN11)</nowiki>
+* <nowiki>http://<HOST-Adresse>:3000/EXT;VC=x264/1 (verwende x264 Codec) </nowiki>
+* <nowiki>http://<HOST-Adresse>:3000/EXT;QUALITY=DSL6000/1 (optimiert für DSL6000)</nowiki>
+* <nowiki>http://<HOST-Adresse>:3000/EXT;VBR=250;ABR=16;WIDTH=128/1 (manuelle Vorgabe der Video/Audiobitrate und der Breite)</nowiki>
+===Bugs und Wünsche===
+* http://projects.vdr-developer.org/projects/plg-streamdev/issues
+==Entwicklerversion==
+ git clone git://projects.vdr-developer.org/vdr-plugin-streamdev.git
+==Aktuelle Version==
+[http://projects.vdr-developer.org/attachments/download/1580/vdr-streamdev-0.6.1.tgz 0.6.1]
-==Probleme==
+==Links==
-TODO
+# [http://projects.vdr-developer.org/projects/plg-streamdev Homepage des Plugins]
-Vielen Dank an Sascha für dieses großartige Stück Software.
+[[Kategorie:Plugins]]
+[[Kategorie:Empfänger-Plugins]]
+[[Kategorie:Ausgabe-Plugins]]
+[[Kategorie:Streaming]]
+{{i18n|streamdev-plugin}}

Streamdev-plugin

Aktuelle Version vom 6. Oktober 2016, 10:25 Uhr

Inhaltsverzeichnis

[Bearbeiten] Beschreibung

[Bearbeiten] Status

[Bearbeiten] Bilder