Add another GStreamer link.
[toast/stream2beamer.git] / stream2beamer.md
index 33ed9055a081480c2bbd9fd32291c7ba635bb2de..3ef90a4e354eff352851328aed614a440fef57b9 100644 (file)
@@ -16,6 +16,7 @@ The examples at https://github.com/centricular/gstwebrtc-demos.git work once
 
 has been set (see https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/issues/811)
 
+Another maybe helpful link: https://developer.ridgerun.com/wiki/index.php?title=GstWebRTC_-_H264-Opus_Examples#Receive_Pipeline
 
 # VLC
 Note that you have to close VLC and open it again for new streaming as VLC leaves the connections
@@ -26,7 +27,10 @@ for debugging in that respect).
 ### Source
 The address has to be the address where the video should be streamed **to**. In the following
 examples, a multicast address is used. It is either the IP address of the device receiving the video (unicast address) or a multicast address 
-like 239.255.12.42 (multicast addresses are between 225.0.0.0 and 238.255.255.255).
+like 239.255.12.42 (multicast addresses are between 224.0.0.0 and 239.255.255.255, some of
+them being reserved, 239.0.0.0 to 239.255.255.255 are Organization-Local Scope so they are
+good candidates, see
+https://www.iana.org/assignments/multicast-addresses/multicast-addresses.xhtml).
 
     cvlc -vv --sout '#transcode{vcodec=h264,acodec=mpga,channels=2,vb=800,ab=128}:rtp{mux=ts,dst=239.255.12.42,sdp=sap,name="Geris Game"}' GerisGame.mp4
     cvlc -vv --sout '#transcode{vcodec=h264,acodec=mpga,ab=128,channels=2,samplerate=44100,scodec=none}:rtp{dst=239.255.12.42,port=5004,mux=ts,sap,name=Geris Game}' :no-sout-all :sout-keep GerisGame.mp4
@@ -41,13 +45,42 @@ like 239.255.12.42 (multicast addresses are between 225.0.0.0 and 238.255.255.25
 For VLC, RTSP means RTSP combined with RTP.
 
 ### Source
+We assume that the video source computer has the external IP 192.168.1.54.
+Instead of rtsp://192.168.1.54:8554/ we could also use rtsp://192.168.1.54:8554/mystream.sdp
+
     cvlc -vv --sout '#transcode{vcodec=h264,acodec=mpga,ab=128,channels=2,samplerate=44100,scodec=none}:rtp{sdp=rtsp://:8554/}' :no-sout-all :sout-keep GerisGame.mp4
+    cvlc -vv --sout '#rtp{dst=239.255.12.42,port=1234,sdp=rtsp://192.168.1.54:8554/}' :no-sout-all :sout-keep GerisGame.mp4
+
 
 ### Player
-The address needs to be the address of the souce. Note the backslash at the end.
+The address needs to be the address of the source. Note the backslash at the end.
+
+    vlc rtsp://192.168.1.54:8554/
+
+
+## VLC Remarks
+* Latency: The following options are said to reduce latency:
+
+      --network-caching=150 --clock-jitter=0 --clock-synchro=0
+
+* Duplicating a stream is nice for debugging:
+
+      cvlc -vv --sout '#duplicate{dst=display,dst="transcode{vcodec=h264,acodec=mpga,channels=2,vb=800,ab=128}:rtp{mux=ts,dst=239.255.12.42,sdp=sap,name=Geris Game}"}' GerisGame.mp4
+      cvlc rtp://239.255.12.42
+
+
+## HTTP
+The address at the source side has to be the external one of the local computer.
+
+### Source (server)
+    cvlc -vv --sout '#transcode{vcodec=mp4v,acodec=mpga,vb=800,ab=128}:standard{access=http,mux=ogg,dst=0.0.0.0:8080}' GerisGame.mp4
+
+# Player (client)
+
+    vlc http://192.168.1.54:8080
 
-    cvlc rtsp://192.168.1.54:8554/
 
+# Kodi
+The player built into code knows at least the following streaming protocols: http, rtsp.
 
-# HTTP
-Works as well, the address at the source side has to be the external one of the local computer.
\ No newline at end of file
+https://kodi.wiki/index.php?title=Internet_video_and_audio_streams