Externremux.sh

Aus VDR Wiki
Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

Beschreibung

Der HTTP-Server des streamdev-plugins erlaubt es den Datenstrom eines Senders vor dem Versenden zu manipulieren. Um von dieser Möglichkeit Gebrauch zu machen, muss der Stream über folgende Adresse abgerufen werden:

http://vdr-ip-or-host:3000/Extern/1

Die 3000 steht für den im streamdev-plugin Setup eingestellten Port des HTTP-Servers. Die 1 steht für Kanal 1 gemäß der channels.conf. Die Übergabe von Parametern zur Qualitätssteuerung ist in der URL möglich (bei Verwendung untenstehender externremux.sh (2): http://vdrhost:3000/EXTERN;DSL3500/1

Das streamdev-plugin ruft dann das Skript externremux.sh. Der Datenstrom des gewählten Senders steht dem Skript über Standard-Eingabe (stdin) zur Verfügung. Der manipulierte Datenstrom muss über Standard-Ausgabe (stdout) an das Plugin zurückgegeben werden.

U.a. kann man MPlayer / VLC media player als Client benutzen.

Konfiguration

Das streamdev-plugin muss installiert und der HTTP-Server des Plugins gestartet sein. Über das OSD ist dies unter dem Menüpunkt
Einstellungen
->
Plugins
->
streamdev-server
möglich.


Wenn OSD nicht benutzt wird können die Einstellungen auch in der etc/vdr/setup.conf gemacht werden, dazu folgende Optionen hinzufügen:

streamdev-server.AllowSuspend = 1
streamdev-server.HTTPBindIP = 0.0.0.0
streamdev-server.HTTPServerPort = 3000
streamdev-server.HTTPStreamType = 2
streamdev-server.MaxClients = 5
streamdev-server.ServerPort = 2004
streamdev-server.StartHTTPServer = 1


Die Datei externremux.sh muss angelegt werden und für den VDR-Benutzer sowohl lesbar als auch ausführbar sein.
Um viele Fehler bei der externremux.sh zu umgehen (da untenstehende Beispiele bei der aktuellen vdr-Version (1.7.18), bzw. streamdev-Server (0.5.1) nicht funktionieren), sollte die Beispiel-Config aus /usr/share/doc/vdr-plugin-streamdev-server/examples/externremux.sh.gz kopiert werden, zB: in den vdr-Plugins-Ordner:

gunzip /usr/share/doc/vdr-plugin-streamdev-server/examples/externremux.sh.gz -c > /etc/vdr/plugins/externremux.sh

Falls die externremux.sh nicht kopiert wird kann man die Funktion einfach Testen indem die externremux.sh mit folgendem Inhalt erstellt wird:

#!/bin/sh
cat

Die externremux.sh muss für den vdr-user les- & ausführbar sein:

chown vdruser:vdrgroup externremux.sh
chmod 755 externremux.sh

Auch das Verzeichnis in dem die externremux.sh liegt muss den Zugriff für den VDR-Benutzer zulassen, das Verzeichnis /etc/vdr/plugins/ ist es im normalfall.

Um die externremux.sh nun in den streamdev-server Aufruf einzubinden wird im vdr-Plugins Directory (zB: /etc/vdr/plugins/ ) das File plugin.streamdev-server.conf erstellt und darin die externremux.sh beim Start des streamdev-servers aufgerufen.

echo "-r /etc/vdr/plugins/externremux.sh" > /etc/vdr/plugins/plugin.streamdev-server.conf

oder auch

echo "-r=/etc/vdr/plugins/externremux.sh -a user:password" > /etc/vdr/plugins/plugin.streamdev-server.conf

Hier wird dann bei allen Zugriffen auf einen Channel Username und Password abgefragt die nicht in der streamdevhosts.conf Datei eingetragen sind

Nun muss noch vdr neu gestartet werden, und fertig:

/etc/init.d/vdr restart

Beispiele

In der Praxis kommt häufig das Programm MEncoder (Bestandteil von MPlayer) zum Einsatz. Dazu empfiehlt sich eines der folgenden Beispiele:

externremux.sh (1)

Datei
$PATH/externremux.sh
#!/bin/sh
umask 077
tmpdir=${TMPDIR-/tmp}/externremux-${RANDOM:-$$}
FIFO=$tmpdir/out.avi
OUTLOG=$tmpdir/out.log
mkdir -p $tmpdir || exit 1
mkfifo $FIFO
(cat $FIFO; rm -rf $tmpdir) &
mencoder <OPTIONEN> -o $FIFO -- - &>$OUTLOG


In die Datei out.log kann man bei Problemen rein schauen. Allerdings wird diese Datei beim Beenden von externremux gelöscht. Um dies zu verhindern, bitte die Zeile "OUTLOG=" folgendermaßen ändern:

OUTLOG=/tmp/out.log

externremux.sh (2)

Datei
$PATH/externremux.sh
#!/bin/sh
#
# externremux.sh

# CONFIG START
  TMP=/tmp/externremux-${RANDOM:-$$}
  STREAMQUALITY="DSL6000"
# CONFIG END

mkdir -p $TMP
mkfifo $TMP/out.avi
(trap "rm -rf $TMP" EXIT HUP INT TERM ABRT; cat $TMP/out.avi) &

case ${1:-$STREAMQUALITY} in
     "DSL1000") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=100 \
		-oac mp3lame -lameopts preset=15:mode=3 -vf scale -zoom -xy 160 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
     "DSL2000") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=128 \
		-oac mp3lame -lameopts preset=15:mode=3 -vf scale -zoom -xy 160 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
     "DSL3000") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=250 \
		-oac mp3lame -lameopts preset=15:mode=3 -vf scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
     "DSL3500") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=300 \
                -oac mp3lame -lameopts preset=15:mode=3 -vf scale -zoom -xy 320 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;
     "DSL6000") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=350 \
		-oac mp3lame -lameopts preset=15:mode=3 -vf scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
     "DSL16000") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=500 \
		-oac mp3lame -lameopts preset=15:mode=3 -vf scale -zoom -xy 480 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
       "LAN10") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=4096 \
		-oac mp3lame -lameopts preset=standard \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
      "WLAN11") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=768 \
		-oac mp3lame -lameopts preset=standard -vf scale -zoom -xy 640 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
      "WLAN54") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=2048 \
		-oac mp3lame -lameopts preset=standard \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
	"IPAQ") exec mencoder -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=350 \
		-oac mp3lame -lameopts preset=15:mode=3 -vf scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
	"OGG") exec ffmpeg2theora --format ts \
		--videoquality 0 --videobitrate 300 --width 360 --height 360 --speedlevel 1 \
		--audioquality 0 --audiobitrate 37 --channels 1 --audiostream 0 \
		--title "VDR Live Stream" \
		--output $TMP/out.avi -- - &>$TMP/out.log ;;
        "COPY") exec mencoder -of mpeg -ovc copy -oac copy -mpegopts format=mpeg \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;
	   *) touch $TMP/out.avi ;;
esac


Der Aufruf des Streams erfolgt hierbei für das Beispiel "DSL1000" über folgende Adresse:

http://vdr-ip-or-host:3000/Extern;DSL1000/1

externremux.sh (3)

Datei
$PATH/externremux.sh
#!/bin/sh
#
# externremux.sh

# CONFIG START
  STREAMQUALITY="UMTS" # COPY, UMTS, DSL{1,2,3,6}000, DSL3500, LAN10, WLAN{11,54}, IPAQ
  RECDIR=/video0/
  TMP=/tmp/externremux-${RANDOM:-$$}
# CONFIG END

# DVD abspielen:
# /Extern;STREAMQUALITY:dvd:dvdfile

# Aufzeichnungen abspielen
# /Extern;STREAMQUALITY:rec:dirname to search
# /Extern;STREAMQUALITY:file:filename to search

mkdir -p $TMP
mkfifo $TMP/out.avi
(trap "rm -rf $TMP" EXIT HUP INT TERM ABRT; cat $TMP/out.avi) &

case ${1:0:1} in
     [A-Z]) IFS=: CMD=($1) IFS= ;;
         *) IFS=: CMD=("$STREAMQUALITY" $1) IFS= ;;
esac

case ${CMD[1]} in
     d*) RECORDING="dvd://${CMD[2]}"
         ;;
     r*) REC=$(eval find $RECDIR -name 20*.rec | grep -m 1 -i "${CMD[2]}")
         if [ -d "$REC" ] ; then
             RECORDING="$REC/[0-9][0-9][0-9].vdr"
         fi
         ;;
     f*) REC=$(eval find $RECDIR | grep -m 1 -i "${CMD[2]}")
         if [ -f "$REC" ] ; then
             RECORDING="$REC"
         fi
         ;;
esac

case $CMD in
	H265) exec mencoder $RECORDING -ovc x264  \
		-x264encopts bitrate=200:vbv_maxrate=250:vbv_bufsize=300:ratetol=0.1:threads=3 \
		-oac faac -faacopts br=32 -vf pp=ci,scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;

    H264_150) exec mencoder $RECORDING -ovc x264 -srate 22050 \
		-x264encopts bitrate=150:vbv_maxrate=180:vbv_bufsize=300:ratetol=0.1:threads=3 \
		-oac mp3lame -lameopts cbr:br=16:q=2:mode=3 -vf pp=ci,scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;

 H264_200_15) exec mencoder $RECORDING -ovc x264 -srate 22050 -ofps 15 \
		-x264encopts bitrate=200:vbv_maxrate=250:vbv_bufsize=300:ratetol=0.1:threads=3 \
		-oac mp3lame -lameopts cbr:br=16:q=2:mode=3 -vf pp=ci,scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;

    H264_200) exec mencoder $RECORDING -ovc x264 -srate 22050 \
		-x264encopts bitrate=200:vbv_maxrate=250:vbv_bufsize=300:ratetol=0.1:threads=3 \
		-oac mp3lame -lameopts cbr:br=16:q=2:mode=3 -vf pp=ci,scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;

    H264_250) exec mencoder $RECORDING -ovc x264 -srate 22050 \
		-x264encopts bitrate=250:vbv_maxrate=280:vbv_bufsize=300:ratetol=0.1:threads=3 \
		-oac mp3lame -lameopts cbr:br=16:q=2:mode=3 -vf pp=ci,scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;
		
    H264_400) exec mencoder $RECORDING -ovc x264 -srate 22050 \
		-x264encopts bitrate=400:vbv_maxrate=450:vbv_bufsize=300:ratetol=0.1:threads=3 \
		-oac mp3lame -lameopts cbr:br=16:q=2:mode=3 -vf pp=ci,scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;

    H264_500) exec mencoder $RECORDING -ovc x264 -srate 44100 \
		-x264encopts bitrate=500:vbv_maxrate=550:vbv_bufsize=600:ratetol=0.1:threads=3 \
		-oac mp3lame -lameopts cbr:br=16:q=2:mode=3 -vf pp=ci,scale -zoom -xy 480 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;

    H264_600) exec mencoder $RECORDING -ovc x264 -srate 44100 \
		-x264encopts bitrate=600:vbv_maxrate=650:vbv_bufsize=600:ratetol=0.1:threads=3 \
		-oac mp3lame -lameopts cbr:br=16:q=2:mode=3 -vf pp=ci,scale -zoom -xy 480 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;

    H264_800) exec mencoder $RECORDING -ovc x264 -srate 22050 \
		-x264encopts bitrate=800:vbv_maxrate=850:vbv_bufsize=300:ratetol=0.1:threads=3 \
		-oac mp3lame -lameopts cbr:br=16:q=2:mode=3 -vf pp=ci,scale -zoom -xy 320 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;

        UMTS) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=150 \
                -oac mp3lame -lameopts preset=15:mode=3 -vf scale=320:240 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

       HANDY) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=350 \
                -oac mp3lame -lameopts preset=15:mode=3 -vf scale=320:240 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

     DSL1000) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=100 \
                -oac mp3lame -lameopts preset=15:mode=3 -vf scale=160:104 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

     DSL2000) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=128 \
                -oac mp3lame -lameopts preset=15:mode=3 -vf scale=160:104 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

     DSL3000) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=250 \
                -oac mp3lame -lameopts preset=15:mode=3 -vf scale=320:208 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

     DSL3500) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=300 \
                -oac mp3lame -lameopts preset=15:mode=3 -vf scale=320:208 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

     DSL6000) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=350 \
                -oac mp3lame -lameopts preset=15:mode=3 -vf scale=320:208 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

    DSL16000) exec mencoder $RECORDING [21~-ovc lavc -lavcopts vcodec=mpeg4:vbitrate=500 \
		-oac mp3lame -lameopts preset=15:mode=3 -vf scale -zoom -xy 480 \
		-o $TMP/out.avi -- - &>$TMP/out.log ;;

       LAN10) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=4096 \
                -oac mp3lame -lameopts preset=standard \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

      WLAN11) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=768 \
                -oac mp3lame -lameopts preset=standard -vf scale=640:408 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

      WLAN54) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=2048 \
                -oac mp3lame -lameopts preset=standard \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

        IPAQ) exec mencoder $RECORDING -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=350 \
                -oac mp3lame -lameopts preset=15:mode=3 -vf scale=320:208 \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;

        COPY) exec mencoder $RECORDING -of mpeg -ovc copy -oac copy -mpegopts format=mpeg \
                -o $TMP/out.avi -- - &>$TMP/out.log ;;
           *) touch $TMP/out.avi ;;
esac


Distributions-spezifisch

Je nach Distribution wird die Übergabe, an das Plugin unterschiedlich erfolgen.

Mahlzeit ISO4 beta2

Bei der Mahlzeit ISO4 beta2 (und möglicherweise bei anderen Versionen) ist folgende Datei zu erstellen.

Datei
/etc/vdr/plugin/streamdev-servers/plugin.conf
PARA="--remux=/root/externremux.sh"


Die Streamqualität kann über den Aufruf von selectstreamquality.sh oder über Setzen der STREAMQUALITY-Variablen in /etc/sysconfig eingestellt werden.

Gentoo

Bei gentoo ist es folgende Konfigurations-Datei.

Datei
/etc/conf.d/vdr.streamdev-server
_EXTRAOPTS="--remux=/home/vdr/externremux.sh"


zumindest bei Gen2VDR beta3 muß es PLUGIN_PARAMETERS="--remux=/home/vdr/externremux.sh" heißen


Fuer streamdev 0.5.x

STREAMDEV_REMUX_SCRIPT="/home/vdr/externremux.sh"

Ausserdem muessen alte Skripte so beginnen:

echo -ne 'Content-type: video/mpeg\r\n'
echo -ne '\r\n'

Debian / C't-VDR

Im StartUp-Skript von Debian/ctvdr werden die Plugin-Parameter über eine Datei namens plugin.<pluginname>.conf bestimmt. Diese Datei befindet sich unter /etc/vdr/plugins/. Folglich muß eine Datei in etwa so angelegt werden:

Datei
/etc/vdr/plugins/plugin.streamdev-server.conf
#
# Kommandozeilenparameter für das Streamdev-Plugin
#
# Mit dem Parameter -r oder --remux kann ein externer Remuxer aufgerufen werden.
# Die Streams können dann wie folgt den Remuxer inkludieren:
#    http://vdr-ip-or-host:3000/Extern/1
# Dabei ist IP und Port auf dem Client der Serveradresse anzupassen.
# Die letzte Zahl entspricht dem Kanal wie sie in der channels.conf aufgeführt werden.
#
-r /var/lib/vdr/plugins/streamdev/externremux.sh


Natürlich sollte sich unter /var/lib/vdr/plugins/streamdev/ auch das Skript externremux.sh befinden. Man kann es aus den Beispielen kopieren (/usr/share/doc/vdr-plugin-streamdev-server/examples/externremux.sh) und den Pfad wie oben beschrieben ggf. anpassen.

Ubuntu

Bei Ubuntu muss im externremux.sh #!/bin/sh durch #!/bin/bash ersetzt werden.

Fedora

Bei Fedora werden die Plugin-Parameter für den streamdev-server in der Datei streamdev-server.conf im Ordner /etc/sysconfig/vdr-plugins.d/ festgelegt. Das Skript externremux.sh befindet sich schon mit im Paket vdr-streamdev-server und braucht nur noch angegeben werden. Dabei ist darauf zu achten, dass der Pfad je nach Architektur (lib/lib64) angepasst wird. Das folgende Beispiel ist für 64Bit:

Datei
/etc/sysconfig/vdr-plugins.d/streamdev-server.conf
# Configuration snippet for vdr-streamdev-server                          -*- sh -*-
#
# Add command line options to pass to the streamdev-server plugin to PLUGIN_OPTIONS.

PLUGIN_OPTIONS="--remux=/usr/lib64/vdr/bin/externremux.sh"


Anwendungsbeispiele

Streamen über schmalbandige Verbindungen

Mit Hilfe des streamdev-plugins und MEncoder kann man das laufende Fernsehprogramm auch über schmalbandige Verbindungen (z. B. DSL-Upload) streamen.

Dazu dient folgender MEncoder-Aufruf (im obigen Beispiel ergänzen):

 mencoder -ovc lavc -ffourcc XVID -oac lavc \
  -lavcopts  acodec=mp3:abitrate=32:vcodec=mpeg4:vbitrate=100 \
  -vf scale -zoom -xy 288 -channels 1 -o $FIFO - &>$OUTLOG

Bei Verwendung eines Routers zum Internet muss der Port 3000 auf den VDR-Server weitergeleitet werden. Zum Testen empfiehlt es sich, erst einmal im lokalen Netz die Funktionsfähigkeit zu überprüfen.

Der Clientrechner muss zudem die Erlaubnis haben, auf den Stream zugreifen zu dürfen. Dies wird in der Datei streamdevhosts.conf eingestellt. Die Zeile

0.0.0.0/0

gibt allen Rechnern im Internet die Erlaubnis, den Stream zu sehen. Diese Einstellung ist mit Vorsicht zu benutzen!